git/list[1] front-page[2] threads[3] people[4] search[5] about
 

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

From
Jonathan Nieder <jrnieder@gmail.com>
Date
Dec 1, 2010, 16:13 UTC
Message-ID
<20101201161311.GC26120@burratino>
In-Reply-To
<31def5a4a6256e6fdef8a03372cda98460f61c47.1291217124.git.jari.aalto@cante.net>
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

Previous: jari.aalto@cante.netNext: Erik Faye-Lund
Message 5 of 6 in “GIT connect "connect to host HOSTNAME port 22: Bad file number" message shown”
  1. GAURAV BAHLDec 1, 2010
  2. Erik Faye-LundDec 1, 2010
  3. Documentation/config.txt: Order variables alphabeticallyJari Aalto, Dec 1, 2010
  4. Documentation/config.txt: Order variables alphabeticallyjari.aalto@cante.net, Dec 1, 2010
  5. Jonathan NiederDec 1, 2010
  6. Erik Faye-LundDec 1, 2010

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.