Re: git: 820ac126795b - main - ps: Add libxo to usage message

From: Phil Shafer <phil_at_juniper.net>
Date: Tue, 25 Apr 2023 17:52:24 UTC
What's the best way to indicate this in a man page, given the variety of argument styles that libxo supports?

    https://libxo.readthedocs.io/en/latest/options.html

Perhaps just a "...", like:

           "       ps [--libxo...] -L");

Or maybe just a trailing line like "ps supports libxo; see xo_options(7) for details"?

Thanks,
 Phil



On 25 Apr 2023, at 11:25, Mateusz Piotrowski wrote:

> [External Email. Be cautious of content]
>
>
> The branch main has been updated by 0mp:
>
> URL: https://urldefense.com/v3/__https://cgit.FreeBSD.org/src/commit/?id=820ac126795b8b1c55009676fad3dfe5c7834b0b__;!!NEt6yMaO-gk!BWezOKAibnWbTFCIF79DxR6aqZuqzE_lTO7PFGn4JOuinX8qlSYURqEJGZ_LKVAWxLVaKztuug$
>
> commit 820ac126795b8b1c55009676fad3dfe5c7834b0b
> Author:     Mateusz Piotrowski <0mp@FreeBSD.org>
> AuthorDate: 2023-04-25 11:55:17 +0000
> Commit:     Mateusz Piotrowski <0mp@FreeBSD.org>
> CommitDate: 2023-04-25 15:23:07 +0000
>
>     ps: Add libxo to usage message
>
>     MFC after:      1 week
>     Sponsored by:   Klara Inc.
> ---
>  bin/ps/ps.c | 6 +++---
>  1 file changed, 3 insertions(+), 3 deletions(-)
>
> diff --git a/bin/ps/ps.c b/bin/ps/ps.c
> index dd1335bb4eeb..6f0cc76cd0b7 100644
> --- a/bin/ps/ps.c
> +++ b/bin/ps/ps.c
> @@ -1459,9 +1459,9 @@ usage(void)
>  #define        SINGLE_OPTS     "[-aCcde" OPT_LAZY_f "HhjlmrSTuvwXxZ]"
>
>         (void)xo_error("%s\n%s\n%s\n%s\n",
> -           "usage: ps " SINGLE_OPTS " [-O fmt | -o fmt] [-G gid[,gid...]]",
> -           "          [-J jid[,jid...]] [-M core] [-N system]",
> +           "usage: ps [--libxo] " SINGLE_OPTS " [-O fmt | -o fmt]",
> +           "          [-G gid[,gid...]] [-J jid[,jid...]] [-M core] [-N system]",
>             "          [-p pid[,pid...]] [-t tty[,tty...]] [-U user[,user...]]",
> -           "       ps -L");
> +           "       ps [--libxo] -L");
>         exit(1);
>  }