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

Re: What's cooking in git.git (Aug 2025, #05; Mon, 11)

From
Jean-Noël AVILA <jn.avila@free.fr>
Date
Aug 12, 2025, 15:24 UTC
Message-ID
<5032416.31r3eYUQgx@cayenne>
In-Reply-To
<xmqqwm79x7ra.fsf@gitster.g>
On Tuesday, 12 August 2025 10:29:45 CEST Junio C Hamano wrote:
Show 29 quoted lines
> Here are the topics that have been cooking in my tree.  Commits
> prefixed with '+' are in 'next' (being in 'next' is a sign that a
> topic is stable enough to be used and are candidate to be in a
> future release).  Commits prefixed with '-' are only in 'seen', and
> aren't considered "accepted" at all and may be annotated with an URL
> to a message that raises issues but they are no means exhaustive.  A
> topic without enough support may be discarded after a long period of
> no activity (of course they can be resubmit when new interests
> arise).
> 
> Copies of the source code to Git live in many repositories, and the
> following is a list of the ones I push into or their mirrors.  Some
> repositories have only a subset of branches.
> 
> * ja/doc-lint-sections-and-synopsis (2025-08-11) 6 commits
>  - doc lint: check that synopsis manpages have synopsis inlines
>  - doc:git-for-each-ref: fix styling and typos
>  - doc: check for absence of the form --[no-]parameter
>  - doc: check for absence of multiple terms in each entry of desc list
>  - doc: check well-formedness of delimited sections
>  - doc: test linkgit macros for well-formedness
> 
>  Doc lint updates to encourage the newer and easier-to-use
>  `synopsis` format, with fixes to a handful of existing uses.
> 
>  Will merge to 'next'?
>  source: <pull.1945.v3.git.1754945600.gitgitgadget@gmail.com>
> 
> 

These patches are designed to not raise false positives, trading it for letting true positives pass through. For instance, the "synopsis" patch cannot catch keywords which are just one word.

 If possible, I'd like to see how they behave against upcoming documentation 
changes described in this "cooking". This is in order to not have to revert 
them at some point.
Jean-Noël
Previous: Junio C HamanoNext: Junio C Hamano
Message 9 of 10 in “What's cooking in git.git (Aug 2025, #05; Mon, 11)”
  1. Junio C HamanoAug 12, 2025
  2. Patrick SteinhardtAug 12, 2025
  3. Taylor BlauAug 12, 2025
  4. Patrick SteinhardtAug 13, 2025
  5. Taylor BlauAug 13, 2025
  6. Junio C HamanoAug 13, 2025
  7. Patrick SteinhardtAug 15, 2025
  8. Junio C HamanoAug 12, 2025
  9. Jean-Noël AVILAAug 12, 2025
  10. Junio C HamanoAug 12, 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.