* bug#3639: 23.0.95; defcustom docstring ':link' ':tag' NAME and/or LABEL?
@ 2009-06-21 13:50 MON KEY
2011-07-12 15:21 ` Lars Magne Ingebrigtsen
0 siblings, 1 reply; 3+ messages in thread
From: MON KEY @ 2009-06-21 13:50 UTC (permalink / raw
To: emacs-pretest-bug
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:
^ permalink raw reply [flat|nested] 3+ messages in thread
* bug#3639: 23.0.95; defcustom docstring ':link' ':tag' NAME and/or LABEL?
2009-06-21 13:50 bug#3639: 23.0.95; defcustom docstring ':link' ':tag' NAME and/or LABEL? MON KEY
@ 2011-07-12 15:21 ` Lars Magne Ingebrigtsen
2011-07-15 19:16 ` MON KEY
0 siblings, 1 reply; 3+ messages in thread
From: Lars Magne Ingebrigtsen @ 2011-07-12 15:21 UTC (permalink / raw
To: MON KEY; +Cc: 3639
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/
^ permalink raw reply [flat|nested] 3+ messages in thread
* bug#3639: 23.0.95; defcustom docstring ':link' ':tag' NAME and/or LABEL?
2011-07-12 15:21 ` Lars Magne Ingebrigtsen
@ 2011-07-15 19:16 ` MON KEY
0 siblings, 0 replies; 3+ messages in thread
From: MON KEY @ 2011-07-15 19:16 UTC (permalink / raw
To: Lars Magne Ingebrigtsen; +Cc: 3639
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\
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2011-07-15 19:16 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2009-06-21 13:50 bug#3639: 23.0.95; defcustom docstring ':link' ':tag' NAME and/or LABEL? MON KEY
2011-07-12 15:21 ` Lars Magne Ingebrigtsen
2011-07-15 19:16 ` MON KEY
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.