GNU bug report logs - #15239
24.3.50; doc string of `fringe-styles'

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 15239 in the body.
You can then email your comments to 15239 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: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 24.3.50; doc string of `fringe-styles'
Date: Sun, 1 Sep 2013 13:29:19 -0700 (PDT)

Unless I'm missing something, this doc string seems wrong on several
counts.  And it is important because it is referred to by the doc of
various fringe functions and variables, including `fringe-mode' itself.

1. The doc says that an alist element "has the form (NAME . WIDTH),
   where NAME is a mnemonic fringe mode name (a symbol)".

   Wrong.  NAME is *NOT* a symbol.  Presumably this wants instead to say
   that NAME is a symbol name.  But why it would want to say that here
   is not clear anyway.

2. The doc says that "WIDTH is one of the following:" followed by this:

   "a cons cell (LEFT . RIGHT), where LEFT and RIGHT are respectively
    the left and right fringe widths in pixels, or nil (meaning to
    disable that fringe)."

   Wrong again.  `nil' for LEFT or RIGHT does *NOT* mean to "disable
   that fringe".  It means to "use the default width (8 pixels)", the
   same thing `nil' means as a non-cons value for WIDTH, but in this
   case only for "that fringe".

Again, unless I'm missing something.

In GNU Emacs 24.3.50.1 (i686-pc-mingw32)
 of 2013-08-23 on ODIEONE
Bzr revision: 113986 rgm <at> gnu.org-20130823185841-zoy6h1qk433ibrlf
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --prefix=/c/Devel/emacs/binary --enable-checking=yes,glyphs
 'CFLAGS=-O0 -g3' LDFLAGS=-Lc:/Devel/emacs/lib
 CPPFLAGS=-Ic:/Devel/emacs/include'

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

From: Drew Adams <drew.adams <at> oracle.com>
To: 15239 <at> debbugs.gnu.org
Subject: RE: bug#15239: 24.3.50; doc string of `fringe-styles'
Date: Sun, 1 Sep 2013 13:34:15 -0700 (PDT)

Actually, things are apparently worse than I thought at first:
The doc string of `fringe-mode' seems to have the same problems.

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 15239 <at> debbugs.gnu.org
Subject: Re: bug#15239: 24.3.50; doc string of `fringe-styles'
Date: Fri, 07 Feb 2014 20:40:54 -0800

Drew Adams <drew.adams <at> oracle.com> writes:

> Unless I'm missing something, this doc string seems wrong on several
> counts.  And it is important because it is referred to by the doc of
> various fringe functions and variables, including `fringe-mode' itself.
>
> 1. The doc says that an alist element "has the form (NAME . WIDTH),
>    where NAME is a mnemonic fringe mode name (a symbol)".
>
>    Wrong.  NAME is *NOT* a symbol.  Presumably this wants instead to say
>    that NAME is a symbol name.  But why it would want to say that here
>    is not clear anyway.

Fixed on trunk.

> 2. The doc says that "WIDTH is one of the following:" followed by this:
>
>    "a cons cell (LEFT . RIGHT), where LEFT and RIGHT are respectively
>     the left and right fringe widths in pixels, or nil (meaning to
>     disable that fringe)."
>
>    Wrong again.  `nil' for LEFT or RIGHT does *NOT* mean to "disable
>    that fringe".  It means to "use the default width (8 pixels)", the
>    same thing `nil' means as a non-cons value for WIDTH, but in this
>    case only for "that fringe".

Fixed throughout the file.

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/

Previous Next

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