tcpdump mailing list archives

Re: man page, usage text and filter expression formatting


From: Michael Richardson <mcr () sandelman ca>
Date: Sat, 18 Oct 2025 15:02:28 -0400


Denis Ovsienko <denis () ovsienko info> wrote:
    > One way to solve this problem would be using "keyword <arg>" or
    > "keyword ARG" or even "keyword <ARG>" syntax for all filter primitives.
    > Note that this would not conflict with the use of italics: for example,
    > if you consider GNU tar man page, both the "ARCHIVE", the "OPTIONS" and
    > the "FILE" are in italics (that is, underlined in most cases, unless the
    > session is cleverly configured to use the capabilities of modern
    > terminals):

I'm for:
    keyword <arg>

with <arg> being italic/underline when it can me as the consistent format.
I wonder if any of these conventions have names.
(Like how we have snake_case, and CamelCase)

I'm okay with: "keyword ARG" (like GNU tar), but I think "keyword <ARG>"
(which could also be italic) is too much.

--
]               Never tell me the odds!                 | ipv6 mesh networks [
]   Michael Richardson, Sandelman Software Works        |    IoT architect   [
]     mcr () sandelman ca  http://www.sandelman.ca/        |   ruby on rails    [


_______________________________________________
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

Current thread: