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

From: Tuomas Ahola <taahol@utu.fi>
Date: Oct 3, 2026, 12:55 UTC
Message-ID: <20261003125511.B8Nsu%taahol@utu.fi>
In-Reply-To: <79451beb-15c4-42f3-92fe-1b7fd284b21c@app.fastmail.com>

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

Show 6 quoted lines

> > Something slightly more declarative I managed to hack up:
> >
> 
> This looks great! Will use for v2 and mark you as a coauthor, thank you :D
> (let me know if there's a better way to do that also, still learning the process)
>

Cool!  You can add these before your S-o-b line:

	Co-authored-by: Tuomas Ahola <taahol@utu.fi>
	Signed-off-by: Tuomas Ahola <taahol@utu.fi>

That seems to be the usual formula for marking coauthors (cf. [1] for a random example).

> I wasn't sure what `$.` was before but this makes it clear that it's the current
> line number (and https://perldoc.perl.org/perlvar agrees). Apparently
> `$ARGV` is the name of the current file. (different from @ARGV)

Yes, the Perl syntax is... interesting.

Links:
  1. https://lore.kernel.org/git/20260711160447.99708-3-marcelomlage@usp.br/