From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.org!not-for-mail
From: Lars Ingebrigtsen <larsi@gnus.org>
Newsgroups: gmane.emacs.bugs
Subject: bug#15239: 24.3.50; doc string of `fringe-styles'
Date: Fri, 07 Feb 2014 20:40:54 -0800
Message-ID: <87y51m43op.fsf@building.gnus.org>
References: <64b1e984-a1b7-4ad7-9f1c-261abe9af91c@default>
NNTP-Posting-Host: plane.gmane.org
Mime-Version: 1.0
Content-Type: text/plain
X-Trace: ger.gmane.org 1391834590 2464 80.91.229.3 (8 Feb 2014 04:43:10 GMT)
X-Complaints-To: usenet@ger.gmane.org
NNTP-Posting-Date: Sat, 8 Feb 2014 04:43:10 +0000 (UTC)
Cc: 15239@debbugs.gnu.org
To: Drew Adams <drew.adams@oracle.com>
Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Feb 08 05:43:18 2014
Return-path: <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>
Envelope-to: geb-bug-gnu-emacs@m.gmane.org
Original-Received: from lists.gnu.org ([208.118.235.17])
	by plane.gmane.org with esmtp (Exim 4.69)
	(envelope-from <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>)
	id 1WBzl6-0005oL-8E
	for geb-bug-gnu-emacs@m.gmane.org; Sat, 08 Feb 2014 05:43:16 +0100
Original-Received: from localhost ([::1]:44907 helo=lists.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>)
	id 1WBzl5-00079K-UD
	for geb-bug-gnu-emacs@m.gmane.org; Fri, 07 Feb 2014 23:43:15 -0500
Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:58855)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1WBzkx-00077D-Hf
	for bug-gnu-emacs@gnu.org; Fri, 07 Feb 2014 23:43:12 -0500
Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1WBzks-00038y-I4
	for bug-gnu-emacs@gnu.org; Fri, 07 Feb 2014 23:43:07 -0500
Original-Received: from debbugs.gnu.org ([140.186.70.43]:41945)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1WBzks-00038t-Eo
	for bug-gnu-emacs@gnu.org; Fri, 07 Feb 2014 23:43:02 -0500
Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1WBzkr-0005e1-Ul
	for bug-gnu-emacs@gnu.org; Fri, 07 Feb 2014 23:43:02 -0500
X-Loop: help-debbugs@gnu.org
Resent-From: Lars Ingebrigtsen <larsi@gnus.org>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces@debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@gnu.org
Resent-Date: Sat, 08 Feb 2014 04:43:01 +0000
Resent-Message-ID: <handler.15239.B15239.139183454321639@debbugs.gnu.org>
Resent-Sender: help-debbugs@gnu.org
X-GNU-PR-Message: followup 15239
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: 
Original-Received: via spool by 15239-submit@debbugs.gnu.org id=B15239.139183454321639
	(code B ref 15239); Sat, 08 Feb 2014 04:43:01 +0000
Original-Received: (at 15239) by debbugs.gnu.org; 8 Feb 2014 04:42:23 +0000
Original-Received: from localhost ([127.0.0.1]:55962 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.80)
	(envelope-from <debbugs-submit-bounces@debbugs.gnu.org>)
	id 1WBzkF-0005cq-1X
	for submit@debbugs.gnu.org; Fri, 07 Feb 2014 23:42:23 -0500
Original-Received: from hermes.netfonds.no ([80.91.224.195]:56190)
	by debbugs.gnu.org with esmtp (Exim 4.80)
	(envelope-from <larsi@gnus.org>) id 1WBzkD-0005ci-QP
	for 15239@debbugs.gnu.org; Fri, 07 Feb 2014 23:42:22 -0500
Original-Received: from [204.14.154.233] (helo=building.gnus.org)
	by hermes.netfonds.no with esmtpsa (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.72) (envelope-from <larsi@gnus.org>)
	id 1WBzjv-00058E-3W; Sat, 08 Feb 2014 05:42:03 +0100
In-Reply-To: <64b1e984-a1b7-4ad7-9f1c-261abe9af91c@default> (Drew Adams's
	message of "Sun, 1 Sep 2013 13:29:19 -0700 (PDT)")
User-Agent: Gnus/5.13001 (Ma Gnus v0.10) Emacs/24.3.50 (gnu/linux)
X-MailScanner-ID: 1WBzjv-00058E-3W
MailScanner-NULL-Check: 1392439323.92397@cbJltRtDLpdJNJ2vwhSO+A
X-BeenThere: debbugs-submit@debbugs.gnu.org
X-Mailman-Version: 2.1.15
Precedence: list
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x
X-Received-From: 140.186.70.43
X-BeenThere: bug-gnu-emacs@gnu.org
List-Id: "Bug reports for GNU Emacs,
	the Swiss army knife of text editors" <bug-gnu-emacs.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/bug-gnu-emacs>,
	<mailto:bug-gnu-emacs-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/bug-gnu-emacs>
List-Post: <mailto:bug-gnu-emacs@gnu.org>
List-Help: <mailto:bug-gnu-emacs-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/bug-gnu-emacs>,
	<mailto:bug-gnu-emacs-request@gnu.org?subject=subscribe>
Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org
Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org
Xref: news.gmane.org gmane.emacs.bugs:84879
Archived-At: <http://permalink.gmane.org/gmane.emacs.bugs/84879>

Drew Adams <drew.adams@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/