Skip site navigation (1)Skip section navigation (2) 
Date:      Tue, 25 Apr 2023 13:52:24 -0400
From:      Phil Shafer <phil@juniper.net>
To:        Mateusz Piotrowski <0mp@FreeBSD.org>
Cc:        <src-committers@FreeBSD.org>, <dev-commits-src-all@FreeBSD.org>, <dev-commits-src-main@FreeBSD.org>
Subject:   Re: git: 820ac126795b - main - ps: Add libxo to usage message
Message-ID:  <7A5CF76C-701F-4FA1-A598-84C5890157AF@juniper.net>
In-Reply-To: <202304251525.33PFPsgT029785@gitrepo.freebsd.org>
References:  <202304251525.33PFPsgT029785@gitrepo.freebsd.org>
index | next in thread | previous in thread | raw e-mail 

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);
>  }
help

Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?7A5CF76C-701F-4FA1-A598-84C5890157AF>