From: Drew Adams <drew.adams@oracle.com>
To: 15239@debbugs.gnu.org
Subject: bug#15239: 24.3.50; doc string of `fringe-styles'
Date: Sun, 1 Sep 2013 13:29:19 -0700 (PDT) [thread overview]
Message-ID: <64b1e984-a1b7-4ad7-9f1c-261abe9af91c@default> (raw)
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@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'
next reply other threads:[~2013-09-01 20:29 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
2013-09-01 20:29 Drew Adams [this message]
2013-09-01 20:34 ` bug#15239: 24.3.50; doc string of `fringe-styles' Drew Adams
2014-02-08 4:40 ` Lars Ingebrigtsen
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.gnu.org/software/emacs/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=64b1e984-a1b7-4ad7-9f1c-261abe9af91c@default \
--to=drew.adams@oracle.com \
--cc=15239@debbugs.gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).