Re: XML/Info discrepancy for @deffn CATEGORY

[Thien-Thi Nguyen]

() Patrice Dumas <address@hidden>
() Mon, 31 Dec 2012 18:58:28 +0100

   > I tried to put curly braces in the
   > macro definition, but that produces an error:
   > 
   >  ./guile-api.texi:567: Misplaced { (possibly involving @PROC)
   >  ./guile-api.texi:567: Misplaced }

   That's weird.  I don't see such an error with

    @macro PROC
    {Scheme Procedure}
    @end macro

    @deffn @PROC{} global-init servertype
    @end deffn

Sorry, i was in a hurry and mixed up the test cases.  That particular
error occurs with makeinfo 4.13, not 4.13.92.

   > Lastly, i searched NEWS for something that fits this new behavior,
   > but did not find anything.  Am i missing something?

   [...] fact that @PROC{} is considered as a token is considered to be
   inconsistent for the @macro implementation, hence this is not kept in
   texi2any.  It is possible that it is more consistent with what TeX
   does, though.

Thanks for the explanation.  OK, so i surmise:

A. Braces in macro definition (as above) is OK for upcoming makeinfo,
   both Info and XML.

B. Braces at call site is OK for all (4.13 and upcoming) makeinfo,
   both Info and XML.

If i care about makeinfo 4.13, i should do B. until which time i don't
care anymore, and can switch to A.  But anyway, the current source (no
braces anywhere) needs to be changed; the problem is on my side.

-- 
Thien-Thi Nguyen ..................................... GPG key: 4C807502
.                  NB: ttn at glug dot org is not me                   .
.                 (and has not been since 2007 or so)                  .
.                        ACCEPT NO SUBSTITUTES                         .
........... please send technical questions to mailing lists ...........

pgpcwnjnORxdJ.pgp
Description: PGP signature