From unknown Sun Jun 22 09:58:59 2025 X-Loop: help-debbugs@gnu.org Subject: bug#15239: 24.3.50; doc string of `fringe-styles' Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 01 Sep 2013 20:30:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 15239 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 15239@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.137806740018123 (code B ref -1); Sun, 01 Sep 2013 20:30:03 +0000 Received: (at submit) by debbugs.gnu.org; 1 Sep 2013 20:30:00 +0000 Received: from localhost ([127.0.0.1]:35513 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VGEHY-0004iE-08 for submit@debbugs.gnu.org; Sun, 01 Sep 2013 16:30:00 -0400 Received: from eggs.gnu.org ([208.118.235.92]:36819) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VGEHV-0004i0-0r for submit@debbugs.gnu.org; Sun, 01 Sep 2013 16:29:57 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VGEHF-0006JE-Pg for submit@debbugs.gnu.org; Sun, 01 Sep 2013 16:29:51 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-0.0 required=5.0 tests=BAYES_40 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:42739) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VGEHF-0006J8-MY for submit@debbugs.gnu.org; Sun, 01 Sep 2013 16:29:41 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:38520) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VGEH7-0003dr-3R for bug-gnu-emacs@gnu.org; Sun, 01 Sep 2013 16:29:41 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VGEGy-0006EW-HQ for bug-gnu-emacs@gnu.org; Sun, 01 Sep 2013 16:29:33 -0400 Received: from userp1040.oracle.com ([156.151.31.81]:18023) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VGEGy-0006ER-9v for bug-gnu-emacs@gnu.org; Sun, 01 Sep 2013 16:29:24 -0400 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 ; Sun, 1 Sep 2013 20:29:23 GMT 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 ; Sun, 1 Sep 2013 20:29:22 GMT 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 ; Sun, 1 Sep 2013 20:29:21 GMT MIME-Version: 1.0 Message-ID: <64b1e984-a1b7-4ad7-9f1c-261abe9af91c@default> Date: Sun, 1 Sep 2013 13:29:19 -0700 (PDT) From: Drew Adams X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8 (707110) [OL 12.0.6680.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable 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-Received-From: 2001:4830:134:3::11 X-Spam-Score: -2.4 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.4 (--) 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' From unknown Sun Jun 22 09:58:59 2025 X-Loop: help-debbugs@gnu.org Subject: bug#15239: 24.3.50; doc string of `fringe-styles' Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 01 Sep 2013 20:35:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 15239 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 15239@debbugs.gnu.org Received: via spool by 15239-submit@debbugs.gnu.org id=B15239.137806766718651 (code B ref 15239); Sun, 01 Sep 2013 20:35:01 +0000 Received: (at 15239) by debbugs.gnu.org; 1 Sep 2013 20:34:27 +0000 Received: from localhost ([127.0.0.1]:35518 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VGELq-0004ql-Vs for submit@debbugs.gnu.org; Sun, 01 Sep 2013 16:34:27 -0400 Received: from aserp1040.oracle.com ([141.146.126.69]:44703) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VGELp-0004qV-GT for 15239@debbugs.gnu.org; Sun, 01 Sep 2013 16:34:26 -0400 Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by aserp1040.oracle.com (Sentrion-MTA-4.3.1/Sentrion-MTA-4.3.1) with ESMTP id r81KYIfp014773 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for <15239@debbugs.gnu.org>; Sun, 1 Sep 2013 20:34:19 GMT Received: from userz7022.oracle.com (userz7022.oracle.com [156.151.31.86]) by ucsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id r81KYHhh024114 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for <15239@debbugs.gnu.org>; Sun, 1 Sep 2013 20:34:18 GMT Received: from abhmt105.oracle.com (abhmt105.oracle.com [141.146.116.57]) by userz7022.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id r81KYHl2024110 for <15239@debbugs.gnu.org>; Sun, 1 Sep 2013 20:34:17 GMT MIME-Version: 1.0 Message-ID: <43b4d10d-e7b5-4f01-b08b-91b3de96d630@default> Date: Sun, 1 Sep 2013 13:34:15 -0700 (PDT) From: Drew Adams References: <64b1e984-a1b7-4ad7-9f1c-261abe9af91c@default> In-Reply-To: <64b1e984-a1b7-4ad7-9f1c-261abe9af91c@default> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8 (707110) [OL 12.0.6680.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: ucsinet22.oracle.com [156.151.31.94] X-Spam-Score: -4.7 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -4.7 (----) Actually, things are apparently worse than I thought at first: The doc string of `fringe-mode' seems to have the same problems. From unknown Sun Jun 22 09:58:59 2025 X-Loop: help-debbugs@gnu.org Subject: bug#15239: 24.3.50; doc string of `fringe-styles' Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 08 Feb 2014 04:43:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 15239 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Drew Adams Cc: 15239@debbugs.gnu.org Received: via spool by 15239-submit@debbugs.gnu.org id=B15239.139183454321639 (code B ref 15239); Sat, 08 Feb 2014 04:43:01 +0000 Received: (at 15239) by debbugs.gnu.org; 8 Feb 2014 04:42:23 +0000 Received: from localhost ([127.0.0.1]:55962 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WBzkF-0005cq-1X for submit@debbugs.gnu.org; Fri, 07 Feb 2014 23:42:23 -0500 Received: from hermes.netfonds.no ([80.91.224.195]:56190) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WBzkD-0005ci-QP for 15239@debbugs.gnu.org; Fri, 07 Feb 2014 23:42:22 -0500 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 ) id 1WBzjv-00058E-3W; Sat, 08 Feb 2014 05:42:03 +0100 From: Lars Ingebrigtsen References: <64b1e984-a1b7-4ad7-9f1c-261abe9af91c@default> Date: Fri, 07 Feb 2014 20:40:54 -0800 In-Reply-To: <64b1e984-a1b7-4ad7-9f1c-261abe9af91c@default> (Drew Adams's message of "Sun, 1 Sep 2013 13:29:19 -0700 (PDT)") Message-ID: <87y51m43op.fsf@building.gnus.org> User-Agent: Gnus/5.13001 (Ma Gnus v0.10) Emacs/24.3.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-MailScanner-ID: 1WBzjv-00058E-3W X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1392439323.92397@cbJltRtDLpdJNJ2vwhSO+A X-Spam-Status: No X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.0 (/) Drew Adams 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/ From debbugs-submit-bounces@debbugs.gnu.org Fri Feb 07 23:42:27 2014 Received: (at control) by debbugs.gnu.org; 8 Feb 2014 04:42:27 +0000 Received: from localhost ([127.0.0.1]:55964 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WBzkI-0005d6-FW for submit@debbugs.gnu.org; Fri, 07 Feb 2014 23:42:26 -0500 Received: from hermes.netfonds.no ([80.91.224.195]:56194) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WBzkE-0005cp-NA for control@debbugs.gnu.org; Fri, 07 Feb 2014 23:42:22 -0500 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 ) id 1WBzk0-00058R-UW for control@debbugs.gnu.org; Sat, 08 Feb 2014 05:42:09 +0100 Date: Fri, 07 Feb 2014 20:41:00 -0800 Message-Id: <87wqh643oj.fsf@building.gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #15239 X-MailScanner-ID: 1WBzk0-00058R-UW X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1392439329.46481@G4SZ5UWHHaFVz9D+Tuf//A X-Spam-Status: No X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.0 (/) close 15239 24.4