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

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

[MON KEY]

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:

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

[Lars Magne Ingebrigtsen]

MON KEY <monkey@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/

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

[MON KEY]

On Tue, Jul 12, 2011 at 11:21 AM, Lars Magne Ingebrigtsen
<larsi@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\