* Re: emacs-26 de17b8e: Tiny doc/misc markup fixes
[not found] ` <20180222174221.2417A209B1@vcs0.savannah.gnu.org>
@ 2018-02-23 9:05 ` Robert Pluim
2018-02-23 9:57 ` Michael Albinus
0 siblings, 1 reply; 4+ messages in thread
From: Robert Pluim @ 2018-02-23 9:05 UTC (permalink / raw)
To: emacs-devel; +Cc: Glenn Morris
rgm@gnu.org (Glenn Morris) writes:
> @@ -4069,7 +4069,7 @@ The variable @code{viper-read-buffer-function} controls which function is
> actually used to read the buffer name. The default is @code{read-buffer},
> but better alternatives are also available in Emacs (e.g.,
> @code{ido-read-buffer}).
> -@vindex @var{viper-read-buffer-function}
> +@vindex @code{viper-read-buffer-function}
> @item :B
> Like @kbd{:b}, but the meaning of @code{ex-cycle-other-window} is reversed.
> @item :<address>r <name>
Does @vindex actually require any markup on the variable name? Most of
its uses in the emacs documentation have no markup at all (although
@var is definitely wrong).
Robert
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: emacs-26 de17b8e: Tiny doc/misc markup fixes
2018-02-23 9:05 ` emacs-26 de17b8e: Tiny doc/misc markup fixes Robert Pluim
@ 2018-02-23 9:57 ` Michael Albinus
2018-02-23 13:31 ` Eli Zaretskii
0 siblings, 1 reply; 4+ messages in thread
From: Michael Albinus @ 2018-02-23 9:57 UTC (permalink / raw)
To: emacs-devel; +Cc: Glenn Morris
Robert Pluim <rpluim@gmail.com> writes:
> Does @vindex actually require any markup on the variable name? Most of
> its uses in the emacs documentation have no markup at all (although
> @var is definitely wrong).
I believe @findex and @vindex are defined using @defcodeindex, so
there's no need to markup the entries.
OTOH, @cindex is defined as @defindex, so we should mark symbols and
alike.
For discussion, see "(texinfo) New Indices".
I will go through the manual(s), and remove markups in @findex and
@vindex entries.
> Robert
Best regards, Michael.
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: emacs-26 de17b8e: Tiny doc/misc markup fixes
2018-02-23 9:57 ` Michael Albinus
@ 2018-02-23 13:31 ` Eli Zaretskii
2018-02-23 13:38 ` Michael Albinus
0 siblings, 1 reply; 4+ messages in thread
From: Eli Zaretskii @ 2018-02-23 13:31 UTC (permalink / raw)
To: Michael Albinus; +Cc: rgm, emacs-devel
> From: Michael Albinus <michael.albinus@gmx.de>
> Date: Fri, 23 Feb 2018 10:57:57 +0100
> Cc: Glenn Morris <rgm@gnu.org>
>
> Robert Pluim <rpluim@gmail.com> writes:
>
> > Does @vindex actually require any markup on the variable name? Most of
> > its uses in the emacs documentation have no markup at all (although
> > @var is definitely wrong).
>
> I believe @findex and @vindex are defined using @defcodeindex, so
> there's no need to markup the entries.
Indeed, there's no need. But viper.texi does this for all the index
entries, so all of them should be fixed. Patches welcome.
> I will go through the manual(s), and remove markups in @findex and
> @vindex entries.
Thanks.
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: emacs-26 de17b8e: Tiny doc/misc markup fixes
2018-02-23 13:31 ` Eli Zaretskii
@ 2018-02-23 13:38 ` Michael Albinus
0 siblings, 0 replies; 4+ messages in thread
From: Michael Albinus @ 2018-02-23 13:38 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: rgm, emacs-devel
Eli Zaretskii <eliz@gnu.org> writes:
>> I believe @findex and @vindex are defined using @defcodeindex, so
>> there's no need to markup the entries.
>
> Indeed, there's no need. But viper.texi does this for all the index
> entries, so all of them should be fixed. Patches welcome.
OTOH, non-code parts of @findex and @vindex must be marked with
@r{}. Sometimes this is done, sometimes not. Will fix this as well.
>> I will go through the manual(s), and remove markups in @findex and
>> @vindex entries.
I'm almost ready. Expect my patch later today.
> Thanks.
Best regards, Michael.
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2018-02-23 13:38 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
[not found] <20180222174220.30813.21516@vcs0.savannah.gnu.org>
[not found] ` <20180222174221.2417A209B1@vcs0.savannah.gnu.org>
2018-02-23 9:05 ` emacs-26 de17b8e: Tiny doc/misc markup fixes Robert Pluim
2018-02-23 9:57 ` Michael Albinus
2018-02-23 13:31 ` Eli Zaretskii
2018-02-23 13:38 ` Michael Albinus
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.