bug-texinfo
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Patch: documentation for erlang.m4 macros


From: Stepan Kasal
Subject: Re: Patch: documentation for erlang.m4 macros
Date: Tue, 21 Mar 2006 22:59:51 +0100
User-agent: Mutt/1.4.1i

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

Attachment: texinfo-20060321-parsearg.patch
Description: Text document

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


reply via email to

[Prev in Thread] Current Thread [Next in Thread]