GNU bug report logs - #38077
Error on texinfo documentation of variable 'ls-lisp-verbosity'

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 38077 in the body.
You can then email your comments to 38077 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Cecilio Pardo <cpardo <at> imayhem.com>
To: bug-gnu-emacs <at> gnu.org
Subject: Error on texinfo documentation of variable 'ls-lisp-verbosity'
Date: Wed, 06 Nov 2019 00:01:05 +0100

Severity: documentation
Tags: patch

The info documentation fo ls-lisp-verbosity states that the value
contains 'one or more of the symbols', while the docstring says 'none or
more'. The empty list works ok, so it should be 'none'.


diff --git a/doc/emacs/msdos.texi b/doc/emacs/msdos.texi
index 55093a080a..920af2cbf5 100644
--- a/doc/emacs/msdos.texi
+++ b/doc/emacs/msdos.texi
@@ -390,7 +390,7 @@ ls in Lisp
 @vindex ls-lisp-verbosity
   The variable @code{ls-lisp-verbosity} controls the file attributes
 that @file{ls-lisp.el} displays.  The value should be a list that
-contains one or more of the symbols @code{links}, @code{uid}, and
+contains none or more of the symbols @code{links}, @code{uid}, and
 @code{gid}.  @code{links} means display the count of different file
 names that are associated with (a.k.a.@: @dfn{links to}) the file's
 data; this is only useful on NTFS volumes.  @code{uid} means display

-- 
Cecilio Pardo

Message #10 received at 38077-done <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Cecilio Pardo <cpardo <at> imayhem.com>
Cc: 38077-done <at> debbugs.gnu.org
Subject: Re: bug#38077: Error on texinfo documentation of variable
 'ls-lisp-verbosity'
Date: Wed, 06 Nov 2019 19:23:43 +0200

> From: Cecilio Pardo <cpardo <at> imayhem.com>
> Date: Wed, 06 Nov 2019 00:01:05 +0100
> 
> The info documentation fo ls-lisp-verbosity states that the value
> contains 'one or more of the symbols', while the docstring says 'none or
> more'. The empty list works ok, so it should be 'none'.

Thanks.  "None or more" sounds awkward, so I fixed this a bit
differently.

Message #13 received at 38077 <at> debbugs.gnu.org (full text, mbox):

From: Richard Stallman <rms <at> gnu.org>
To: Cecilio Pardo <cpardo <at> imayhem.com>
Cc: 38077 <at> debbugs.gnu.org
Subject: Re: bug#38077: Error on texinfo documentation of variable
 'ls-lisp-verbosity'
Date: Wed, 06 Nov 2019 23:39:43 -0500

[[[ To any NSA and FBI agents reading my email: please consider    ]]]
[[[ whether defending the US Constitution against all enemies,     ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]

"None or more" sounds very strange in English.  It is better to say 
"zero or more".

"A list of zero or more of the following symbols:"

-- 
Dr Richard Stallman
Founder, Free Software Foundation (https://gnu.org, https://fsf.org)
Internet Hall-of-Famer (https://internethalloffame.org)

Message #16 received at 38077 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: rms <at> gnu.org
Cc: cpardo <at> imayhem.com, 38077 <at> debbugs.gnu.org
Subject: Re: bug#38077: Error on texinfo documentation of variable
 'ls-lisp-verbosity'
Date: Thu, 07 Nov 2019 16:29:20 +0200

> From: Richard Stallman <rms <at> gnu.org>
> Date: Wed, 06 Nov 2019 23:39:43 -0500
> Cc: 38077 <at> debbugs.gnu.org
> 
> "None or more" sounds very strange in English.  It is better to say 
> "zero or more".
> 
> "A list of zero or more of the following symbols:"

Yes, but I preferred to say "nil" instead of "list of zero symbols".
This is a user manual, not an ELisp manual, so we shouldn't assume
every reader knows they are equivalent.

Previous Next

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