On Tue, Jan 05, 2021 at 09:05:48AM -0800, Bill Unruh wrote:
> Of course it being "common" does NOT mean that everyone knows the convention,
> especially people new to Linux. And is NOT an excuse for the man page being
> wrong. So, yes, you should be explicit about it, and not be wrong about it in
> the man page.
There is nothing wrong in the man page.
> It is -o list and --output=list
It is "-o list", "--output list" and "--output=list".
And this is valid for 99% options in all our man pages. Not sure if we
want to explicitly describe it in all the pages ... and it's also libc
specific where the command line parser is implemented.
We recommend "=" only for optional arguments (--foo[=<argument>]), and
on all other paces in the man pages (and in --help outputs) we do not
use "=" at all as it's not required.
So, use "-o list" and "--output list" and forget "=", you do not need it.
That's the message we want to deliver to user by man pages.
Karel
> On Wed, 6 Jan 2021, David O'Brien wrote:
>
> > On 1/5/21 8:27 PM, Karel Zak wrote:
> > > On Thu, Dec 24, 2020 at 11:14:04AM +1000, David O'Brien wrote:
> > > > I don't know if this is expected or not, but it seems very odd:
> > > >
> > > > # lsblk -o=UUID /stratis/labpool/labfs
> > > > lsblk: unknown column: =UUID
> > > >
> > > > [root@serverb ~]# lsblk -o UUID /stratis/labpool/labfs
> > > > UUID
> > > > 0118efb8-66fe-406a-837c-725961bdad4d
> > > >
> > > > [root@serverb ~]# lsblk --output=UUID /stratis/labpool/labfs
> > > > UUID
> > > > 0118efb8-66fe-406a-837c-725961bdad4d
> > > >
> > > >
> > > > From the man(8) page:
> > > > -o, --output list
> > > > Specify which output columns to print. Use --help to get
> > > > a list of all supported columns. The columns may affect
> > > > tree-like output. The default is to use tree for the
> > > > column 'NAME' (see also --tree).
> > > >
> > > > The default list of columns may be extended if list is
> > > > specified in the format +list (e.g., lsblk -o +UUID).
> > > >
> > > > There is no mention of "=" being required, causing failures, etc. I found this quite frustrating.
> > > >
> > >
> > > This is common getopt_long() behavior where equal sign is usable only for
> > > long options (and sometimes for optional arguments).
> > >
> > > lsblk -o UUID
> > > lsblk --output UUID
> > > lsblk --output=UUID
> > >
> > > this is how "=" works in almost all commands and I don't see reason
> > > why we need to be explicit about it for "lsblk -o".
> > >
> > > Karel
> > >
> > ok. If it's common and expected that's fine. I don't spend a lot of time with this class/type of command and it was just
> > new to me and seemed odd.
> >
> > cheers
> > --
> > David
> > Introvert/Unclubbable/Cool
> >
> > Red Hat's core values are freedom, courage, commitment, and accountability.
> >
> >
>
--
Karel Zak <kzak@xxxxxxxxxx>
http://karelzak.blogspot.com
