bug-gnu-emacs
[Top][All Lists]
Advanced

[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 ;-)






reply via email to

[Prev in Thread] Current Thread [Next in Thread]