Re: man page, usage text and filter expression formatting

[Denis Ovsienko <denis () ovsienko info>]

On Mon, 20 Oct 2025 11:43:27 -0400
enh via tcpdump-workers <tcpdump-workers () lists tcpdump org> wrote:

> https://pubs.opengroup.org/onlinepubs/9799919799.2024edition/basedefs/V1_chap12.html#tag_12_01
> is the canonical source for how to write your command synopses in a
> man page...

Thank you for finding the reference.  Section 12.4.1 seems to mean that
angle brackets combined with italic font would be an acceptable style,
even though POSIX-1003.1-2024 itself uses this style only a few times,
and not for command-line arguments.  In any case, it would be one of the
well-known conventions.

I wonder if there is a software project that has already identified the
best possible solution to this exact problem.

-- 
    Denis Ovsienko
_______________________________________________
tcpdump-workers mailing list -- tcpdump-workers () lists tcpdump org
To unsubscribe send an email to tcpdump-workers-leave () lists tcpdump org
%(web_page_url)slistinfo%(cgiext)s/%(_internal_name)s