GNU bug report logs - #47324
Missing information in documentation

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Walter Harms <wharms <at> bfs.de>
Subject: bug#47324: closed (Re: bug#47324: Missing information in
 documentation)
Date: Mon, 22 Mar 2021 22:22:01 +0000

[Message part 1 (text/plain, inline)]

Your bug report

#47324: Missing information in documentation

which was filed against the coreutils package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to 47324 <at> debbugs.gnu.org.

-- 
47324: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=47324
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Bernhard Voelker <mail <at> bernhard-voelker.de>
To: Walter Harms <wharms <at> bfs.de>, 47324-done <at> debbugs.gnu.org
Subject: Re: bug#47324: Missing information in documentation
Date: Mon, 22 Mar 2021 23:21:31 +0100

On 3/22/21 5:37 PM, Walter Harms via GNU coreutils Bug Reports wrote:
> hi list,
> in the documentation (man page) [...]

According to the GNU guidelines and to avoid double work, the man page of
the coreutils is essentially not much more than the output of --help
(and actually gets generated via that).
Instead, the real documentation is available via the Texinfo manual,
which is available in diverse formats.  In a usual installation, it
is reachable via:
  $ info '(coreutils) ls invocation'
Alternative formats include HTML, PDF etc., see:
  https://www.gnu.org/software/coreutils/manual/

> [...] nice feature is mssing
> when a fs is mounted on a directory ls marks that with a dot
> behing the permission mask (see example)
> 
> drwxr-xr-x. 2 1003 users 4096 Mar 22 17:53 vendor
>          ^^
>          notice the dot here
> 
> I found nothing mentioned in the documentation.

It is documented in the section about the '-l' option:

  https://www.gnu.org/software/coreutils/manual/html_node/What-information-is-listed.html

  [...]
  Following the file mode bits is a single character that specifies whether an
  alternate access method such as an access control list applies to the file.
  When the character following the file mode bits is a space, there is no alternate
  access method. When it is a printing character, then there is such a method.

  GNU ls uses a ‘.’ character to indicate a file with a security context, but no
  other alternate access method.

  A file with any other combination of alternate access methods is marked with a ‘+’ character.

Assuming that this section is clear enough, I'm hereby marking this as done
in our bug tracker. Of course, the discussion can continue, and we could even
reopen the issue if needed.

Have a nice day,
Berny

[Message part 3 (message/rfc822, inline)]

From: Walter Harms <wharms <at> bfs.de>
To: "bug-coreutils <at> gnu.org" <bug-coreutils <at> gnu.org>
Subject: Missing information in documentation
Date: Mon, 22 Mar 2021 16:37:58 +0000

hi list,
in the documentation (man page) a nice feature is mssing
when a fs is mounted on a directory ls marks that with a dot
behing the permission mask (see example)

drwxr-xr-x. 2 1003 users 4096 Mar 22 17:53 vendor
                    ^^
           notice the dot here

I found nothing mentioned in the documentation.

hope that helps.

re,
 wh

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.