Re: [Orgmode] Command names are now in the manual

[Nick Dokos]

Carsten Dominik <address@hidden> wrote:


> I have just added the last command missing names to the manual.  So if =20=
> 
> you compile the manual in the latest git version, you will find =20
> command names listed for almost all keys listed in the manual, along =20
> with a much extended command and function index.
> 

I think there is a problem on line 4668: the @findex seems to dislike
braces around the name:

,----
| $ make html
| (cd doc; makeinfo --html --number-sections --no-split -o org.html org.texi)
| /home/nick/src/emacs/org/org-mode/doc
| org.texi:4668: Misplaced {.
| org.texi:4668: Misplaced }.
| org.texi:4668: Misplaced {.
| org.texi:4668: Misplaced }.
| makeinfo: Removing output file `org.html' due to errors; use --force to 
preserve.
| make: *** [doc/org.html] Error 1
`----

Other than that, it looks pretty good.

A suggestion for a possible(?) improvement: the "O" section of the
function index (and I imagine the variable index as well) is pretty
crowded :-). I wonder if texinfo has any facilities to break it up,
perhaps according to the first letter after the first dash.

Thanks!
Nick