gc docs: modernize the advice for manually running "gc"
commitb11e8560cc1be17268136504cb80b00fbf4182dc
authorÆvar Arnfjörð Bjarmason <avarab@gmail.com>
Fri, 22 Mar 2019 09:32:32 +0000 (22 10:32 +0100)
committerJunio C Hamano <gitster@pobox.com>
Sun, 24 Mar 2019 12:31:10 +0000 (24 21:31 +0900)
tree4a66f8488d3814d5c8b439d2b3efa0ffe6a51fec
parent041f5ea1cf987a4068ef5f39ba0a09be85952064
gc docs: modernize the advice for manually running "gc"

The docs have been recommending that users need to run this manually,
but that hasn't been needed in practice for a long time except in
exceptional circumstances.

Let's instead have this reflect reality and say that most users don't
need to run this manually at all, while briefly describing the sorts
sort of cases where "gc" does need to be run manually.

Since we're recommending that users run this most of the and usually
don't need to tweak it, let's tone down the very prominent example of
the gc.auto=0 command. It's sufficient to point to the gc.auto
documentation below.

Signed-off-by: Ævar Arnfjörð Bjarmason <avarab@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-gc.txt