Re: [Bug-AUCTeX] Better documenting difference between AucTeX Texinfo and native Texinfo modes

[Ralf Angeli]

* Vincent Belaïche (2009-06-30) writes:

> I think that the difference of AucTeX TeXinfo mode w.r.t. to native 
> TeXinfo mode should be better documented.

Well, AFAICS the Texinfo mode of AUCTeX is not documented at all.  At
least with respect to the manual.  So there is not really a basis to be
improved.

> This is because when you edit 
> a TeXinfo file you still rely on the native TeXinfo to make texinfo 
> specific thing (like updating node pointer).

Yes, but I'm not sure this technicality has to be prominently exposed in
the manual.  I'd probably document the functionality AUCTeX provides
itself or exposes from the native Texinfo mode via the menus and refer
to the documentation of the native mode for the rest.

In any case, the Texinfo mode in AUCTeX has always felt somewhat
inconsistent and unfinished to me.  When editing the AUCTeX and RefTeX
manuals I'm usually struggling with the insertion of sections and nodes
as they are used nowadays in these manuals and with updating the menus.
There is likely some potential for improvement.

-- 
Ralf