[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#2975: texinfo-master-menu and emacs.texi
From: |
Eli Zaretskii |
Subject: |
bug#2975: texinfo-master-menu and emacs.texi |
Date: |
Sat, 10 Dec 2011 13:00:11 +0200 |
> From: Stefan Monnier <monnier@IRO.UMontreal.CA>
> Cc: Štěpán Němec <stepnem@gmail.com>,
> 2975@debbugs.gnu.org, winkler@gnu.org,
> Karl Berry
> <karl@freefriends.org>
> Date: Thu, 08 Dec 2011 09:46:49 -0500
>
> Eli writes:
> > The simplest fix would be to remove the updating of the @node lines.
> > Would anyone object? Karl?
>
> That would be great.
I made it extremely optional instead: only "C-u N" where N is a number
would cause @node lines to be updated with next/prev/up pointers.
> Eli writes:
> > I guess I'm saying that the importance of these commands in the
> > context of maintaining Emacs documentation is somewhat exaggerated in
> > this thread, to say the least ;-)
>
> IIUC the OP is not directly interested in maintaining Emacs
> documentation but rather is trying to write a manual for another project
> (BBDB, which happens to be an Emacs package).
He was asking about the effects of invoking these commands on
emacs.texi.
> Eli writes:
> > Here's what I see there:
> > . texinfo-master-menu indeed does not support multiple-file manuals,
> > so it removed all the menu items whose nodes are in files other
> > than emacs.texi itself
>
> A good fix here would be for texinfo-master-menu to detect the problem
> and signal a warning/error.
>
> > . texinfo-master-menu doesn't grok @iftex and @ifnottext conditionals
> > (and probably the other @if... conditionals as well), so it
> > produced bad Next and Prev pointers, because, e.g., this:
>
> If leaving Node pointers alone fixes this problem, then there's nothing
> else to do, but otherwise texinfo-master-menu should try and detect
> these problematic cases and signal an error/warning.
The detection and error signaling are left as an exercise for the
interested readers ;-)
- bug#2975: texinfo-master-menu and emacs.texi, Stefan Monnier, 2011/12/07
- bug#2975: texinfo-master-menu and emacs.texi, Roland Winkler, 2011/12/07
- bug#2975: texinfo-master-menu and emacs.texi, Eli Zaretskii, 2011/12/08
- bug#2975: texinfo-master-menu and emacs.texi, Roland Winkler, 2011/12/08
- bug#2975: texinfo-master-menu and emacs.texi, Roland Winkler, 2011/12/08
- bug#2975: texinfo-master-menu and emacs.texi, Štěpán Němec, 2011/12/08
- bug#2975: texinfo-master-menu and emacs.texi, Eli Zaretskii, 2011/12/08
- bug#2975: texinfo-master-menu and emacs.texi, Štěpán Němec, 2011/12/08
- bug#2975: texinfo-master-menu and emacs.texi, Roland Winkler, 2011/12/08
- bug#2975: texinfo-master-menu and emacs.texi, Eli Zaretskii, 2011/12/09
- bug#2975: texinfo-master-menu and emacs.texi, Roland Winkler, 2011/12/09
- bug#2975: texinfo-master-menu and emacs.texi, Karl Berry, 2011/12/09
- bug#2975: texinfo-master-menu and emacs.texi, Eli Zaretskii, 2011/12/10