>>>>> "Robert" == Robert J Chassell <[EMAIL PROTECTED]> writes:

Hi Robert,

Robert> `makeinfo' was designed so that if you arrange your document
Robert> in a standard, book-like hierarchical way, you do not need to
Robert> specify next, previous, and up pointers for node lines.

Yes, indeed.  I was trying to understand where was the difference
between a file with light @node accepted by makeinfo, and another one
rejected by makeinfo.  It turns out `makeinfo' likes you if you do
have a node named `Top', otherwise it doesn't.  I would suggest that
makeinfo warns if it doesn't see such a node.  Better yet, if the
first node is not named Top.

I've already written several documents in Texinfo, but the last time I
started one from scratch was long ago, and I had totally forgotten the
``requirement'' for @node Top.  A warning would have helped me a lot
here.



Robert> Texinfo mode in Emacs has commands to create and update menus
Robert> and pointers for you automatically.  These commands are very
Robert> convenient.

Yep, I C-u C-c C-u C-a all the time in the texis I maintain.  The
Texinfo mode is really helpy.



Robert> Don't forget the other Texinfo mode commands.  For example,
Robert> `texinfo-insert-node-lines' and `texinfo-all-menus-update' are
Robert> both helpful:

Robert>      M-x texinfo-insert-node-lines Insert missing `@node'
Robert> lines in region.  With `C-u' as a prefix argument, use section
Robert> titles as node names.
     
I'd like to express a wish for C-c C-s.  I'd like that it behaves the
way AUC-TeX does:

| C-c C-s runs `LaTeX-section'
| 
| `LaTeX-section' is an interactive compiled Lisp function
|   -- loaded from "latex"
| (LaTeX-section ARG)
| 
| Documentation:
| Insert a template for a LaTeX section.
| Determinate the type of section to be inserted, by the argument ARG.
| 
| If ARG is nil or missing, use the current level.
| If ARG is a list (selected by C-u), go downward one level.
| If ARG is negative, go up that many levels.
| If ARG is positive or zero, use absolute level:
| 
|   0 : part
|   1 : chapter
|   2 : section
|   3 : subsection
|   4 : subsubsection
|   5 : paragraph
|   6 : subparagraph
| 
| The following variables can be set to customize:
| 
| LaTeX-section-hook    Hooks to run when inserting a section.
| LaTeX-section-label   Prefix to all section labels.

The nice thing is that it asks for the section you want (chapter
etc.), then for the title.  In the case of Texinfo, if I call my
section blee, it could insert

@node blee
@chapter blee

I'm not too fond of the comment Texinfo-mode inserts:

| @node 
| @comment  node-name,  next,  previous,  up

but at least, IMHO, it would be much more convenient if it were
included *before* the @node.  Still, I think without is better.

Anyway, I'd like to thanks for your mode.  Without it writing Texinfo
would not give the same pleasure.

        Akim

Reply via email to