[PATCH v4 3/4] proc_pid_fdinfo.5: Add subsection headers for different fd types
G. Branden Robinson
g.branden.robinson at gmail.com
Sat Nov 2 09:20:07 UTC 2024
Hi Ian,
At 2024-11-01T14:18:29-0700, Ian Rogers wrote:
> Make the sections about eventfd, epoll, signalfd, inotify, fanotify,
> timerfd better separated with a clearer subsection header.
>
> Signed-off-by: Ian Rogers <irogers at google.com>
[...]
> +.SS eventfd
> .P
[...]
> +.SS epoll
> .P
[...]
> +.SS signalfd
> .P
[...]
> +.SS inotify
> .P
[etc.]
I suggest deleting the paragraphing macros when you add (sub)sectioning
macros immediately before them. In these cases the `P` calls end up
doing nothing.
groff_man(7):
.SS [subheading‐text]
Set subheading‐text as a subsection heading indented
between a section heading and an ordinary paragraph (.P).
If no argument is given, a one‐line input trap is planted;
text on the next line becomes subheading‐text. The left
margin is reset to the value of the SN register to set the
heading text in bold (or the font specified by the string
HF). If the heading font \*[HF] is bold, use of an italic
style in subheading‐text is mapped to the bold‐italic
style if available in the font family. The inset level is
reset to 1, setting the left margin to the value of the IN
register. Text after subheading‐text is set as an
ordinary paragraph (.P).
Regards,
Branden
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: not available
URL: <https://lists.freedesktop.org/archives/dri-devel/attachments/20241102/d6018049/attachment-0001.sig>
More information about the dri-devel
mailing list