Re: Patch: documentation for erlang.m4 macros

[Stepan Kasal]

Hello Ralf and all,

when committing text written by Romain Lenglet, I inserted

| @ovindex ERLANG_INSTALL_LIB_DIR
| @acindex ERLANG_SUBST_INSTALL_LIB_DIR

to autoconf.texi.

Ralf, you reported that texi2dvi loops endlessly on the second of these
two lines.  But the explanation is different than the one you wrote:

address@hidden' is a Texinfo primitive.
(Well, kind of, it is actually created by address@hidden ov'.)

OTOH, address@hidden' is a @macro, defined at the top of autoconf.texi.

The parameter list given to the user-macros shall be enclosed in braces:
| @foo{prm1, prm2, prm3}

So the line is question was actually incorrect, it should have been:

| @acindex{ERLANG_SUBST_INSTALL_LIB_DIR}

I have fixed this in the Autoconf CVS, see the patch attached below.

But the story continues:
Why the endless loop?  If the user macro takes exactly one parameter,
there is an alternative way to call it, when the parameter spand to the
end of the line
| @foo parameter

But no one uses this, so no one noticed when I broke that feature a few
years ago.  I introduced a conflict between macros \braceorline and
\parsearg: they both used \next as temporary storage.

I have fixed that problem in the Texinfo CVS; see the attached patch.

Have a nice day,
        Stepan

texinfo-20060321-parsearg.patch
Description: Text document

autoconf-20060321-doc-braces.patch
Description: Text document