24.2.50; Typo in "This variable is safe as a file local..."

  • Done
  • quality assurance status badge
Details
2 participants
  • Bastien
  • Drew Adams
Owner
unassigned
Submitted by
Drew Adams
Severity
normal
D
D
Drew Adams wrote on 4 Sep 2012 02:03
(address . bug-gnu-emacs@gnu.org)
4D38E272E92E467894A178429CD1F3A7@us.oracle.com
This help text seems to be missing a word or two or three:
This variable is safe as a file local variable if its value
satisfies the predicate which is byte-compiled expression.
At least, to me, the last line is incomprehensible. Should it perhaps
say "which is _a_ byte-compiled expression"? In that case, why "_the_"
predicate? What predicate?
I really have no idea what this is trying to say about the constraint on
its value, in order for it to be safe.
In GNU Emacs 24.2.50.1 (i386-mingw-nt5.1.2600)
of 2012-09-02 on MARVIN
Bzr revision: 109861 eggert@cs.ucla.edu-20120902171035-7mzihil3xd6bjfiy
Windowing system distributor `Microsoft Corp.', version 5.1.2600
Configured using:
`configure --with-gcc (4.6) --no-opt --enable-checking --cflags
-ID:/devel/emacs/libs/libXpm-3.5.8/include
-ID:/devel/emacs/libs/libXpm-3.5.8/src
-ID:/devel/emacs/libs/libpng-dev_1.4.3-1/include
-ID:/devel/emacs/libs/zlib-dev_1.2.5-2/include
-ID:/devel/emacs/libs/giflib-4.1.4-1/include
-ID:/devel/emacs/libs/jpeg-6b-4/include
-ID:/devel/emacs/libs/tiff-3.8.2-1/include
-ID:/devel/emacs/libs/gnutls-3.0.9/include
-ID:/devel/emacs/libs/libiconv-1.13.1-1-dev/include
-ID:/devel/emacs/libs/libxml2-2.7.8/include/libxml2'
D
D
Drew Adams wrote on 4 Sep 2012 02:08
RE: bug#12344: 24.2.50; Typo in "This variable is safe as a file local..."
(address . 12344@debbugs.gnu.org)
2A34255B095F4B4D833DB9DE3EC436A5@us.oracle.com
Toggle quote (5 lines)
> This help text seems to be missing a word or two or three:
>
> This variable is safe as a file local variable if its value
> satisfies the predicate which is byte-compiled expression.

I see now that this text is only for `C-h v byte-compile-warnings', and that the
last part of the printed text varies, depending on the particular variable.

Please fix this for at least variable `byte-compile-warnings'. Clearly, the
general pattern/algorithm used to come up with the text for any given variable
is flawed. Or else the data it is using to come up with the text is flawed in
the case of `byte-compile-warnings'.
B
B
Bastien wrote on 11 Sep 2012 15:44
Re: bug#12344: 24.2.50; Typo in "This variable is safe as a file local..."
(name . Drew Adams)(address . drew.adams@oracle.com)(address . 12344-done@debbugs.gnu.org)
87r4q8r7vy.fsf@altern.org
"Drew Adams" <drew.adams@oracle.com> writes:

Toggle quote (8 lines)
> This help text seems to be missing a word or two or three:
>
> This variable is safe as a file local variable if its value
> satisfies the predicate which is byte-compiled expression.
>
> At least, to me, the last line is incomprehensible. Should it perhaps
> say "which is _a_ byte-compiled expression"?

I assumed so and fixed this.

I close this bug.

Thanks,

--
Bastien
Closed
?