Nguyen Thai Ngoc Duy <pclo...@gmail.com> writes:
> On Wed, Oct 3, 2012 at 3:46 PM, Ramkumar Ramachandra <artag...@gmail.com>
>> On second thought, it might not be such a good idea. There are *lots*
>> of variables that control the operation of each command, and it's hard
>> to decide which ones to list and which ones to omit. I've listed all
>> the relevant variables for git-push, except the advice.* variables- I
>> don't know how useful such a long list might be.
> I think listing receive.* and advice.* (and maybe even
> remove.<name>.*) is still ok. The goal is to give users a clue.
> They'll need to look up in config.txt anyway for explanation. If we
> name the config keys (and groups) well then users should be able to
> guess what those keys may be for before deciding whether to look into
Please do not label the list as "These variables affect this
command" to give a false impression that it is the complete list if
Unless somebody promises to keep an up-to-date complete list there
(or even better, come up with a mechanism to help us keep that
promise automatically, perhaps by annotating pieces with structured
comments in config.txt and automatically appending such a section to
manual pages of relevant commands), that is.
With a weaker phrase, e.g. "These configuration variables may be of
interest", such a list may not hurt readers, but personally I do not
think it adds much value to have a list of variables without even a
single line description of what each is used for.
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majord...@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html