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

Re: [PATCH] Documentation: update [section.subsection] to reflect what git does

From
Jeff King <peff@peff.net>
Date
Oct 12, 2011, 18:34 UTC
Message-ID
<20111012183451.GB14543@sigill.intra.peff.net>
In-Reply-To
<1318434726-5556-1-git-send-email-cmn@elego.de>
On Wed, Oct 12, 2011 at 05:52:06PM +0200, Carlos Martín Nieto wrote:
Show 7 quoted lines
> -There is also a case insensitive alternative `[section.subsection]` syntax.
> -In this syntax, subsection names follow the same restrictions as for section
> -names.
> +There is also a deprecated `[section.subsection]` syntax. With this
> +syntax, the subsection name is converted to lower-case and is also
> +compared case sensitively. These subsection names follow the same
> +restrictions as section names.

OK, now having looked thoroughly at the problem again, I agree that your documentation update is much better than the one I posted earlier (technically we could still talk about canonicalizing the subsection earlier in git-config(1), but section.foo names are the deprecated minority, so it's probably not worth cluttering the page with explanations).

I do think the "compared case sensitively" bit is a little confusing here, because it's not clear what is being compared here (as we're quite deep into a discussion of the file format, and away from the git-config usage). It might be more clear to say:

  With this syntax, the subsection name is converted to lower-case, and
  the result is compared case sensitively against the subsection name
  provided to git-config.
or something like that.
-Peff
Previous: Junio C Hamano
Message 13 of 13 in “Documentation: update [section.subsection] to reflect what git does”
  1. Documentation: update [section.subsection] to reflect what git doesCarlos Martín Nieto, Oct 12, 2011
  2. Jeff KingOct 12, 2011
  3. Jeff KingOct 12, 2011
  4. Jeff KingOct 12, 2011
  5. 1/2 t1300: put git invocations inside test functionJeff King, Oct 12, 2011
  6. Johannes SixtOct 19, 2011
  7. Junio C HamanoOct 19, 2011
  8. t1300: attempting to remove a non-existent .git/config is not an errorJohannes Sixt, Oct 19, 2011
  9. Jeff KingOct 19, 2011
  10. 2/2 t1300: test mixed-case variable retrievalJeff King, Oct 12, 2011
  11. Junio C HamanoOct 12, 2011
  12. Junio C HamanoOct 12, 2011
  13. Jeff KingOct 12, 2011

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.