[PATCH v2 1/3] system_data_types.7: ffix
G. Branden Robinson
g.branden.robinson@gmail.com
Mon Sep 28 13:06:00 GMT 2020
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.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: not available
URL: <https://sourceware.org/pipermail/libc-alpha/attachments/20200928/9a454fc9/attachment.sig>
More information about the Libc-alpha
mailing list