Re: [PATCH v2] doc: don't require a SYNOPSIS in section 7

From: Junio C Hamano <gitster@pobox.com>
Date: Oct 6, 2026, 16:07 UTC
Message-ID: <xmqqy0caersw.fsf@gitster.g>
In-Reply-To: <afb72458-bc22-4a7a-87ec-83c77e83aeaf@app.fastmail.com>

"Julia Evans" <julia@jvns.ca> writes:

Show 5 quoted lines

> Or maybe like
>
>    `$line =~ m/\((\d)\)/ or report("first line should look like `somename(1)`");`
>
> or some similar error message

Sure, not being totally silent is better but we also need to make sure that we do not end up using undef when we issue such a warning.

Thanks.

$ 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.