[AUCTeX-devel] Re: [AUCTeX-diffs] Changes to auctex/doc/todo.texi

[Ralf Angeli]

* David Kastrup (2005-04-28) writes:

> Just in case it gives anybody else the willies: for some completely
> obscure reason, makeinfo needs at least one "real" chapter in order to
> generate chapter numbers for the raised sections.  This was
> particularly annoying for the FAQ since an unnumbered FAQ file is not
> really something good to refer to.
[...]
> Did I mention this already on the list?  Because if I didn't, it shows
> remarkable confidence in me to preserve this incredibly ugly code,
> which really looks like somebody lost his brain.  Unfortunately, I
> have not found a better solution yet, and we have enough other stuff
> to worry about.

Dealing with sectioning and nodes in Texinfo files is one of the most
annoying things.  It seemingly complains without apparent errors.  And
there are no good ways for debugging.  Whatever.

I fiddled with other stuff in doc/faq.texi and doc/todo.texi so long
that I didn't even try to use @raisesections without that hack.  Now
that you mention it I did and for me it actually works.  With the
following change doc/todo.texi compiles fine:

Index: todo.texi
===================================================================
RCS file: /cvsroot/auctex/auctex/doc/todo.texi,v
retrieving revision 1.16
diff -u -r1.16 todo.texi
--- todo.texi   28 Apr 2005 08:08:23 -0000      1.16
+++ todo.texi   28 Apr 2005 15:23:05 -0000
@@ -19,15 +19,11 @@
 @end menu
 
 @ifset rawfile
address@hidden Mid-term Goals
address@hidden Mid-term Goals
 @raisesections
 @end ifset
 
address@hidden rawfile
 @node Mid-term Goals
 @section Mid-term Goals
address@hidden ifclear
 
 @itemize @bullet
 @item Integration of @previewlatex{} into @AUCTeX{}

An analogous change in preview/doc/faq.texi and compiling it with
`makeinfo -D rawfile --no-headers faq.texi --output ../FAQ' works fine
as well.

$ makeinfo --version
makeinfo (GNU texinfo) 4.7

-- 
Ralf