GNU bug report logs - #3639
23.0.95; defcustom docstring ':link' ':tag' NAME and/or LABEL?

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 3639 in the body.
You can then email your comments to 3639 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> emacsbugs.donarmstrong.com (full text, mbox):

From: MON KEY <monkey <at> sandpframing.com>
To: emacs-pretest-bug <at> gnu.org
Subject: 23.0.95; defcustom docstring ':link' ':tag' NAME and/or LABEL?
Date: Sun, 21 Jun 2009 09:50:23 -0400

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.

s_P

;;; ==============================

In GNU Emacs 23.0.95.1 (i686-pc-linux-gnu, GTK+ Version 2.12.12)
 of 2009-06-19 on slaptop
Windowing system distributor `The X.Org Foundation', version 11.0.10402000
Important settings:
  value of $LC_ALL: nil
  value of $LC_COLLATE: C
  value of $LC_CTYPE: nil
  value of $LC_MESSAGES: nil
  value of $LC_MONETARY: nil
  value of $LC_NUMERIC: nil
  value of $LC_TIME: nil
  value of $LANG: en_US
  value of $XMODIFIERS: nil
  locale-coding-system: iso-latin-1-unix
  default-enable-multibyte-characters: t

Major mode: Fundamental

Minor modes in effect:
  diff-auto-refine-mode: t
  shell-dirtrack-mode: t
  show-paren-mode: t
  display-time-mode: t
  tooltip-mode: t
  mouse-wheel-mode: t
  menu-bar-mode: t
  file-name-shadow-mode: t
  global-font-lock-mode: t
  global-auto-composition-mode: t
  auto-encryption-mode: t
  auto-compression-mode: t
  size-indication-mode: t
  column-number-mode: t
  line-number-mode: t
  transient-mark-mode: t

Recent input:

Recent messages:

Message #14 received at 3639 <at> debbugs.gnu.org (full text, mbox):

From: Lars Magne Ingebrigtsen <larsi <at> gnus.org>
To: MON KEY <monkey <at> sandpframing.com>
Cc: 3639 <at> debbugs.gnu.org
Subject: Re: 23.0.95; defcustom docstring ':link' ':tag' NAME and/or LABEL?
Date: Tue, 12 Jul 2011 17:21:59 +0200

MON KEY <monkey <at> sandpframing.com> 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/

Message #17 received at 3639 <at> debbugs.gnu.org (full text, mbox):

From: MON KEY <monkey <at> sandpframing.com>
To: Lars Magne Ingebrigtsen <larsi <at> gnus.org>
Cc: 3639 <at> debbugs.gnu.org
Subject: Re: 23.0.95; defcustom docstring ':link' ':tag' NAME and/or LABEL?
Date: Fri, 15 Jul 2011 15:16:11 -0400

On Tue, Jul 12, 2011 at 11:21 AM, Lars Magne Ingebrigtsen
<larsi <at> gnus.org> wrote:
fied. As presented, it is not clear if `:tag' has different meanings
within defcustom forms according to where it occurs.
>
> It seems pretty clear to me,
> and I know next to nothing about `defcustom', so I think this doesn't
> need clarification.
>
Thats a pathetic justification for closing this bug.
If you know next to nothing about defcustom then maybe you are not the
right person to make this decision!
Maybe you've misunderstood the issue?
Maybe your killing bugs for fun and profit?

--
/s_P\

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.