From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Lars Magne Ingebrigtsen Newsgroups: gmane.emacs.bugs Subject: bug#3639: 23.0.95; defcustom docstring ':link' ':tag' NAME and/or LABEL? Date: Tue, 12 Jul 2011 17:21:59 +0200 Message-ID: References: <878wjln1b4.fsf@sandpframing.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: dough.gmane.org 1310491433 26779 80.91.229.12 (12 Jul 2011 17:23:53 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Tue, 12 Jul 2011 17:23:53 +0000 (UTC) Cc: 3639@debbugs.gnu.org To: MON KEY Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Jul 12 19:23:45 2011 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 1QgggT-00054e-0x for geb-bug-gnu-emacs@m.gmane.org; Tue, 12 Jul 2011 19:23:45 +0200 Original-Received: from localhost ([::1]:52447 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QgggR-0007YC-Q6 for geb-bug-gnu-emacs@m.gmane.org; Tue, 12 Jul 2011 13:23:43 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:49788) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qgeta-0003Dv-3p for bug-gnu-emacs@gnu.org; Tue, 12 Jul 2011 11:29:11 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QgetU-0007Pp-U0 for bug-gnu-emacs@gnu.org; Tue, 12 Jul 2011 11:29:09 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:45646) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QgetU-0007PQ-1F for bug-gnu-emacs@gnu.org; Tue, 12 Jul 2011 11:29:04 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1QgetS-0002yh-JK; Tue, 12 Jul 2011 11:29:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Lars Magne Ingebrigtsen Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 12 Jul 2011 15:29:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 3639 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: notabug Original-Received: via spool by 3639-submit@debbugs.gnu.org id=B3639.131048452911408 (code B ref 3639); Tue, 12 Jul 2011 15:29:02 +0000 Original-Received: (at 3639) by debbugs.gnu.org; 12 Jul 2011 15:28:49 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QgetD-0002xr-KK for submit@debbugs.gnu.org; Tue, 12 Jul 2011 11:28:48 -0400 Original-Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QgetB-0002xX-VW for 3639@debbugs.gnu.org; Tue, 12 Jul 2011 11:28:46 -0400 Original-Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=quimbies.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1Qget0-0004Hg-Fo; Tue, 12 Jul 2011 17:28:34 +0200 In-Reply-To: <878wjln1b4.fsf@sandpframing.com> (MON KEY's message of "Sun, 21 Jun 2009 09:50:23 -0400") User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.50 (gnu/linux) X-Now-Playing: Peter Gabriel's _Peter Gabriel 2_: "On The Air" X-Hashcash: 1:23:110712:3639@debbugs.gnu.org::o+4r65Ew+rDn/Rzk:00000000000000000000000000000000000000000DjGj X-Hashcash: 1:23:110712:monkey@sandpframing.com::qqcQeg0ErQYbFSf4:00000000000000000000000000000000000001uXvd X-MailScanner-ID: 1Qget0-0004Hg-Fo MailScanner-NULL-Check: 1311089314.58561@qZyhMXrh2WvXs6+4k497cA X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Tue, 12 Jul 2011 11:29:02 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) 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:48752 Archived-At: MON KEY writes: > The docstring for defcustom's keyword `:link' states: > > "You can specify the text to use in the customization buffer by adding `:tag > NAME' after the first element of the LINK-DATA; for example, (info-link :tag > "foo" "(emacs)Top") makes a link to the Emacs manual which appears in the > buffer as `foo'." > > Shortly thereafter a description of defcustom's keyword `:tag' states: > > ":tag LABEL Use LABEL, a string, instead of the item's name, to label the item > in customization menus and buffers." > > If these two uses of 'tag' have identical context, then the `:tag NAME' > descriptor of the `:link' section should clarify this and/or change 'NAME' -> > 'LABEL'. > > If the context of 'tag' is mutually exclusive then _that_ should > be clarified. As presented, it is not clear if `:tag' has different meanings within defcustom forms according to where it occurs. The first talks about using :tag inside `info-link'. The second about using :tag in the `defcustom' top-level. It seems pretty clear to me, and I know next to nothing about `defcustom', so I think this doesn't need clarification. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/