[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#3639: 23.0.95; defcustom docstring ':link' ':tag' NAME and/or LABEL?
From: |
MON KEY |
Subject: |
bug#3639: 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:
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- bug#3639: 23.0.95; defcustom docstring ':link' ':tag' NAME and/or LABEL?,
MON KEY <=