[Dev-luatex] luatex documentation

Reinhard Kotucha reinhard.kotucha at web.de
Mon May 26 03:40:38 CEST 2014


Hi,
it seems that pdf.setcatalog is a function now while the allegedly
removed pdf.catalog was a string.  The LuaTeX manual hasn't been
updated in this respect.

The manual which is currently in TeX Live refers to version 0.79.0
while TL-pretest provides version 0.79.1.  Though it's too late for
the TL-DVD, a network update of luatex-doc will be possible at any
time after the freeze.  

BTW, the manual is quite ambiguous.  The phrase "The value types are
strings..." could mean that pdf.catalog itself is a string or that
it's a function whose argument is a string.  Curiously, the phrase is
valid for both, pdf.catalog and pdf.setcatalog, but there is no way to
use these functions without reverse-engineering them.

In order to distinguish between functions and strings in the manual
it's desirable to attach braces to function names i.e.,
"pdf.setcatalog()" vs. "pdf.catalog".  Otherwise too much has to be
explained.

The phrase "The preferred interface is now pdf.setcatalog, ..." is
also misleading because the old interface had been removed and users
have no choice anyway.

Regards,
  Reinhard

-- 
----------------------------------------------------------------------------
Reinhard Kotucha                                      Phone: +49-511-3373112
Marschnerstr. 25
D-30167 Hannover                              mailto:reinhard.kotucha at web.de
----------------------------------------------------------------------------
Microsoft isn't the answer. Microsoft is the question, and the answer is NO.
----------------------------------------------------------------------------


More information about the dev-luatex mailing list