From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#10475: 24.0.92; `C-h v' displays `*' indicating user option Date: Tue, 10 Jan 2012 14:08:51 -0800 Message-ID: <18E370DBB9F14AD7AAE6181C1CB116B7@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1326233389 27711 80.91.229.12 (10 Jan 2012 22:09:49 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Tue, 10 Jan 2012 22:09:49 +0000 (UTC) To: 10475@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Jan 10 23:09:45 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Rkjt2-0006Dz-TK for geb-bug-gnu-emacs@m.gmane.org; Tue, 10 Jan 2012 23:09:45 +0100 Original-Received: from localhost ([::1]:55308 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Rkjt2-0008SW-Au for geb-bug-gnu-emacs@m.gmane.org; Tue, 10 Jan 2012 17:09:44 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:34342) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Rkjsz-0008SR-K9 for bug-gnu-emacs@gnu.org; Tue, 10 Jan 2012 17:09:42 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Rkjsy-0003Hx-PF for bug-gnu-emacs@gnu.org; Tue, 10 Jan 2012 17:09:41 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:58245) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Rkjsy-0003Ht-Nn for bug-gnu-emacs@gnu.org; Tue, 10 Jan 2012 17:09:40 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1RkjtK-0007yT-5y for bug-gnu-emacs@gnu.org; Tue, 10 Jan 2012 17:10:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 10 Jan 2012 22:10:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 10475 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.132623336930579 (code B ref -1); Tue, 10 Jan 2012 22:10:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 10 Jan 2012 22:09:29 +0000 Original-Received: from localhost ([127.0.0.1]:52918 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Rkjsm-0007x9-HN for submit@debbugs.gnu.org; Tue, 10 Jan 2012 17:09:29 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:55401) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Rkjsk-0007x2-5I for submit@debbugs.gnu.org; Tue, 10 Jan 2012 17:09:27 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RkjsN-00034H-4u for submit@debbugs.gnu.org; Tue, 10 Jan 2012 17:09:04 -0500 Original-Received: from lists.gnu.org ([140.186.70.17]:44538) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RkjsN-00034D-3L for submit@debbugs.gnu.org; Tue, 10 Jan 2012 17:09:03 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:60956) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RkjsM-0007oT-3y for bug-gnu-emacs@gnu.org; Tue, 10 Jan 2012 17:09:03 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RkjsL-00033t-5W for bug-gnu-emacs@gnu.org; Tue, 10 Jan 2012 17:09:02 -0500 Original-Received: from acsinet15.oracle.com ([141.146.126.227]:26953) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RkjsK-00033h-Sk for bug-gnu-emacs@gnu.org; Tue, 10 Jan 2012 17:09:01 -0500 Original-Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by acsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id q0AM8uTC032719 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Tue, 10 Jan 2012 22:08:57 GMT Original-Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by ucsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q0AM8uTV022577 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Tue, 10 Jan 2012 22:08:56 GMT Original-Received: from abhmt109.oracle.com (abhmt109.oracle.com [141.146.116.61]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q0AM8tnT005921 for ; Tue, 10 Jan 2012 16:08:55 -0600 Original-Received: from dradamslap1 (/10.159.40.40) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Tue, 10 Jan 2012 14:08:55 -0800 X-Mailer: Microsoft Office Outlook 11 Thread-Index: AczP5G81hhC8m5hkQryKjw+tGcjvlg== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: ucsinet22.oracle.com [156.151.31.94] X-CT-RefId: str=0001.0A090205.4F0CB6FA.0003,ss=1,re=0.000,fgs=0 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) 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:55622 Archived-At: (defcustom foo nil "*A foobar function or nil." :type '(choice (const :tag "None" nil) function) :group 'convenience) Then `C-h v foo'. The `*' indicating that this is a user variable (e.g. usable by `set-variable') is printed as if it were part of the doc. It should be removed. The fix is trivial: (when (eq ?* (elt doc 0)) (setq doc (substring doc 1))) Yes, Emacs no longer requires a `*' as a doc-string prefix with `defcustom'. But `describe-variable' should still DTRT with doc strings from code that is designed to work also with older Emacs versions. In addition, `user-variable-p' is the test used for functions such as `set-variable', and it`user-variable-p' recognizes the `*' as defining a user variable. This is correct behavior. The only problem is that `describe-variable' should not treat this `*' as if it were part of the doc text. In GNU Emacs 24.0.92.1 (i386-mingw-nt5.1.2600) of 2012-01-05 on MARVIN Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.6) --no-opt --cflags -ID:/devel/emacs/libs/libXpm-3.5.8/include -ID:/devel/emacs/libs/libXpm-3.5.8/src -ID:/devel/emacs/libs/libpng-dev_1.4.3-1/include -ID:/devel/emacs/libs/zlib-dev_1.2.5-2/include -ID:/devel/emacs/libs/giflib-4.1.4-1/include -ID:/devel/emacs/libs/jpeg-6b-4/include -ID:/devel/emacs/libs/tiff-3.8.2-1/include -ID:/devel/emacs/libs/gnutls-3.0.9/include --ldflags -LD:/devel/emacs/libs/gnutls-3.0.9/lib'