From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Lars Ingebrigtsen 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 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: 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 ) 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 ) 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 ) 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 ) 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 ) 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 ) 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 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: 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 ) 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 ) 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 ) 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" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-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: 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/