From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.org!not-for-mail
From: Drew Adams <drew.adams@oracle.com>
Newsgroups: gmane.emacs.bugs
Subject: bug#15239: 24.3.50; doc string of `fringe-styles'
Date: Sun, 1 Sep 2013 13:29:19 -0700 (PDT)
Message-ID: <64b1e984-a1b7-4ad7-9f1c-261abe9af91c@default>
NNTP-Posting-Host: plane.gmane.org
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: quoted-printable
X-Trace: ger.gmane.org 1378067438 4074 80.91.229.3 (1 Sep 2013 20:30:38 GMT)
X-Complaints-To: usenet@ger.gmane.org
NNTP-Posting-Date: Sun, 1 Sep 2013 20:30:38 +0000 (UTC)
To: 15239@debbugs.gnu.org
Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Sep 01 22:30:39 2013
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 1VGEIA-0000F6-4h
	for geb-bug-gnu-emacs@m.gmane.org; Sun, 01 Sep 2013 22:30:38 +0200
Original-Received: from localhost ([::1]:35567 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 1VGEI9-0003kR-Cj
	for geb-bug-gnu-emacs@m.gmane.org; Sun, 01 Sep 2013 16:30:37 -0400
Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:38577)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1VGEHq-0003jQ-09
	for bug-gnu-emacs@gnu.org; Sun, 01 Sep 2013 16:30:28 -0400
Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1VGEHf-0006e7-Oq
	for bug-gnu-emacs@gnu.org; Sun, 01 Sep 2013 16:30:17 -0400
Original-Received: from debbugs.gnu.org ([140.186.70.43]:55453)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1VGEHf-0006e1-L3
	for bug-gnu-emacs@gnu.org; Sun, 01 Sep 2013 16:30:07 -0400
Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1VGEHc-0004j3-SE
	for bug-gnu-emacs@gnu.org; Sun, 01 Sep 2013 16:30:05 -0400
X-Loop: help-debbugs@gnu.org
Resent-From: Drew Adams <drew.adams@oracle.com>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces@debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@gnu.org
Resent-Date: Sun, 01 Sep 2013 20:30:03 +0000
Resent-Message-ID: <handler.15239.B.137806740018123@debbugs.gnu.org>
Resent-Sender: help-debbugs@gnu.org
X-GNU-PR-Message: report 15239
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: 
X-Debbugs-Original-To: bug-gnu-emacs@gnu.org
Original-Received: via spool by submit@debbugs.gnu.org id=B.137806740018123
	(code B ref -1); Sun, 01 Sep 2013 20:30:03 +0000
Original-Received: (at submit) by debbugs.gnu.org; 1 Sep 2013 20:30:00 +0000
Original-Received: from localhost ([127.0.0.1]:35513 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.80)
	(envelope-from <debbugs-submit-bounces@debbugs.gnu.org>)
	id 1VGEHY-0004iE-08
	for submit@debbugs.gnu.org; Sun, 01 Sep 2013 16:30:00 -0400
Original-Received: from eggs.gnu.org ([208.118.235.92]:36819)
	by debbugs.gnu.org with esmtp (Exim 4.80)
	(envelope-from <drew.adams@oracle.com>) id 1VGEHV-0004i0-0r
	for submit@debbugs.gnu.org; Sun, 01 Sep 2013 16:29:57 -0400
Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <drew.adams@oracle.com>) id 1VGEHF-0006JE-Pg
	for submit@debbugs.gnu.org; Sun, 01 Sep 2013 16:29:51 -0400
Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:42739)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <drew.adams@oracle.com>) id 1VGEHF-0006J8-MY
	for submit@debbugs.gnu.org; Sun, 01 Sep 2013 16:29:41 -0400
Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:38520)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <drew.adams@oracle.com>) id 1VGEH7-0003dr-3R
	for bug-gnu-emacs@gnu.org; Sun, 01 Sep 2013 16:29:41 -0400
Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <drew.adams@oracle.com>) id 1VGEGy-0006EW-HQ
	for bug-gnu-emacs@gnu.org; Sun, 01 Sep 2013 16:29:33 -0400
Original-Received: from userp1040.oracle.com ([156.151.31.81]:18023)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <drew.adams@oracle.com>) id 1VGEGy-0006ER-9v
	for bug-gnu-emacs@gnu.org; Sun, 01 Sep 2013 16:29:24 -0400
Original-Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94])
	by userp1040.oracle.com (Sentrion-MTA-4.3.1/Sentrion-MTA-4.3.1) with
	ESMTP id r81KTM8m006985
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK)
	for <bug-gnu-emacs@gnu.org>; Sun, 1 Sep 2013 20:29:23 GMT
Original-Received: from userz7021.oracle.com (userz7021.oracle.com [156.151.31.85])
	by ucsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id
	r81KTLhn020013
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO)
	for <bug-gnu-emacs@gnu.org>; Sun, 1 Sep 2013 20:29:22 GMT
Original-Received: from abhmt105.oracle.com (abhmt105.oracle.com [141.146.116.57])
	by userz7021.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id
	r81KTLLb016148
	for <bug-gnu-emacs@gnu.org>; Sun, 1 Sep 2013 20:29:21 GMT
X-Priority: 3
X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8  (707110) [OL
	12.0.6680.5000 (x86)]
X-Source-IP: ucsinet22.oracle.com [156.151.31.94]
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic]
X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address
	(bad octet value).
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:77870
Archived-At: <http://permalink.gmane.org/gmane.emacs.bugs/77870>

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=3D/c/Devel/emacs/binary --enable-checking=3Dyes,glyphs
 'CFLAGS=3D-O0 -g3' LDFLAGS=3D-Lc:/Devel/emacs/lib
 CPPFLAGS=3D-Ic:/Devel/emacs/include'