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

Re: how exactly can git config section names contain periods?

From
Jeff King <peff@peff.net>
Date
Jun 2, 2018, 00:02 UTC
Message-ID
<20180602000252.GA25016@sigill.intra.peff.net>
In-Reply-To
<xmqq36y685vx.fsf@gitster-ct.c.googlers.com>
On Sat, Jun 02, 2018 at 08:05:22AM +0900, Junio C Hamano wrote:
Show 17 quoted lines
> > This has been deprecated since 2011. Maybe it's time to finally get rid
> > of it.
> 
> Sure, but is it worth the transition noise?
> 
> The way we lightly utter the word "deprecated" around here probably
> does not align well with the way how end-users perceive the word.
> Just marking something deprecated in a corner of the documentation
> set, without actively making an effort to wean the existing users
> off, while happily accepting the existing "deprecated" practice, is
> what we've done.
> 
> In those repositories people have with "[foo.bar] key" syntax that
> were created before or after 2011, we first should start issuing a
> "that syntax will no longer be valid---I'll update it for you if you
> want (y/n)?" warning and keep it for a release or three before
> finally removing the "feature".

Yeah, sorry to be unclear: I meant that we should actually start moving forward on the removal, and I agree that the first step is issuing a warning.

It may not be worth the transition noise. For the most part historical oddities like these aren't hurting anybody. On the other hand, people read the documentation and go "huh?". These kinds of vestigial options and special cases can add up to clutter the explanations. So I dunno.

-Peff
Previous: Junio C HamanoNext: Robert P. J. Day
Message 6 of 13 in “how exactly can git config section names contain periods?”
  1. Robert P. J. DayJun 1, 2018
  2. Randall S. BeckerJun 1, 2018
  3. Jeff KingJun 1, 2018
  4. Robert P. J. DayJun 1, 2018
  5. Junio C HamanoJun 1, 2018
  6. Jeff KingJun 2, 2018
  7. Robert P. J. DayJun 2, 2018
  8. Jeff KingJun 2, 2018
  9. Robert P. J. DayJun 3, 2018
  10. SZEDER GáborJun 3, 2018
  11. Robert P. J. DayJun 3, 2018
  12. Jeff KingJun 4, 2018
  13. Johannes SixtJun 3, 2018

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.