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

Re: [GSoC PATCH 1/2] userdiff: add builtin driver for gitconfig syntax

From
D. Ben Knoble <ben.knoble@gmail.com>
Date
Mar 21, 2025, 02:11 UTC
Message-ID
<CALnO6CACKrP=GZ-zB=4EWMjPv1RcvqgQuE5rzQM+V8C3PU3VZg@mail.gmail.com>
In-Reply-To
<Z9vT-dqBzXxzXnlU@pks.im>
On Thu, Mar 20, 2025 at 4:41 AM Patrick Steinhardt <ps@pks.im> wrote:
Show 27 quoted lines
>
> On Wed, Mar 19, 2025 at 02:20:15PM -0300, Lucas Seiki Oshiro wrote:
> > From Documentation/config.adoc:
> >
> > """
> > The file consists of sections and variables. A section begins with
> > the name of the section in square brackets and continues until the next
> > section begins. Section names are case-insensitive. Only alphanumeric
> > characters, `-` and `.` are allowed in section names. Each variable
> > must belong to some section, which means that there must be a section
> > header before the first setting of a variable.
> >
> > [...]
> >
> > Subsection names are case sensitive and can contain any characters except
> > newline and the null byte.
> >
> > The variable names are case-insensitive, allow only alphanumeric characters
> > and `-`, and must start with an alphabetic character.
> > """
>
> I don't think it's necessary to quote this whole paragraph here, as most
> of us should be quite familiar with its format. I'd rather summarize the
> info a bit and explain how we can use the userdiff patterns for the
> general structure of the config. And in case there are any subtleties in
> the format it may make sense to specifically point out those instead of
> quoting the whole manual.

And, if we really felt it important to direct readers to the full text, we could instruct them to do something like `git show <sensible-hash>:Documentation/config.adoc`—in other words, the text is a part of this commit (and its parent) even if we don't (fully) quote it here.

Cheers, Ben

Previous: Patrick SteinhardtNext: Lucas Seiki Oshiro
Message 4 of 7 in “add userdiff driver for gitconfig”
  1. 0/2 add userdiff driver for gitconfigLucas Seiki Oshiro, Mar 19, 2025
  2. 1/2 userdiff: add builtin driver for gitconfig syntaxLucas Seiki Oshiro, Mar 19, 2025
  3. Patrick SteinhardtMar 20, 2025
  4. D. Ben KnobleMar 21, 2025
  5. 2/2 t4018: add tests for gitconfig in userdiffLucas Seiki Oshiro, Mar 19, 2025
  6. Patrick SteinhardtMar 20, 2025
  7. Lucas Seiki OshiroMar 23, 2025

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.