Re: [PATCH v2 1/3] system_data_types.7: ffix

G. Branden Robinson
2020-09-28T13:06:06Z

[-- Attachment #1: Type: text/plain, Size: 1158 bytes --]

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 #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]