Re: [PATCH v3] Documentation/config.txt: Order variables alphabetically

[Jonathan Nieder <jrnieder@gmail.com>]

Hi,

jari.aalto@cante.net wrote:

> From: Jari Aalto <jari.aalto@cante.net>

Could you or some other interested person give a diff of just the
lines with ::, as well as confirming that the other lines did not
change, only shuffled around?  It would be nice to get a sense of the
net effect of the change.

Regardless of the answer, it needs justification _in the log message_.
Putting this in alphabetical order may make it easier for people to
decide where to add their future config variables, but they will
wonder why that order, and whether it is worth changing again.

FWIW the "my man pager is broken" justification doesn't seem so strong
to me.  The "my hardcopy of the manual doesn't have an easy search
function" seems more compelling, except that there is work in progress
to fix that by splitting documentation of config vars by affected
command and making gitconfig(5) proper into an index.

Hope that helps,
Jonathan