Hi Alex! At 2020-09-28T11:03:23+0200, Alejandro Colomar wrote: > Normally, text under a section header starts in the next line after > the header, without a blank line. Follow that pattern. I think your terminology could confuse some people. A section heading in a man page is what is typeset by the .SH macro. For instance, ".SH Name", ".SH See also", and so forth[1]. In the below, "aiocb" (in italics) is properly termed a "paragraph tag", hence the mnemonic for the macro right before it: "TP" for "tagged paragraph". Just FYI. [...] > diff --git a/man7/system_data_types.7 b/man7/system_data_types.7 > index 361e8d411..ff0403df9 100644 > --- a/man7/system_data_types.7 > +++ b/man7/system_data_types.7 > @@ -66,7 +66,7 @@ system_data_types \- overview of system data types > .TP > .I aiocb > .RS > -.PP > +.br > Include: > .IR <aio.h> . > .PP > @@ -101,7 +101,7 @@ See also: Regards, Branden [1] Often section headings are written in full capitals in man page source documents, which loses information. The next release of groff will feature support for mixed-case section headings with optional full-caps rendering under user control.
Attachment:
signature.asc
Description: PGP signature
