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

Previous Next

Full log

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:

Previous Next

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