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

MON KEY <[email protected]>
Newsgroups gmane.emacs.bugs,gmane.emacs.pretest.bugs
Message-ID <[email protected]>
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:
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.