Sync with TL 36055; fixed a bug on setting mu unit; a better mp_initialize_decimal_math
[luatex.git] / source / texk / web2c / luatexdir / NEWS
blobc8b22cef81ed23664dfa0ffc65cce56beaf25488
2 This file is in the public domain.
4 ==============================================================
5 Luatex beta-0.79.2 was released 20141111 (5082)
6 ==============================================================
9 * WARNING: the structure of the format file is changed.
10   After  the  Web2C \TeX's magic constant: "W2TX"  there is now
11   a FORMAT_ID, a 32bit field that cannot be between 0 and 256 (included)
12   so that there are no conflicts with the preexisting  structure
13   of the format.
14   The value can be seen with --debug-format and currently is
15   907 (the sum of the values of the bytes of the ASCII string "don knuth").
17 * There is a new set of lua functions for StructElement and Attribute,
18   convenient (even if not indispensable) for tagged pdf.
19   
21 * several bugfixes and improvements.
24 ==============================================================
25 Luatex beta-0.79.0 was released 20140328 (4960)
26 ==============================================================
28 * The luafontloader now returns 'tsidebearing' glyph values
29   for OT/TT fonts, if applicable.
31 * new lua variables: stats.luatex_hashtype, stats.luatex_hashchars,
32   stats.lastluaerrorstring; the luajittex string hash method is now
33   lua 5.1 compliant which gives better results for similar strings
35 * new lua functions: tex.init_rand(), tex.uniform_rand(),
36   tex.normal_rand(), tex.lua_math_randomseed(), tex.lua_math_random(),
37   tex.show_context(); these helpers make luatex and luajittex compatible
39 * In the lua node interface, there were often issues with rubbish
40   in (especially) 'prev' fields because luatex itself never looks
41   at those values. This is now cleaned up to prevent weird stuff
42   happening inside lua node processing code.
44 * pdf.pageattributes, pdf.pagesattributes, pdf.info, pdf.catalog,
45   pdf.names and pdf.trailer now behave consistent and can be used
46   to add these properties at the lua end in addition to their \pdf*
47   counterparts atthe tex end; there are now pdf.get* and pdf.set*
48   commands for them too (in future versions the old ways can become
49   obsolete)
51 * new accessors pdf.geth, pdfgetv, pdfgetpos, getgetmatrix as well
52   as pdfhasmatrix helpers (in future versions the direct pdf.h and
53   pdf.v accessor can become obsolete)
55 * the pdf.pdf* variables have been removed (they were already
56   obsolete for some years)
58 * a new properties mechanism for associating lua tables with nodes
59   that get cleaned up when nodes a freed (see manual for details)
61 * several improvements to the way temporary (backend) data is stored
62   at the lua end (better protection, more consistent)
64 * a 'l' type for user nodes that holds a lua variable (can be set
65   at the lua end)
67 * if a late lua node is set at the lua end the string value can be
68   a function as well which is then executed during serialization to
69   the backend stream
71 * Various small speedups
73 * Various smallish fixes to the node direct interface
75 * LPeg is now at version 0.12
77 * Some small fixes to the CFF (font) parsing
79 * Font file inclusion reporting messages on the terminal now
80   comply to the texconfig.trace_file_names setting
82 * Removed some of the additional luafontloader.info() return
83   information that was added in 0.78.2, but could not work
84   properly.
86 * new primitive \luafunction (see manual), with associated
87   lua.get_functions_table() function
89 * lua error message reporting has been altered a bit to make
90   the distinction between \directlua and other lua source code
91   sources clearer
93 * Additional pdf document data functionality in the 'pdf' table
94   has been cleaned up internally
96 * Additional pdf destination names can now be set via lua.
98 * New callbacks: finish_pdfpage, show_error_message,
99   show_lua_error_hook, start_file, stop_file
101 * Handling of \tracinglostchars is fixed
103 * Embedded metapost library version is now 1.900
105 * luajittex is now included in the distribution. One can use
106   buildjit.sh to build both luatex and luajittex, where
107   supported by the platform
109 * Synchronization with the TeXLive sources updated the following
110   libraries:
111   * libpng is now 1.6.10
112   * poppler is now 0.25.2
114 ==============================================================
115 Luatex beta-0.78.2 was released 20140113 (4748)
116 ==============================================================
118 * Extended luafontloader's info() function to include data
119   from the 'pfminfo' and 'names' structure.
121 * Fixed a bug in the luafontloader library that made loading
122   some fonts extremely slow (LastResort.ttf)
124 * Removed a recent extension in the luafontloader library that
125   made loading fonts with lots of glyphs slow (ArialUnicoce.ttf).
126   Note: the extension made sure that there were no duplicate
127   glyph names in the font after loading.
129 * Restored --recorder output for lua files (dofile/loadfile/io.open)
131 * One-at-a-time pattern adding from lua used to require enormous
132   amounts of memory
134 * luatex's fontloader.to_table() no longer reports 'altuni' table
135   information for alternates that are solely driven by the font
136   encoding. This fixes loading time issues for fonts that fill
137   encodings by copying a single glyph many times, like e.g.
138   LastResort.ttf from Apple.
140 * The datestamp no longer appears in any banners. The associated
141   \luatexdatestamp primitive is deprecated and will be removed
142   in 0.80.0.
144 * Synchronization with the TeXLive sources updated the following
145   libraries:
146   * cairo is now 1.12.16
147   * pixman is now 0.32.4
148   * lua is now 5.2.3
149   * zlib is now 1.2.8
150   * poppler is now 0.25.0
152 * That same TL synchronization also fixes these issues:
153   * Always write "\nendstream" to the PDF for PDF/A-1b compliance.
154   * Large file support (>4GB) in Lua
155   * Big images could overflow on systems where sizeof(long)=4.
156   * In writing CID CFF fonts to the PDF, and end_dict() was missing.
157   * Unknown 'post' table versions (found in some broken ttf/otf
158     fonts) are now treated as-if they specified version 3.0.
159   * Fix crashes on 32-bit systems caused by bad C header inclusion
160     order
161   * Handle '--luac' and '--luaconly' properly
162   * luatex is now released under GPLv2+, not just GPLv2.
163   * luatex can now find .ofm metric files even if the extension
164     is not given explicitly.
166 * node.unset_attribute() was broken in 0.78.0
168 * The UTF-8 commandline patch from 0.78.0 for Win32 was removed
169   again (did not work properly)
171 ==============================================================
172 Luatex beta-0.78.0 was released 20131231
173 ==============================================================
175 * Instead of using expanded fonts, just calculate the expanded
176   width of glyphs where needed, and carry expand info in the
177   glyph nodes (all based on Hans' suggestions). All font expansion
178   functions are disabled and most are removed.
180 * New, faster (but limited) direct node access from lua, see
181   the manual for details
183 * Support for Apple Advanced Typography (AAT) information in
184   fonts is dropped
186 * Extended build script for mingw/msys (includes 64-bit support)
188 * Various patches from/via Akira Kakuta for better Win32
189   integration
191 * Fixes for some bugs in de pdfscanner library (mostly related
192   to inline images)
194 * Maximum hyphenated word length is now 64Kb characters.
196 * Various patches from Khaled Hosny and Luigi Scarso for the
197   luafontloader subsystem
199 * Fix for a crash when re-dumping formats
201 * Fix for a Selene unicode library bug where some characters in
202   UTF-8 were incorrectly flagged as having the 'Space' property
204 * Some smaller fixes
206 ==============================================================
207 Luatex beta-0.76.0 was released 20130405
208 ==============================================================
210 * Metapost 1.801.
212 * Small patches from TeXLive 2013, as well as an update to the
213   latest libraries (libpng, poppler, etc.)
215 * Speed up printing (of TeX strings) to the terminal and log.
217 * New lua function node.end_of_math().
219 * Fixed a memory leak in the lua function pdfscanner.scan().
221 ==============================================================
222 Luatex beta-0.75.0 was released 20130301
223 ==============================================================
225 News:
227 * New expandable primitive \Uchar.
229 * Metapost 1.790.
231 * New version of lnodelib.c with speedups by Hans and Luigi.
232   Also added some extra sanity checks to the Lua node field
233   setting functions.
235 * Support 'umath' in tex.extraprimitives(), so that formats can
236   make the \Umath* primitives unprefixed, now that they will be
237   provided by XeTeX as well.
239 * Removed a bunch of deprecated primitives
240   * \AlephVersion, \Alephrevision, \Alephversion, \Alephminorversion
241   * \OmegaVersion, \Omegarevision, \Omegaversion, \Omegaminorversion
242   * \omathcode, \odelcode, \omathchardef, \omathchar, \omathaccent,
243     \odelimiter, \oradical
244   * \Umathbotaccent, \Umathaccents
246 * Fix large file support.
248 * Fix Lua's loadfile().
250 * Removed the cidmap callbacks again (let that be done by user lua
251   code after the fact).
253 * Removed the fatal error on fonts where num_glyphs is too high,
254   as that problem is actually harmless.
256 * Some compilation issues under Win32 and Solaris resolved.
258 * Allow math extender objects to be zero width.
260 * The 'epdf' library has been extended to deal with finding and
261   saving embedded files (catalog:numEmbeddedFiles() and catalog:
262   embeddedFile, new EmbFile object).
264 ==============================================================
265 Luatex beta-0.74.0 was released 20121224
266 ==============================================================
268 News:
270 * lua 5.2
271   There are no patches to the core Lua files; a future version
272   of luatex will switch to loading the regular lua 5.2 dynamic
273   library instead of depending on a statically compiled
274   one.
276 * A bleeding-edge version of luasocket is included, as there
277   is no 5.2-compatible official release yet.
279 * A new lua extension is the two-argument version of
280   string.dump from Luajit:
282     string.dump(function f, [boolean strip])
284 * mpost 1.780
286 * The implied existence of the following lua libraries is now
287   deprecated:
289      debug, unicode.*, luazip, lfs, lpeg, zlib, gzip, md5,
290      socket.*, profiler, epdf, fontloader, mplib, and
291      pdfscanner.
293   Future versions of luatex will load these modules on demand
294   from dynamic libraries.
296   Please update your sources to include a 'require' line for
297   each of the library modules mentioned.
299 * Two new callbacks: find_cidmap_file and load_cidmap_file
300   (used by the fontloader to discover .cidmaps)
302 ==============================================================
303 Luatex beta-0.72.0 was released 20121210
304 ==============================================================
306 News:
308 * update various used libraries, including mplib 1.770,
309   poppler 0.21, libpng 1.5, and lpeg 0.10.2.
311 * new 'pdfscanner' lua library.
313 * various OpenType math fixes, including \Umathcharnumdef.
315 * improved placement of bottom accents.
317 * various other small fixes that have accumulated over the past
318   year-and-a-half.
320 ==============================================================
321 Luatex beta-0.70.1 was released 20110519
322 ==============================================================
324 News:
326 * fixed: recorder file location from TL (Akira).
328 * fixed: missing newline on 'No output' line.
330 * fixed: relative names in synctex file.
332 * fixed: 16bit png images in generated %!PDF-1.4.
334 * fixed: building with (installed) libpng < 1.5.0
336 * fixed: year in --version output.
338 * fixed: box output to synctex.
340 * fixed: FontDescriptor for non-embedded OpenType fonts has an
341   invalid FontFile3 entry (#654)
343 * fixed: crash on non-existent images.
345 * fixed: small memory leak in the ipc code.
347 * fixed: tex.print() and tex.sprint() don't recognize -2 as the
348   first argument (#659)
350 ==============================================================
351 Luatex beta-0.70.0 was released 20110506
352 ==============================================================
354 News:
356 * fixed: various changes needed for libpng 1.5.2.
358 * fixed: node.fields() for nodes without subtype.
360 * fixed: non-argument use of os.execute().
362 * fixed: tex.[s|t|]print() with invalid catcode table arguments.
364 * fixed: recorder filename location with --output-directory.
366 * fixed: display alignment in TRT mode.
368 * luatex now uses the standard synctex files from Jérome Laurens.
371 ==============================================================
372 Luatex beta-0.66.0 was released 20110412
373 ==============================================================
375 News:
377 * fixed: linebreak_filter doesn't do its default job when
378   tex.linebreak is used
380 * fixed: \escapechar ignored by \meaning
382 * fixed: wrong px default
384 * fixed: font kern attribute inheritance
386 * fixed: "nop" unrecognized in virtual fonts
388 * fixed: assertion failure in dviluatex when font ptmr8t used
390 * fixed: tex.settoks for with strings with embedded zeroes
392 * fixed: an indexing problem with nonexistent font glyphs
394 * fixed: some crashes and other bugs on the 'subtype' and 'prev'
395   fields (not all node types have those fields)
397 * fixed: crash on  token.csname_id ("")
399 * fixed: initialize the statically allocated node's type ids
401 * fixed: fencepost error in math parameter counting
403 * fixed: math family numbers > 255 are allowed
405 * fixed: compilation failure on Hurd
407 * fixed: a small bug leading to displacements when reading
408   the AccentTop table
410 * fixed: \directlua followed by \pdfximage generates error if
411   draft mode is active
413 * fixed: a problem with \vadjust pre in alignments
415 * fixed: a lua stack growing problem in the backend in 0.65.0,
416   resulting in an inability to create more than a few thousand
417   generated pages
419 * fixed: inclusion of Scribus-generated pdfs
421 * adapt: the default form margin is now zero (was 1bp before)
423 * adapt: libpng 1.4.4, zzuplib 0.13.60, mplib 1.504
425 * adapt: small changes to the build system and new imports from
426   the texlive repository
428 * feature: new function node.currentattr() queries the current
429   active attribute list
431 * feature: Lua font loading; ignore unknown enumeration keys in
432   MathConstants
434 * feature: JPEG 2000 image support
436 * feature: continuing work on the 'epdf' library
438 * doc: the 'epdf' lua library is now documented
440 * doc: various other manual corrections
443 ==============================================================
444 Luatex beta-0.65.0 was released 20101213
445 ==============================================================
447 News:
449 * The Aleph and Omega version primitives are deprecated.
451 * The Apple Snow Leopard Truetype font collections now work
452   properly.
454 * Libpng has been updated to 1.4.4, and zlib to 1.2.5.
456 * New lua functions node.next() and node.prev().
458 * The already deprecated for some time node.protrusion_skipable()
459   function has been removed.
461 * fontloader.apply_featurefile() and fontloader.apply_afmfile()
462   now return nil,<errortable> on failure.
464 * The various node list fields in the lua node interface have
465   been renamed from 'list' to 'head', e.g. tex.box[0].head,
466   and the 'list' name is deprecated. For now, the deprecation
467   is silent, as 'list' will stay for quite some time. Please
468   update your lua source as soon as possible, though.
470 * The call node.type(<node>) now returns "node". The existing
471   functionality is otherwise unchanged.
473 * Luafilesystem has been updated to 1.5.0. NOTE: there is an
474   incompatible change in the directory iterator method.
476 * The restriction on linebreak_filter has been eased: at least one
477   horizontal box should be returned, but that is not necessarily
478   the last node any more.
480 * Backward compatibility has been restored for \meaning\mathchar
482 * node.first_character() has been renamed to node.first_glyph()
483   to better match its actual functionality.
485 * The \Umathaccent primitive now supports both/bottom keywords,
486   and \Umathbotaccent / \Umathaccents are now deprecated.
488 * The \Umathaccent primitive now also supports the fixed keyword,
489   which supports non-growing math accents even if the font says
490   there are extensible variants.
492 * Ongoing work on the epdf library.
494 Bugfixes:
496 * Assignment to \dimen65535 was broken earlier.
498 * <box>.head.prev is now always initialized to null (0).
500 * luatex -lua=<script> '\relax' no longer exits immediately,
501   instead going into interactive mode as it should.
503 * The \jobname was initialized wrongly for input file names
504   with multiple dots in them.
506 * The synctex file is now written in the right place when
507   --output-directory is given.
509 * \letterspacefont could cause crashes, especially when combined
510   with font expansion.
512 * Luatex would crash on linux32 systems if it was build in an
513   environment where LFS (>2GB files) was enabled by default.
515 * Node lists created by node.copy_list() could not be hyphenated
516   due to an assertion error.
518 * Synctex support was partially broken since 0.60.0.
520 * With OpenType math fonts, accents with multiple parts
521   (like the \vec arrow) forgot to include all parts if the
522   accentee was too narrow.
524 * With OpenType math fonts, accents over any class except 0 and 7
525   were misplaced.
527 * kpse.lookup("plain", {all = true}) was broken in kpathsea
528   itself (no extension given as well as --all specified).
530 * A FontForge bug made Cambria Math accents look bad, and the
531   placement of math top accents did not allow a marker at the
532   origin (patches by Stefan Philipp)
534 * Cut&Paste from PDF was sometimes broken due to bad ToUnicode map.
536 * Many small manual improvements (thanks to Paul Isambert)
538 * An other bugfix to lpeg 0.9 (from Roberto Ierusalimsky)
540 * Some small fixes to writet1.w (from Han The Thanh)
542 * A build failure because of bad libz configuration on Win32
544 ==============================================================
545 Luatex beta-0.64.0 was released 20101112
546 ==============================================================
548 News:
550 * New lua functions pdf.refobj(), pdf.maxobjnum() and pdf.objtype()
552 * New lua function node.is_node()
554 * The max_strings configuration variable's maximum value is
555   raised to be identical to texlive's maximum (2097151), and
556   same for param_size (32767).
558 * The embedded mplib is now 1.503.
560 * Minor cleanups in the output of fontloader.to_table():
562   - removed out-of-range altuni's from the output
563   - don't dump the extra encodings, just the actual font encoding
564   - export the encoding's name also as 'enc_name' at one level up
565   - no longer exporting unset macstyles, nor zero uniqueids
566   - fix creationtime and modification time
568 * Ongoing work on the epdf library
570 Bugfixes:
572 * Fix a bug where an explicit hyphen prevented hyphenation for the
573   whole rest of the paragraph
575 * Internal font copying forgot to copy the last font dimen
577 * os.selfdir() is now documented
579 * patch quad (\fontdimen6) in \letterspacefont to be compatible
580   with pdftex
582 * Multi-page pdf inclusion was very slow in 0.63.0
584 * Some extra checks added to the handling of glue_spec node
585   objects in lua code.
587 * Some node.prev pointers have been corrected (but this is not
588   quite finished).
590 * A small fix to lpeg 0.9.
593 ==============================================================
594 Luatex beta-0.63.0 was released 20100909
595 ==============================================================
597 News:
599 * Drop tex.ht[], tex.wd[], tex.dp[].
601 * Drop OCP support (and associated primitives).
603 * Add tex.catcode[], tex.lccode[], tex.sfcode[], tex.uccode[],
604   tex.mathcode[] and tex.delcode[] and associated functions.
606 * Add CIDset tables to the output pdf where appropriate.
608 * Added a 'string' field to late_lua nodes on the lua side. This
609   field does not convert the assigned string to a tokenlist.
611 * The result of fontloader.open() now has some virtual accessors
612   (as well as fontloader.to_table).
614 * There is now a `short reference' in the manual folder
615   (functionref.pdf)
617 Bugfixes:
619 * Fix a crash on an empty font (bugreport #468).
621 * Fix a crash for extremely long pattern arguments.
623 * Fix a crash on bad virtual character arguments in lua.
625 * Fix hyphenation exceptions.
627 * Prevent linebreak between initial local_par paragraph whatsit
628   and a following skip (bugreport #437).
630 * Fix placement of scripts on textstyle big operators in MATH
631   fonts (bugreport #466).
633 * Fix a crash on the return value of MPlib's 'postscript'
634   operation on images.
636 * Fix a crash on \leftghost & \rightghost in math mode.
638 ==============================================================
639 Luatex beta-0.62.0 was released 20100823
640 ==============================================================
642 News:
644 * LuaTeX now uses libpoppler (0.12.4) instead of xpdf.
646 * All backend functions now report what file they were searching
647   for whenever a file cannot be found.
649 * Input-ed lua files are now mentioned in the fls file if
650   the --recorder switch is specified on the command line.
652 * Paragraph indentation hlist nodes and hlist and vlist nodes
653   generated by alignment rows and cells now have a subtype
654   (3 for indent box, 4 for rows/columns, 5 for cells).
656 * The 'epdf' lib is in active development and still growing.
658 * The 'fontforge' table is finally removed (was deprecated
659   since 0.40).
661 Bugfixes:
663 * A new mplib import fixes two bad bugs in mplib:
664   - string equality test was wrong
665   - type declarations could delete pre-existing variables
667 * PNG images with transparency could create random size
668   differences in the generated PDF.
670 * In some special cases, font expansion could cause wrong
671   spacing in the generated PDF.
673 * \letterspacefont was broken since a very long time.
675 * The node subtype of the \leftskip and \rightskip glues was
676   wrong.
678 * Some memory leaks have been removed.
680 * Various manual fixes.
682 ==============================================================
683 Luatex beta-0.61.0 was released 20100728
684 ==============================================================
686 New features:
688 * New lua library 'epdf' for introspection of PDF inclusions,
689   see the manual for details.
691 * Mplib version 1.502 is now included (which is still beta,
692   so be careful).
694 * new "finish_pdffile" and "pre_dump" callbacks.
696 * new function pdf.pageref()
698 * In the lua 'tex' library: assignment to internal glue
699   parameters is now allowed.
701 * New lua function tex.error().
703 Bugfixes:
705 * Fix for crashes on fonts with bad Panose values.
707 * Fix for a box placement bug that could sometimes cause text
708   to overlap.
710 * Fix for a few small PDF/A1-a compatibility bugs.
712 * Fix \letterspacefont.
714 * Fix \Ustopdisplaymath in combination with aligned displays.
716 * In math delimiters, the last of a chain of predefined sizes
717   was always ignored if there were also extensible parts.
719 ==============================================================
720 Luatex beta-0.60.2 was released 20100701
721 ==============================================================
723 Bugfixes:
725 * Various small portability fixes, especially for non-gcc
726   compilers.
728 * Updated synctex from Jerome Laurens.
730 * fix bug #406: \pdfliteral hinders hyphenation.
732 * fix pdf overprinting bug (related to \pdfliteral).
734 * patch from Akira Kakuto that ensures that only absolute commands
735 that are inside the %PATH% will be executed in win32's restricted
736 \write18
738 * fix a buffer overflow in luafontloader.
740 * fix cross-platform share-ability of generated formats.
742 * fix a few typos in the manual.
744 * fix trashing of the null glue spec by attribute reference code.
746 * documented the deprecated state and brokenness of otp processing.
749 ==============================================================
750 Luatex beta-0.60.1 was released 20100428
751 ==============================================================
753 New features:
755 * renamed node.skipable() to node.skippable().
757 * More git discovery patches in getluatexsvnversion.sh.
759 * Added --warnings=[no|min|yes|max|all] option to build.sh.
761 * While cross-compiling, build.sh now adds an extra linker switch
762   to allow win32 exes to use 3G instead of 2G of virtual memory.
764 Bugfixes:
766 * os.exec() & os.spawn() handled the environment differently from
767   os.execute() on Win32 (patch from Tomek)
769 * Builds with --enable-ipc were broken.
771 * Assigning and acquiring \fontdimen s from TeX code was broken.
773 * An initial attempt at fixing bug #372 (\predisplaydirection).
775 * An attempt to fix \eqno/\leqno placements in mixed direction
776   \mathdir/\textdir.
778 * Our local xpdf patch is reverted, it is not needed any more.
780 * The os.selfdir variable was not documented, as well as broken
781   on WIN32.
783 * Fix "\input tikz hello \bye" bug, plus fix one sign error.
785 * Fix handling of lua script files with UNC names.
787 ==============================================================
788 Luatex beta-0.60.0 was released 20100404
789 ==============================================================
791 New features:
793 * os.name now knows about CYGWIN (from Elie Roux)
795 * Internal handling of direction specifiers is faster now.
797 * Each glyph node now has three new virtual read-only fields:
798   width, height, and depth (values in scaled points, of course)
800 * There are new functions node.protrusion_skipable() and
801   tex.badness() (useful for paragraph breaking in lua)
803 * Also new: tex.linebreak(). See the manual for details.
805 * All lua errors now report file and line numbers to aid in
806   debugging.
808 * Import of metapost 1.211.
810 * pdf.pdfcatalog will be replaced soon by the new pdf.catalog
811   pdf.pdfinfo will be replaced soon by the new pdf.info
812   pdf.pdfnames will be replaced soon by the new pdf.names
813   pdf.pdftrailer will be replaced soon by the new pdf.trailer
815 * pdf.pdfmapfile and pdf.pdfmapline are replaced by the new
816   pdf.mapfile() and pdf.mapline() functions. (a function interface
817   fits these parameters better because they never return anything).
819 * New read-write lua variables: pdf.pageattributes, pdf.pageresources,
820   pdf.pagesresources
822 * getluatexsvnversion.sh now correctly detects git-svn and still
823   manages to find a valid SVN revision number (from Patrick Gundlach)
825 * Many of the source files have been converted to CWEB.
827 Bug fixes:
829 * GNU libtool is now used to solve the various technical issues with
830   dynamic loading of lua modules.
832 * Error detection in scan_integer_part was wrong due to missing
833   initialization of OK_so_far (spotted by Javier Mugica)
835 * Synctex was broken in 0.51-0.52.
837 * \lastlinefit was broken since ... well, nearly forever.
839 * Reading of binary files with length zero was broken.
841 * Trapping of unitialized rules (this was for sloppily created
842   rule nodes from lua)
844 * pdf.immediateobj('streamfile') was broken on 64-bit platforms.
846 * tex.linebreak did not take the given left and right skip, but
847   instead used the current TeX-side values (bug #356).
849 * the found 'MAKE' command in build.sh is now fed into configure to fix
850   problems with that not finding GNU make even when it is actually
851   installed.
853 * dofile(<nil>) and loadfile(<nil>) in batch mode now give an
854   error and continue instead of pointlessly waiting for user input.
856 * Reverted commit #3417 (the buildpage experiment) as it causes bad
857   things to happen when items are waiting during page breaks.
859 * Overrule loaders[4] in --safer mode, make require() behave
860   closer to normal lua 5.1, and add some nicer error messages
861   (based on an email and patches from Manuel Pegourie-Gonnard)
863 * Added an extra sanity check for GDEF loading in luafontloader,
864   based on a crash caused by Linux' AkaashNormal.ttf.
867 ==============================================================
868 Luatex beta-0.52.0 was released 20100316
869 ==============================================================
871 New features:
873 * Various small manual improvements.
875 * A better version of getluatexsvnversion.sh, from Tomek.
877 * node.copy_list() now allows the second (optional) argument to
878   be nil.
880 * An import of the current state of the texlive repository
881   (kpathsea and build system).
883 Bug fixes:
885 * An attempt fix for bug #345 (math kerning is not perfect): when the
886   current math font is a new math font, check against \catcode <cur_c>
887   == 11 to suppress the italic correction, instead of looking at
888   the value of space(<cur_f>).
890 * There is a new <tfmtable> key: 'units_per_em' (defaults to 0).
891   This is part of a fix for bug #200 (Problem with CFF fonts having
892   em-size other than 1000): there is a special correction to the
893   embedded cff font itself and the font scale if the font to be output
894   is opentype or type1 in unicode encoding and the 'units_per_em
895   differs' from zero.
896   <tfmtable>.units_per_em has to be passed back to luatex from
897   the lua font loading code for this to work.
899 * A fix for bug #314 (problem with pk file).
901 * lua code can no longer change the internal preallocated glue_spec
902   nodes (as that resulted in weird spacing bugs). For this, glue_specs
903   now have a new field: 'writable'. If that field is false, a copy
904   has to be made of the glue_spec instead of doing an assignment
905   to it.
907 * Setting of \textdir inside the output routine could trash output
908   on following pages due to a lingering internal variable.
910 * \pdfthread crashed because the arguments were handled in reverse
911   order.
913 ==============================================================
914 Luatex beta-0.51.0 was released 20100312
915 ==============================================================
917 New features:
919 * Various small manual improvements.
920 * The backend message "cannot open Type 1 font file for reading"
921   now reports which Type1 font it was looking for.
922 * Fontforge clears some font names at loading time that will be
923   refilled in at font generation time, but the fontloader should not
924   do that. Patch from Khaled Hosny.
925 * New synctex code imported from TeXLive.
926 * luamd5/md5.h is renamed to luamd5/luamd5.h to avoid confusion.
927 * Embedded mplib is now 1.209.
928 * Some experimental tweaking of buildpage_filter, see the manual
929   for details.
930 * Luatex now detects kfreebsd (from Alan Braslau)
931 * The new lua function tex.sp() converts a string to a number
932   representing scaled points.
933 * There is now support for revision numbers in the banner and stats
934   library again.
935 * The command line help and manual documentation page is extended.
936 * node.hpack() now also accepts "cal_expand_ratio" and "subst_ex_font"
937   modifiers.
938 * node.hpack() and node.vpack() now give back the badness of the box
939   as second return value.
940 * node.copy_list() now allows a second (stop) argument, this stopper
941   is not copied.
942 * new lua functions in lfs: lfs.readlink() and lfs.shortname().
943 * new lua function tex.tprint() that can combine multiple catcode
944   regime prints in one function call.
945 * new lua sub-table: tex.nest[] (read/write access to the semantic
946   nest state).
947 * New lua functions in kpse: kpse.lookup() and kpse.version(). See
948   the manual for more details.
949 * New lua function tex.shipout().
951 Bug fixes:
953 * There problems in the pdf output for Type3 (pk) fonts.
954 * Fix a bug that allowed bad commandline quoting.
955 * Fix a bug that sometimes caused crashes when \pdfprotrudechars.
956 * The build script now exports CONFIG_SHELL to avoid problems with
957   /bin/dash.
958 * The was a bug in the generated /Image /ProcSet.
959 * status.font_bytes reported the wrong value.
960 * Lots of compiler warnings are removed (thanks Javier Mugica).
961 * Patch to fontloader.info() to accept filenames with embedded
962   parentheses.
963 * Fix a \write error with docstrip package.
964 * Fixed a crash on AdobeMyungjoStd-Medium.otf.
965 * Fix coco stack overflows, needed for lpeg.
966 * \pdfcompresslevel wasn't initialized for early immediate objects.
967 * Fix for slanted fonts when HZ was on (slant angle was multiplied).
968 * When concatenating content streams, put a space between them.
969 * Allow pfb lines to end with \r as well as \n (for msam10.pfb).
970 * Fix the internal string->scaled point conversion in the lua
971   interface.
972 * Memory leaks in the fontloader removed, thanks to patches from
973   Elie Roux.
974 * Fix a crash caused by the combination of coroutines and font.each().
976 Removed features:
978 * Support for Type3 .pgc files (nobody used them).
980 ==============================================================
981 Luatex beta-0.50.0 was released 20091224
982 ==============================================================
984 New features:
986 * Fonts now listen also to the 'extend' key in the lua font
987   metrics table, and the processing for this is done via de
988   pdf text matrix instead of via the font matrix, which means
989   it now works for all font types.
991 * The embedded Metapost library is now at version 1.209.
993 Dropped features:
995 * It is no longer possible for fonts from embedded pdf files
996   to be replaced by / merged with the document fonts of the
997   enveloping pdf. This regression may be temporary, depending
998   on how the rewritten font backend will look after beta 0.60.
1000 Bug fixes:
1002 * Use of \middle confused the \mathstyle operation.
1004 * \pdfcolorstack handling was broken.
1006 * node.unset_attribute() had a bug whereby it inverted the
1007   requested result in some cases (the node on which the unset
1008   was called was sometimes the only node at the current level
1009   that *kept* the attribute).
1011 * During font expansion, the internal font copy had one character
1012   information object less than the original, resulting in the
1013   disappearance of a glyph in some fonts when font expansion
1014   was active.
1016 * Placement of operator scripts of OT MATH fonts is adjusted
1017   to be conformant with Word's logic where the italic correction
1018   is only used to tuck in the subscript and for nothing else.
1020 * luafontloader.open() no longer writes directly to stderr in
1021   case of internal font errors.
1023 * Any <pdf_refobj_node>.objnum could not be assigned to.
1025 * The lua 'pdf' table could not be assigned to.
1027 * The lua 'md5' library was returning incorrect results on
1028   64-bit architectures.
1030 * Luatex now compiles on GNU Hurd systems.
1032 * Fix segfault when embedding stream file object (these
1033   backend segfaults were a side-effect of the string pool
1034   patches).
1036 ==============================================================
1037 Luatex beta-0.47.0 was released 20091218
1038 ==============================================================
1040 New features:
1042 * New read-write lua variables pdf.pdfcatalog, pdf.pdfnames,
1043   pdf.pdfinfo, pdf.pdftrailer
1045 * The horizontal mode nodes that are added to lines during line
1046   breaking now inherit the attributes from the first and last node
1047   inside the created line.
1049 * The new function pdf.registerannot(<number>) registers an
1050   annotation object number to be included in the current
1051   page's /Annots list.
1053 * The variables <metrics>.Mathconstants.FractionDelimiterSize
1054   and <metrics>.Mathconstants.FractionDelimiterDisplayStyleSize
1055   are added to the font table. This allows proper setting of the
1056   size parameters for TeX's ...withdelims math primitives.
1058 * The internal representation of the string pool is reorganized
1059   (the pool of string characters is now allocated dynamically),
1060   and as a side-effect the lua variable status.init_pool_ptr
1061   is deprecated and will be removed in a later version. Also,
1062   status.pool_ptr now simply returns the current number of bytes
1063   in use for string characters.
1065 * There are new lua variables pdf.pdfmapline and pdf.pdfmapfile
1066   (write-only strings that mimic \pdfmapline and \pdfmapfile).
1068 * \pdfobj data and attribute are now stored as C strings instead
1069   of as token lists (this should speed up cases with a lot of data).
1071 * Artificially slanted fonts now work via the pdf text matrix
1072   (instead of adjusting the actual font) so that it now also
1073   works for non-Type1 fonts. The lua <metrics>.slant font key is
1074   now obeyed in all cases.
1076 * The lua function font.id(<string>) returns the internal font id
1077   number belonging to a control sequence name.
1079 * Pdf image inclusion is optimized such that objects from an
1080   external pdf will now be included only once even if they are
1081   referenced from multiple inclusions.
1083 Bug fixes:
1085 * Protrusion for non-TLT documents did not work properly for
1086   the hyphenation character.
1088 * \lastbox could not remove the paragraph indent box for non-TLT
1089   documents.
1091 * Pdf images (\pdfximage) are no longer kept open during the
1092   whole run, but closed and reopened. An error is raised if
1093   the file has changed between \pdfximage and \pdfrefximage.
1094   This prevents the 'too many open files' error when lots of
1095   images are included.
1097 * On Win32 Pdf image files are locked during the time that it is
1098   open, to prevent unnoticed file changes by external sources.
1100 * Compilation now again works on FreeBSD.
1102 * Format sharing between 32-bit and 64-bit architectures was
1103   broken.
1105 * Unsetting attributes from lua could sometimes result in
1106   the unset state persisting beyond the current group level.
1108 * If something went wrong in the scanning of pdf action items,
1109   the error message reported the current primitive name
1110   incorrectly.
1112 * Luatex would crash on non-existant pdfs that were referenced
1113   from map file entries.
1115 ==============================================================
1116 Luatex beta-0.46.0 was released 20091126
1117 ==============================================================
1119 New features:
1121 * The build.sh script now has better support for new MacOSX-es
1122   (patch from Mojca).
1124 * Luatex now has experimental support for dynamic loading of
1125   external compiled lua libraries. Building luatex and loading
1126   external .so/.dll files is reported to work on Windows,
1127   linux and osx, other platforms are still unknown.
1129 * pdf.obj{type="stream"} no longer converts its argument to and
1130   from a tokenlist. This allows the use of binary data in the
1131   "string" argument. Such data does still have to hidden from
1132   the normal file parser by putting the code in a dofile()
1133   or by using string.char(), though.
1135 Bug fixes:
1137 * Luatex 0.45.0 was not able to find truetype nor opentype fonts
1138   if there were no callbacks defined (patch from Pawel).
1140 * 0.45.0 printed the user input instead of the full pathname
1141   for \input-ed tex files.
1143 * The TFM reader now rejects fonts with tfm names that are
1144   longer than 255 characters because such font names cannot
1145   be stored in a DVI file.
1147 * The combination of \immediate\pdfxform followed by a later
1148   \pdfrefxform could cause broken pdf output files because
1149   the box used for the form could have been freed and even
1150   reused already at that moment in time, sometimes resulting
1151   in an invalid transformation matrix.
1153 * The placement of super- and subscripts for displaystyle
1154   \int's in CambriaMath is now better than before. It still
1155   needs a tweak to the metrics though: in the current version,
1156   the italic correction has to be substracted from the width
1157   of the integral sign to get correct placement (context mkiv
1158   does this).  to be continued ...
1160 ==============================================================
1161 Luatex beta-0.45.0 was released 20091118
1162 ==============================================================
1164 New features:
1166 * Loading big OTF fonts via lua is now much faster than before,
1167   at the expense of a bit of precision loss in the calculated
1168   bounding boxes.
1170 * Two new token lists are provided: \pdfxformresources and
1171   \pdfxformattr, as an alternative to \pdfxform keywords.
1173 * \input and \openin now accept braced filenames.
1175 * The \endlinechar can now be set to any value between 0 and 127.
1177 * Luatex can now optionally use kpathsea to find lua require()
1178   files.
1180 * The new primitives \aligntab and \alignmark are aliases for
1181   the use of & and # in alignments.
1183 * \pdfrefximage [width <dimen>] [height <dimen>] [depth <dimen>] <imageref>
1184   overrules settings from \pdfximage for this \pdfrefximage call only
1186 * The print precision for small numbers in lua code (tostring)
1187   has been improved.
1189 * Akira Kakuto suppled a patch that restricts writing to files
1190   with names such as latex.bat etc. (on windows only)
1192 * (un-feature): from now on luatex now only handles 4 direction
1193   specifiers: TLT (latin), TRT (arabic), RTT (cjk), and LTL
1194   (mongolian). The other directions now generate an error.
1196 * (un-feature): xpdf's automatic lower- and uppercasing retry attempts
1197   for nonfound image pdf files has been removed.
1199 * The callbacks hpack_filter, vpack_filter and pre_output_filter
1200   pass on an extra string argument for the direction, when known
1201   (nil == use default).
1203 * The lua functions node.hpack(), node.vpack() and node.dimensions()
1204   now accept an optional direction argument (not given == use default).
1206 * \pdfrefxform [width <dimen>] [height <dimen>] [depth <dimen>] <formref>
1207   scales a form object; similar principle as with \pdfximage: depth alone
1208   doesn't scale, it shifts vertically.
1210 * A change to the relative ordering inside font name discovery for use
1211   by the backend: now it tries <f>.psname first, as that is much less
1212   likely to contain spaces.
1214 * For ttc fonts, now the used subfont name and its index id are printed
1215   to the terminal, and if the backend cannot find a ttc subfont, the
1216   run is aborted.
1218 Bug fixes:
1220 * Prevent crashes for lua-loaded fonts without a (tfm) name.
1222 * Remove spurious newlines in the output pdf that could be the
1223   result of using \pdfximage for an included pdf figure too early.
1225 * Full font embedding for wide otf and ttf fonts now really
1226   works (older versions only pretended that it did work).
1228 * node.dimensions() sometimes continued past the 'stop' node.
1230 * Images inside virtual fonts were broken.
1232 * The processing of \language=-1 was wrong, resulting in
1233   hyphenation attempts even though there was no proper language
1234   set up.
1236 * Fix for finding files in --output-directory.
1238 * Fix for handling of --file-line-error.
1240 * tex.box[] assingments are now checked to make sure the assigned
1241   node has the right id (hlist or vlist).
1243 * show_node_list (as in \showbox) produced spurious local_par
1244   whatsit prints in the output after direction nodes.
1246 * The handling of pdf literals has been sped up.
1248 ==============================================================
1249 Luatex beta-0.44.0 was released 20091027
1250 ==============================================================
1252 New features:
1254 * libpng is now 1.2.40.
1256 * hlist nodes now have a subtype to distinguish hlists generated
1257   by the paragraph breaking, explicit \hbox commands, and other
1258   (as-yet-undefined) sources.
1260 * \pdfobj now has an extra optional keyword: 'uncompressed',
1261   which forces the object to be written to the PDF in plain
1262   text (see the manual for the exact details).
1264 * The lua file from the luamd5 library (which provides the
1265   md5.hexsuma() function) is now embedded in the executable.
1267 Bug fixes:
1269 * \latelua now works in DVI mode again.
1271 * status.output_file_name could crash when used too soon.
1273 * In 0.43, rules were not output at all in DVI mode.
1275 * \leavevmode\penalty-10000\penalty-10000 crashed luatex.
1277 * the API of margin kern nodes to lua was using the wrong
1278   fields in the nodes.
1280 * A few fixes to the manual.
1282 * PDF Xref stream dicts were slightly non-conformant.
1284 * There was too much space between two consecutive math displays
1285   (this bug was inherited from Aleph)
1287 * Synctex was broken (thanks, Akira)
1289 * Font mark classes were handled incorrectly by the fontloader
1290   code.
1292 * There was a crash possible with certain types of named PDF
1293   destinations.
1295 * Math delimiters and large operators in new MATH fonts no
1296   longer apply the italic correction (this fixes placements
1297   of super- and subscripts on such items for those fonts).
1299 * The converter from lua strings to token lists (for the node
1300   interface) sometimes generated invalid tokens.
1302 * CFF (OpenType) fonts now listen to 'embedding="full"'. TTF
1303   is still todo.
1305 * Font tables with 'embedding="no"' would cause luatex to crash.
1307 * \pdfobj file {} failed to find the file if there was no lua
1308   callback in place.
1310 * An optimization in MS Mincho caused luatex to crash.
1312 ==============================================================
1313 Luatex beta-0.43.0 was released 20090819
1314 ==============================================================
1316 New features:
1318 * There is a new allowed key in the table trhat is returned
1319   by lua-loaded fonts: <f>.psname. This value should be set
1320   to the original PostScript font name of the font. Fonts inside
1321   dfont and ttc collections are fetched using this field
1322   (if it is missing, <f>.fullname will be used instead).
1324 * It is now possible to use Apple dfont font files
1325   (those that contain at least one outline font).
1327 * \latelua is now allowed inside leaders.
1329 * There is a new callback: process_output_buffer, from Manuel
1330   Pégourié-Gonnard. This callback is called just before
1331   \write acts, so it can be used to alter the file encoding
1332   of text output files.
1334 * There is a new node.dimensions() function, which calculates
1335   the natural size of (part of) a list of nodes.
1337 * The new primitive \gleaders provides 'globally aligned'
1338   leaders.
1340 * The DVI and PDF backends now share much code internally.
1342 * The embedded MPlib is now 1.207.
1344 * libpng is now 1.2.39.
1346 Bugfixes:
1348 * We fixed lots of anonymous bugs introduced in 0.42.0 (as expected)
1350 * fontloader.info() errors are no longer fatal, the function now
1351   just returns a nil,"error string" pair.
1353 * Automatically inserted kerns for \accents are now once again
1354   valid word ends, as in \TEX.
1356 * Fixed the placement of math displays in mixed direction
1357   settings.
1359 * The \pdfcompresslevel is now dynamic again.
1361 ==============================================================
1362 Luatex beta-0.42.0 was released 20090717
1363 ==============================================================
1365 * There is a new node.tail() function
1367 * lua-loaded fonts now support a 'nomath' key to speed up
1368   loading the lua table.
1370 * A bugfix in the ttf reader for the inclusion backend, and
1371   (also in the backend) support for treating ttc files by
1372   pretending they are single ttf fonts (both patches from pdftex)
1374 * Add Khaled Hosny's man page to the repository
1376 * The \pdfcompresslevel is now effectively fixed as soon as
1377   output to the pdf file has occurred.
1379 * Patched status.filename so that it (nearly) always returns a
1380   file name.
1382 * fix '\the\delcode' and disable '\the\odelcode', '\the\Udelcode',
1383   and '\the\Udelcodenum'
1385 * Handle jfifs where either xres or yres is 0 and the other
1386   res is != 0 (from pdftex)
1388 * The single-argument version of lang.hyphenate() was broken.
1390 * Get rid of the \directlua/\latelua number warning.
1392 * The Lua coroutine patch (coco) is now disabled on linux
1393   powerpc architectures (because it caused crashes)
1395 * Removed obsolete pdftex primitives:
1396   \pdfoptionalwaysusepdfpagebox
1397   \pdfoptionpdfinclusionerrorlevel
1398   \pdfforcepagebox
1399   \pdfmovechars
1401 * The loading speed of large fonts (especially ttf) via the
1402   fontloader library, and the inclusion speed for subsetting
1403   in the backend have both been improved.
1405 * The 'pdf' lua library has been enhanced with various new
1406   functions, see the manual for details.
1408 * BLT and BRT glyph position fixed.
1410 * Various fixes for synctex offsets.
1412 * Support for exotic font string encodings has been removed
1413   from the fontloader library.
1415 * The embedded MPlib is now 1.205.
1417 * libpng is now 1.2.38.
1419 ==============================================================
1420 Luatex beta-0.40.6 was released 20090625
1421 ==============================================================
1423 * Fix two string vs. toks bugs in the lua node interface:
1424   whatsit,annot and whatsit,startlink data assignments were
1425   made directly as strings instead of being converted to tokens.
1427 * Sometimes pdf.print() could be used before the proper structures
1428   were initialized.
1430 * There was a bug in the type codes for the lua package filter
1431   callback: wrong extra info was passed to lua for the alignment
1432   and vsplit cases.
1434 * The math parameters \Umathlimitdownvgap, \Umathlimitdownbgap,
1435   and \Umathlimitdownkern have been renamed to \Umathlimitbelowbgap,
1436   \Umathlimitbelowvgap, and \Umathlimitbelowkern to be more
1437   consistent with the other parameter names.
1439 * The embedded MPlib is now 1.204.
1441 * Handling of UTF-8 hyphenation exceptions has been fixed.
1443 * There were a number of typos in the manual.
1445 ==============================================================
1446 Luatex beta-0.40.5 was released 20090610
1447 ==============================================================
1449 * One of the internal print functions accidentally encoded its
1450   argument string to UTF-8 even though it was already UTF-8.
1452 * Some of the log and terminal UTF-8 output was gibberish.
1454 ==============================================================
1455 Luatex beta-0.40.4 was released 20090609
1456 ==============================================================
1458 * \the\textfont0 returned a number instead of doing a font
1459   switch.
1461 * The embedded MPlib is now 1.203.
1463 ==============================================================
1464 Luatex beta-0.40.3 was released 20090608
1465 ==============================================================
1467 * A set of portability fixes for the AIX compiler from Vladimir
1468   Volovich.
1470 * A set of fixes to the synctex support.
1472 * A patch to the build script to prevent installed X11 headers
1473   from being required.
1475 * Some weave (web syntax) fixes from Manuel Pégourié-Gonnard.
1477 * A simplification in luatex.ch (it is now less verbose
1478   about the web2c-specific extensions) from Karl Berry.
1480 * A fix in the handling of UTF-8 (input) file names.
1482 * Hyphenation exceptions were case sensitive in 0.40.2.
1484 * libpng is now 1.2.37.
1486 ==============================================================
1487 Luatex beta-0.40.2 was released 20090603
1488 ==============================================================
1490 * Fix for a compilation warning under Cygwin.
1492 * A complicated bugfix by Hartmut for a rounding problem in the
1493   VF loading that resulted in 'character width mismatch in font
1494   XY.vf ignored' messages at large load sizes
1496 * The embedded MPlib is now 1.202.
1498 * The post_page_number callback was accidentally run when
1499   shipping out xforms as well as during actual pages.
1501 * When a math accent char doesn't have a bot_accent placer,
1502   luatex now uses the top_accent placer, if present.
1504 * A crash caused by \Uroot .. {<list>}{...} is fixed
1506 * A portability fix for solaris 8 sparc using sun studio
1507   compiler, and one for glibc > 2.9.90
1509 * luatex -ini now sets the \catcode of the BOM character to
1510   ignore
1512 * Kpathsea is updated from TeXLive, giving four extra types of
1513   searchable files: 'font feature files','cid maps','mlbib',
1514   and 'mlbst'.
1516 * libpng is now 1.2.36
1518 ==============================================================
1519 Luatex beta-0.40.1 was released 20090508
1520 ==============================================================
1522 * Vertical placement of root radicals and degrees is fixed.
1524 * The use of \pageleftoffset could deviate from \hoffset
1525   if \mag != 1000.
1527 * LuaTeX now issues a warning if \pagedir !- \bodydir during
1528   shipout.
1530 * The previous crash in font.read_tfm() was still not quite
1531   correct.
1533 * The Web2C version is now also printed in the --version
1534   and --credits output.
1537 * There is a new MPlib 1.200 release candidate with a few minor
1538   fixes included.
1540 * The xpdf library is updated to patch level 3.
1542 * New imports to the build system, from texlive. In particular,
1543   there is now configure-level support for building with
1544   libpoppler and support for building under cygwin 1.7 is added.
1546 ==============================================================
1547 Luatex beta-0.40.0 was released 20090422
1548 ==============================================================
1550 * The embedded MPlib is updated to version 1.200.
1552 * Texlua would crash if run font.read_tfm() was used.
1554 * Luatex would crash on empty \patterns.
1556 * Lots of small C code cleanups.
1558 * \textdir inside a \hbox dir *** was wrong earlier.
1560 * 0.39.0 introduced a bug that would make luatex crash whenever
1561   font expansion was used.
1563 * Font tables returned by define_font can now have a key named
1564   'cache' that controls the internal lua font table caching.
1566 * There is no longer a need for an explicit --progname if there
1567   is no input file given.
1569 ==============================================================
1570 Luatex beta-0.39.0 was released 20090415
1571 ==============================================================
1573 * iniluatex will from now on start up with only the TeX82 primitives
1574   and \directlua, everything else has to be bootstrapped via
1575   tex.enableprimitives(). This change was planned for 0.40.0,
1576   but *now* is the time to test it.
1578 * A bugfix for \primitive in various expandable contexts,
1579   and \primitive now generates an error message when the
1580   argument is not actually a primitive's name.
1582 * There was a bug found in the math accent handling.
1584 * Large math operators are now treated like extensible characters
1585   in the sense that they can be composed of segments.
1587 * The extra assign- and restore tracing information from eTeX
1588   had a massive bug because of a dangling else in the pascal web.
1589   As a side-effect of fixing this bugs, all such potential errors
1590   in the pascal web have been fixed (for now).
1592 * The math parameters can now be set and queried from lua code
1593   via the new tex.setmath() and tex.getmath() functions.
1595 * Reflection in a \hbox was broken.
1597 * There was a leak of direction nodes in the paragraph builder.
1599 * The font backend now does a small peek to differentiate
1600   truetype and postscript style opentype fonts. This fixes
1601   the "Can't find CFF table" bug for otf's with truetype outlines.
1603 * Parameters and registers can now also be assinged to globally
1604   from lua (see the manual for details).
1606 * It is now possible to query the current math style while a
1607   formula is still being constructed by using the new read-only
1608   value \mathstyle. Associated is the new command \Ustack that
1609   is to be used as a prefix for {.. \over ..} and friends.
1610   See the manual for more information.
1612 * The embedded MPLib is brought up to date with the current
1613   metapost repository (version 1.110 and a few small patches).
1615 * Luatex can now handle two breakpoints inside a single ligature
1616   (like for the functional word of-f-ice). The solution is not
1617   perfect yet, but the chance of missed hyphenation points in
1618   actual documents should now be negligible.
1620 * Some speedups in the font loading code, and in the handling of
1621   pdf_literal nodes that are set from within Lua code.
1623 * Some source code and manual cleanup, as usual.
1625 ==============================================================
1626 Luatex beta-0.38.0 was released 20090410
1627 ==============================================================
1629 * tex.enableprimitives() had a bug were previously defined (but
1630   currently undefined) control sequences prevented the creation
1631   of the new csname.
1633 * The special calling format callback.register('name', false)
1634   not only disables the callback, but also the builtin code it
1635   is supposed to replace.
1637 * Empty \localleftbox and \localrightbox -es are now suppressed.
1639 * Support for <f>.MathConstants.SubscriptShiftDownWithSuperscript
1640   was added, to solve the lack of "sub2" in OpenType math.
1642 * Luatex now supports horizontal super- and subscript placement
1643   corrections via the OpenType MATH mathkern table. See the
1644   manual for details.
1646 * node.write() no longer copies its argument node list before
1647   appending it.
1649 * There are six new primitives that are verbose forms
1650   of one and two byte special tokens:
1651   \Usuperscript \Usubscript
1652   \Ustartmath \Ustopmath
1653   \Ustartdisplaymath \Ustopdisplaymath
1655 * The attribute node leaks in math mode and alignmetns have been
1656   fixed.
1658 * The 11 simple math noads are now combined into a single "noad"
1659   node type.
1661 * Static linking against libstdc++ is working once again.
1663 * There is a small fix in the keyword scanner to solve the
1664   problem of 'Runaway ... while scanning ???' that could happen
1665   for some primitives.
1667 * Lua now also has the "architecture independent bytecode"
1668   patch applied.
1670 * Lua is updated to version 5.1.4 with coco patches 1.1.5, and
1671   lpeg is now 0.9.
1673 * Some TRT/TLT backend bugs are fixed.
1675 * Various manual updates.
1677 ==============================================================
1678 Luatex beta-0.37.0 was released 20090331
1679 ==============================================================
1681 * Luatex now implements shell_escape = 'p', a new feature
1682   in web2c that intends to make \write18 more secure. As
1683   a side-effect, if luatex is used for typesetting, it will
1684   now also apply shell_escape = 'p' and shell_escape = 'f'
1685   to the lua functions io.popen(), os.execute(), os.exec(),
1686   and os.spawn().
1687   Nothing has changed for the case where luatex is used as
1688   a script interpreter.
1690 * Attributes can now have negative values. The special value
1691   for 'unset' is lowered to -0x7FFFFFFF (it used to be -1).
1693 * The lua 'kpse' library now has an object-oriented interface
1694   as companion to the procedural interface. This is useful for
1695   e.g. controlling the discovery of mplib files.
1697 * The new internal integer parameter \outputbox allows setting
1698   of the output box number (default: 255, max: 65535)
1700 * The new primitives \Udelimiterunder and \Udelimiterover
1701   complete the set of 'StretchStacks' for OpenType Math.
1703 * Fixed a bug in font string conversions on the Macintosh that
1704   resulted in warnings about 'unaligned pointers being freed'.
1706 * Khaled Hosny spotted a bunch of manual errors.
1708 * There was bug in the width of math_accent objects when
1709   there were super- or subscripts attached to the accentee.
1711 * In PDF mode, TRT \leaders were bugged.
1713 * The source tree now uses the new texlive build system that
1714   Peter Breitenlohner created.
1716 * There is now a single build.sh instead of four separate
1717   ones. It has a few options:
1718       --make      : only make, no make distclean; configure
1719       --parallel  : make -j 2 -l 3.0
1720       --nostrip   : do not strip binary
1721       --mingw     : crosscompile for mingw32 from i386-linux
1722       --ppc       : crosscompile for ppc osx on intel osx
1724   Note: --parallel still sometimes causes crashes due to
1725   timing errors, so use that option with care.
1727 * Many compiler warnings have been removed (but not all yet).
1729 ==============================================================
1730 Luatex beta-0.36.0 was released 20090323
1731 ==============================================================
1733 * The included fontforge code is stripped considerably, and
1734   the lua table to access the code is renamed to 'fontloader'.
1735   The old name ('fontforge') will remain present for a while,
1736   but will eventually go away.
1738 * New lua functions: tex.primitives(), tex.extraprimitives,
1739   tex.enableprimitives().  This is a prelude to a big change
1740   in the next beta: iniluatex will from now on start up with
1741   only the TeX82 primitives and \directlua, everything else
1742   has to be bootstrapped via tex.enableprimitives().
1743   See the manual for more details.
1745 * Support for multiple lua states has been removed, and at the
1746   same time support for adding name ids to lua chunks has been
1747   added.  See the manual for more details.
1749 * More changes to the PDF backend to make it support non-latin
1750   directions (form and image placement, vertical typesetting,
1751   synctex).
1753 * The kpathsea library is updated. Highlights: cleaner build
1754   process (thanks to Peter Breitenlohner), cleaner mingw32
1755   (cross)compilation support, and a new reentrant API.
1757 * Some possible endless loops within extended delimiters in
1758   math mode are now trapped.
1760 * Movements inside VF font characters were considerably off
1761   due to a wrong conversion routine.
1763 * Error handling for \outer has been reinstated, but can be
1764   suppressed via the new primitive \suppressoutererror.
1766 * The new primitives: \suppresslongerror and \suppressifcsnameerror
1767   that can be used to suppress errors for \par in non-long macros
1768   and for non-expandable objects inside \ifcsname ... \endcsname,
1769   respectively.
1771 * New lua function: node.vpack() via a patch from Khaled Hosny
1772   that also improves error handling in node.hpack().
1774 * Fix the typo that caused \charic (instead of \charit)
1775   to be defined as a primitive.
1777 * Suppression of hyphenation via \hyphenchar\font=-1 now works
1778   again.
1780 * The lua functions tex.print(), tex.sprint(), tex.write() now
1781   accept an array of strings as well as vararg list of strings
1782   to print.
1784 * A change to be build process: luatex.p is no longer split
1785   int smaller pieces before running the C compiler.
1787 * Melissa O'Neill contributed a bugfix to the Type1 font
1788   subsetting code.
1790 * A bunch of smaller bugfixes and cleanups (as usual).
1792 ==============================================================
1793 Luatex beta-0.35.0 was released 20090224
1794 ==============================================================
1796 * The math handling portions of LuaTeX are converted to C code,
1797   and extended to support Unicode math. There are a great many
1798   related changes, see the new Math chapter in the manual for
1799   details.
1801 * A nasty bug in the paragraph breaking routine was fixed.
1802   (All lines except the first one were believed to be wider then
1803   they really were. This affected which nodes were considered
1804   as active breakpoints)
1806 * Various changes to the PDF backend to make it support non-latin
1807   directions.
1809 * Fixed the behaviour of the page offsets. Placement of the output
1810   on the physical page should now work correctly in all directions,
1811   both in DVI and PDF.
1812   There now are \pageleftoffset and \pagetopoffset primitives,
1813   as well as
1815 * fontforge.apply_featurefile() was broken since 0.31.0
1817 * The lua profiler library is added.
1819 * The included lua filesystem library is now 1.4.1.
1821 * Reading of pk files fixed.
1823 * An optional space afer a <direction specifier> for \textdir c.s.
1824   is ignored from  now on.
1826 * \bodydir and \pagedir can now be (re)set even after the first
1827   page has been output.
1829 * The new callback mlist_to_hlist can be used to intercept the
1830   normal conversion of math lists to horizontal lists.
1832 * The programs ttf2afm and pdftosrc are removed from the luatex
1833   distribution (these belong to pdftex).
1835 * fontforge.open() now uses much less memory when opening large
1836   (CJK) fonts.
1838 * The included libpng is now 1.2.35.
1840 * Quite a lot of smaller bugfixes and cleanups (as usual).
1843 ==============================================================
1844 Luatex beta-0.31.3 was released 20081229
1845 ==============================================================
1847 This release has a bunch of updates from the development trunk
1848 (#1657-1670,1677,1678,1680,1685,1687).
1850   * Closing of files opened by \externalocp.
1852   * Fix for a locale-related bug that make PDF generation fail
1853     with a "Parsing CFF Dict failed" message when including
1854     opentype fonts.
1856   * The included metapost is now version 1.102.
1858   * PDF rules in vertical modes in RL direction where output
1859     in the wrong direction
1861   * Fix for a crash on Apple fonts that contain a 'bsln' table.
1863   * The handling of the second argument to fontforge.open() was
1864     broken
1866   * The included libpng is now 1.2.34
1868   * Handling of ttc files on Windows was broken
1871 ==============================================================
1872 Luatex beta-0.31.2 was released 20081209
1873 ==============================================================
1875 Besides fixing building issues, this release has
1877   * A small fix for a crash that could happen when using
1878     external OCPs.
1880   * A fix in the format of fontforge.to_table output.
1881     (In 0.31.1 <font>.lookups was near-empty; the lookups
1882     were accidentally output as part of the gpos table).
1884 ==============================================================
1885 Luatex beta-0.31.1 was released 20081209
1886 ==============================================================
1888 fixed a bunch of compilation errors on various platforms, but
1889 with no other visible changes.
1892 ==============================================================
1893 Luatex beta-0.31.0 was released 20081205
1894 ==============================================================
1896 This is just an intermediate release so that some testing can be
1897 done on the updated fontforge embedding.
1899 * There are new fields being generated by fontforge.to_table(),
1900   and one or two old ones have been removed. These fields are /
1901   will be documented in the manual, but very briefly:
1903   - MATH table and associated information are now exported
1904     (the main reason for the new fontforge code)
1905   - Baseline data is now exported
1906     (perhaps usable in lua code)
1907   - Multiple Master / Glyph variation data is now exported
1908     (but useless, for now)
1909   - Mac Feature (AAT) information is now exported
1910     (perhaps usable in lua code)
1911   - If (lookup) names were saved via the PfED table, these
1912     will the exported instead of the default, generated names.
1913     (as requested by Yannis)
1915 * dfont is now treated as an archive format just like ttc
1916   when it comes to fontforge.info(). NOTE: that does not mean you
1917   can actually use them, because the  backend doesn't know
1918   yet how to embed dfont fonts in the PDF, that is on the
1919   TODO list for the next big beta (0.40.0).
1921 * The executables are a lot larger than before. That is because
1922   much more of fontforge is included than before. Likely this
1923   will stay this way, because this makes upgrading the ff code
1924   much easier, and it means that luatex/FF potentially
1925   understands more font formats (after upgrading the backend,
1926   of course)
1929 ==============================================================
1930 Luatex beta-0.30.3 was released 20081128
1931 ==============================================================
1933 This release fixes a really big bug, a few smaller ones,
1934 and has updates of png and mplib:
1936 * All hyphenation patterns that were anchored at the start or
1937   end of a word were ignored in luatex versions 0.25.X and 0.30.X
1938   (and possibly even earlier).
1940 * Repeated use of \language=-1 could result in "There is not room
1941   for another language".
1943 * The lua true coroutines patch (Coco) is now disabled on OpenBSD
1944   running on non-intel platforms.
1946 * The lua socket library is patched so that it will now compile on
1947   OpenSolaris.
1949 * Luatex now has libpng 1.2.33 and mplib 1.100
1951 ==============================================================
1952 Luatex beta-0.30.2 was released 20081020
1953 ==============================================================
1955 * The Lua coco change from 0.30.1 is reverted as it gave
1956   trouble on MacOSX. Lua coco on non-intel OpenBSD platforms
1957   is now explicitly turned off.
1959 * The lua file reading speedup in 0.30.1 broke reading of
1960   files larger than 100MB.
1962 * Reading of font-related files was broken when there was a find
1963   callback, but no read callback.
1965 * The texmf.cnf array size setup values were ignored whenever
1966   --lua was given on the commandline (instead of only when
1967   texconfig.kpse_init is set to false).
1969 * glyphs with negative widths resulted in incorrect horizontal
1970   placement (overlapping) of the string in the output PDF.
1972 * Using \latelua could sometimes result in an invalid output PDF,
1973   and the argument token list was expanded too early
1975 * There was a read buffer overrun in the mapfile parser
1977 * There are two new variables in the status table:
1978   status.callbacks and status.indirect_callbacks (execution counts).
1980 ==============================================================
1981 Luatex beta-0.30.1 was released 20081009
1982 ==============================================================
1984 * Invalid return values from the linebreak_filter callback
1985   are now handled gracefully (was crashing)
1986 * a preinstalled ctangle is no longer needed except when
1987   cross-compiling
1988 * In 0.30.0, the .notdef fix was incorrectly applied to
1989   truetype / opentype fonts.
1990 * A bunch of all memory leaks is fixed
1991 * In lua, f:read('*a') now uses signicantly less memory
1992 * The number of \catcodetables is now limited to 64KB
1993   (for speed reasons)
1994 * Luatex could crash if there were PDF images with and
1995   without page /Group included on the same page
1996 * Lua coco now always uses setjmp (for OpenBSD compatibility)
1997 * The embedded mplib is updated to the latest svn version
1998 * # marks (characters with catcode 6) are no longer doubled
1999   inside \directlua
2000 * Handling the nul character (U+0000) with catcode 13
2001   (active) was broken
2002 * Luatex could crash on win32 with an access violation
2003   because there was one predefined language too few
2004   (the one matching \language=-1)
2006 ==============================================================
2007 Luatex beta-0.30.0 was released 20080930
2008 ==============================================================
2010 New features:
2012 * Readable \tex internal params that are counts, attrs, or dimens are
2013   now returned as numbers instead of strings, and skips as node objects.
2014   Read-write access to tex's skip registers added: tex.skip[0] etc.
2015 * new callback: 'linebreak_callback' to replace the internal paragraph
2016   breaking code
2017 * the tex table now supports more readable 'convert' values:
2018   tex.fontname, tex.pdffontname, tex.pdffontobjnum, tex.pdffontsize,
2019   tex.uniformdeviate, tex.number, tex.romannumeral, tex.pdfpageref,
2020   tex.pdfxformname  (each takes a number as argument)
2021 * new readable parameter: tex.fontidentifier(number) returns the
2022   \csname associated with that font id
2023 * luatex now outputs \FONT<nr> instead of \^^@ in Overfull/Underfull
2024   messages if the font's id text is zero (like for expanded fonts) (#77)
2025  * luatex --version is split into --version and --credits
2026 * There is now (again) an svn revision number in luatex --version (#91)
2027 * Add support for more read-only internal access from lua:
2028   tex.lastpenalty, tex.lastkern, tex.lastskip, tex.lastnodetype,
2029   tex.inputlineno, tex.badness, tex.pdftexversion, tex.pdflastobj,
2030   tex.pdflastxform, tex.pdflastximage, tex.pdflastximagepages,
2031   tex.pdflastannot, tex.pdflastxpos, tex.pdflastypos, tex.pdfrandomseed,
2032   tex.pdflastlink, tex.luatexversion, tex.Alephversion,
2033   tex.Omegaversion, tex.Alephminorversion, tex.Omegaminorversion,
2034   tex.eTeXminorversion, tex.eTeXversion, tex.currentgrouplevel,
2035   tex.currentgrouptype, tex.currentiflevel, tex.currentiftype,
2036   tex.currentifbranch, tex.pdflastximagecolordepth (#81)
2037 * the old --src-specials are replaced by --synctex (#63)
2038 * the \expanded primitive is backported from pdftex 1.50 (#43)
2039 * luatex now comes with libpng 1.2.32
2040 * experimental: tex.definefont(string, number) associates a
2041   csname string with a font id number
2043 Bugs fixed compared to 0.29.0:
2045 * dashes were exported wrongly by MPlib
2046 * multi-item \discretionaries were broken in various ways (#78, mailinglist)
2047 * read_font_info was sometimes called recursively from lua-loaded
2048   virtual fonts
2049 * do_vf was sometimes called on lua-loaded fonts that where
2050   already known to be virtual
2051 * trailing junk in tfm files is now ignored (needed for ecrm fonts)
2052 * pdf_ignored_dimen was initialized too late, breaking \prevdepth
2053   handling and causing output lines to overlap eachother (#72)
2054 * pdf.immediateobj() had a printf-related bug
2055 * the fontname terminal logging is fixed for strange font file names
2056 * lua tex array assignments now listen to the globaldefs setting
2057   (tex.count[0] etc) (#92,partial)
2058 * \parshape was broken (#70)
2059 * there is no longer a ".tex" extension forced on very input file (#74)
2060 * eof() for mapfiles was true one byte too soon (#76)
2061 * out of range \lefthyphenmin and \righthyphenmin settings now actually
2062   disable hyphenation (#90)
2063 * tex.unset_attribute() looked too far ahead when a to-be-unset
2064   attribute id not only did not exist in the node, but was also
2065   higher than the highest set attribute on the node. (#65)
2066 * the parameters attr and page_name of read_image() were swapped
2067   (this broke \pdfimage with attributes)
2068 * tex filenames with spaces in them on the command line are now
2069   allowed again (#30)
2070 * sometimes pfb fonts were included multiple times without valid
2071   reason (#29)
2072 * some parts of the pdftex 1.40.9 PNG transparancy hack were still
2073   present and caused transparant png handling to fail
2074 * \localinterlinepenalty and \localbrokenpenalty were broken
2075 * special case catcode tables are now handled better (#23)
2076 * the handling of missing .notdef charstrings in old pfb fonts
2077   is fixed (#27)
2079 ==============================================================
2080 Luatex beta-0.29.0 was released 20080718
2081 ==============================================================
2084 New features:
2086 * The embedded pdftex is now 1.40.9 (forthcoming) except for the
2087    following:
2088    - the png transparancy fix is skipped because it is in conflict
2089      with a macro-based solution offered by context mkiv.
2090    - LFS (PDF files > 2GiB) is not working yet.
2091    - Synctex is still missing
2093 * libpng, xpdf, and zlib are updated to their pdftex 1.0.9 levels
2095 * MPlib is updated to 1.090
2097 * The syntax of buildpage_filter is changed to avoid confusion
2098    (and crashes). See the manual for the new calling convention.
2100 Bugs fixed compared to 0.28.0:
2102 * The previous bugfix for \languages skipping numbers was wrong.
2104 * Various compile-time warnings are suppressed
2106 * \pdfsetmatrix was broken
2108 * \pdfsave and \pdfrestore were broken
2110 * Valid user_defined whatsits nevertheless were generating errors.
2113 ==============================================================
2114 Luatex beta-0.28.0 was released 20080630
2115 ==============================================================
2117 There is one new feature:
2119 There is now experimental support for non-trivial discretionaries
2120 following explicit hyphens. In analogy to \prehyphenchar and
2121 \posthyphenchar, there are two new parameters \preexhyphenchar en
2122 \postexhyphenchar. Both new parameters default to zero (nothing).
2123 When set to a nonzero value, the parameter is added to either the
2124 pre- or post- break text. Note that this is *in addition to* the
2125 hyphen already in the input. Testing and comments are very welcome.
2127 Here is a short example (no idea what is says):
2129    \pdfoutput=1
2130    \hsize=2in
2131    \postexhyphenchar=`-
2132    Seria bom se eu
2133    pudesse t\^e-lo mantido como amigo, mas por
2134    mais bem-intencionado que eu fosse, n\~ao
2135    foi possivel
2136    \bye
2140 Bugs fixed compared to 0.27.0:
2142 * Words that started off with a character with a zero \lccode
2143    were never hyphenated at all.
2145 * There was a bug in the new active characters code that prevented
2146    the latex format from being built (with Invalid character error).
2148 * There is a temporary fix for the sometimes appearing "Font has a
2149    bad FontBB" message from Acrobat.
2151 * \leaders did not actually stretch enough (the last bit of glue
2152    that has to line up the line endings was never output to the PDF).
2154 * Bad paragraph-related callbacks could result in luatex crashing.
2156 * The pre_linebreak and post_linebreak filters were never called
2157    when \output was active (this was a leftover of a superceded
2158    optimization).
2160 * 'skipping' language codes when setting up \patterns c.s. did not
2161    work (it used the next empty slot instead of the actual value of
2162    \language).
2164 * Using multiple 'attr' keywords on box items could cause random
2165    crashes.
2167 * Calling lang.hyphenate() with one argument (without specifying a
2168     tail node) could crash.
2170 * The luatex pdf banner and version reporting is cleaned up a bit.
2172 * Conflicting patterns inside \patterns now give an error:
2173      ! Conflicting pattern ignored.
2174    (duplicate identical patterns are ignored without error).
2176 ==============================================================
2177 Luatex beta-0.27.0 was released 20080624
2178 ==============================================================
2180 Bugs fixed compared to 0.25.3:
2182 * Unicode reencoding support for non-standard (i.e. older)
2183    Type1 fonts is now somewhat less broken than it was (#25)
2185 * .vf fonts using specials crashed luatex
2187 * luatex would crash on --\par (#33)
2189 * An attempt is made to get a sane default value for StemV in
2190    the created pdf (#32)
2192 * We can now guarantee that %PDF-1.* header is printed before
2193    the first pdf.print() output
2195 * lang.hyphenate() was broken
2197 * insert_before(a,a,b) was broken (#37)
2199 * argv[0] is now cleaned up before being used as a default for
2200    mem_name and prog_name (#28).
2202 * luatex would crash on loading extended fonts (fonts loaded
2203    via lua callbacks) from a format file.
2205 * The fix for pdftex bug #799 is backported from pdftex 1.40.4.
2207 * slnunicode had a bug in the unicode.utf8.gmatch iterator.
2209 * Queries of nonexisting fontdimens could cause a crash.
2211 * luatex would crash on {\textdir TLT\pardir TLT x\break\par }
2213 * Fixed wrong placement of lines in mixed-direction paragraphs
2214    that could happen in some situations.
2216 Other news:
2217 * Luatex now includes luasocket (#35)
2218    See http://www.tecgraf.puc-rio.br/~diego/professional/luasocket/
2219    for usage.
2220    There is a new commandline option: --nosocket to disable this,
2221    and that is also implied by --safer.
2223    NOTE to the binary builders: there are some unfixed configure
2224    problems when you need to add a specific library to get socket
2225    support on your platform. You probably will have to edit the
2226    generated Makefile by hand (search for 'socketlib').
2228 * There is ongoing development to the 'img' and 'mplib' libraries.
2229    See the reference manual for details.
2231 * The 'character commands' in virtual fonts now support image
2232    inclusion. See the reference manual for details.
2234 * Lua error messages now include the call stack.
2236 * \directlua and \latelua have been extended to accept a 'name'
2237    keyword. The argument is a token list that is used as the lua
2238    name of this chunk in lua error messages and call stack prints.
2239    (#42)
2241 * The lua chunk names can be interfaced via a new virtual
2242    table called lua.instancename, the values in that function as
2243    defaults in the absence of 'name' keywords.
2245 * The 2-plane limit on active character range is removed (#12).
2247 * Subsetted TTF fonts in the PDF now retain the cmap table.
2249 * There is a new Lua variable os.selfdir. This contains the
2250    full absolute pathname of the directory that the executable
2251    resides in (with symlinks resolved)
2253 * There is a new function os.uname() this returns a lua
2254    table containing various platform information items.
2256 * The node library now uses text strings for direction specifiers
2257    instead of numbers. See the reference manual for details.
2259 * The 'E' (edit) as error response functionality is now a noop.
2261 * Adding luatex 0.25.3 to texlive resulted in a few minor backports,
2262    in particular: Support for mktexfmt is added, and luatangle now
2263    identifies itself as such (instead of calling itself otangle).
2265 * We fixed a whole series of portability problems (but
2266    we probably introduced new problems as well).
2268 * Most (all?) files now have a corrected Copyright header,
2269    and link in $Id$ and  $URL$ into the object file.
2271 * Some unnecessary files were removed from the distribution.
2273 ==============================================================
2274 Luatex beta-0.25.3 was released 20080418
2275 ==============================================================
2277 Bugs fixed:
2278 * Pdftex bug no. 936 (sarovar) regarding vertical
2279   positioning of embedded PDF files if depth parameter is given.
2280 * Luatex gave bogus lua return values for the tex.wd/hd/dp
2281   values of void boxes
2282 * A few bugfixes in mplib (square pens caused hangs, elliptical
2283   pens caused confused output)
2284 * Hyphenation of uppercase words (\uchyph) was broken
2285 * Output image placements corrected for all 8 transform cases
2286   also when artbox etc. is used
2287 * There were missing maketexstring() calls in error messages
2288 * Math display contents were sometimes prematurely freed during
2289   the placement of the equation number
2290 * Setting \language=-1 could cause crashes due to an array
2291   index going out-of-bounds
2293 Other news:
2294 * build.sh.ppc is added to the source distribution. This is a
2295   script that crosscompiles osx ppc binaries from osx intel
2296 * tex.box[<chardef name>] is now supported (but still experimental)
2297 * a bunch of compiler warnings are removed
2298 * The fontforge library now dump AAT feature tags as and
2299   "<id,flags>" string
2300 * The new function font.nextid() predicts the next assigned font id
2301 * Some source code changes are backported from texlive
2303 ==============================================================
2304 Luatex beta-0.25.2 was released 20080410
2305 ==============================================================
2307 * Updated to MPlib 0.40
2308 * Bugfixes and cleanup in the lua img table code
2309 * Fix \pdflastximagepages bug from pdftex
2310 * Fix for very large tex.print strings
2311 * Update to Lpeg 0.8.1
2312 * &D Bugfix for Type1 fonts when out-of-range characters
2313   are marked as 'used'
2315 ==============================================================
2316 Luatex beta-0.25.1 was released 20080321
2317 ==============================================================
2319 * Updated to MPlib 0.30 (that is now becoming usable)
2320 * The build requirement for a pre-installed ctangle is gone
2321   (thanks to Martin)
2323 ==============================================================
2324 Luatex beta-0.25.0 was released 20080311
2325 ==============================================================
2327 New:
2329 * mplib library:
2330    This version features an embedded MP interpreter whose output
2331    can be directly accessed from lua code (mplib), without calls
2332    to an external "mpost" command. Of course it has bugs and
2333    limitations (makempx does not work, for example) but keep in
2334    mind that it is only an initial attempt.
2335    See the manual for more details.
2336 * img library:
2337    ** img.immediatewrite() is added
2338    ** images now accept a 'transform' key
2339    ** widths etc. can now be given as width="100mm"
2341 Fixed:
2343 * \parshape handling was completely broken since 0.20.0+
2344 * when \pdfprotrudechars was in effect, an assertion failure
2345    could happen when embedded \hboxes in the paragraph appeared
2346    at the end of a line.
2347 * import of otf fonts with contextual lookups has been debugged,
2348    thanks to a patch by GW himself.
2349 * compiling with gcc 4.2.3 is now supported
2350 * if you want to build from source, you need a pre-installed ctangle.
2353 ==============================================================
2354 Luatex beta-0.22.1 was released 20080227
2355 ==============================================================
2357 * The macnames.c source file for building ttf2afm is restored.
2358 * "make depend" in luatexdir now works again
2359 * luatex sometimes crashed because it attempted to expand an
2360   already expanded font
2361 * luatex aborted when --progname was given but no format name.
2362   It now sets the format name to the given progname in that case
2363 * sometimes paragraphs with near-empty lines could cause a crash
2364 * img.supportedtypes() had a bug causing it to crash
2365 * img.supportedtypes() has been renamed to img.types for consistency
2366 * img.boxes() added, returns strings representing bounding boxes
2367 * img.node() added, returns a whatsit node cf. \pdfrefximage
2368 * node.write() now accepts multiple arguments
2369 * the program_name_set switch was not set automatically from C,
2370   causing errors unless lua code called kpse.set_program_name()
2371   explicitly
2372 * kpse.set_program_name() can now be called more than once
2373   in a single run.
2374 * os.spawn{...} and os.exec{...} could cause crashes because of
2375   a memory allocation error
2377 ==============================================================
2378 Luatex beta-0.22.0 was released 20080215
2379 ==============================================================
2381 * We now have an official bug tracker: http://tracker.luatex.org
2382 * A new lua library (img) is added that allows a direct
2383    interface to the image handling of luatex. You can use this
2384    to include images from lua code instead of via the more
2385    traditional \pdfximage cs. See the manual.
2386 * An optional equal sign after \{pre,post}hyphenchar is now
2387    allowed.
2388 * os.exec() has been extended, and os.spawn() added. These
2389    functions have support for quoted strings, and they
2390    also accept a table with preseparated command arguments.
2391 * New string constants os.type and os.name are provided.
2392 * node.last_node() is added. This pops and returns the last
2393    node from luatex's 'current list'
2394 * node.write() is added. This appends a node to the end of
2395    luatex's 'current list' (experimental).
2396 * The strict check on unicode compliance in pattern files
2397    is dropped. Patterns files still have to be in proper UTF-8
2398    encoding, but the error for non-Unicode character values
2399    (like 0 - 31 and 127 - 159) is dropped.
2400 * \pdfadjustinterwordglue, \prependkern, \appendkern
2401    and associated \XXXXcode arrays are gone.
2402 * The rest of the pdftex font arrays are now merged into
2403    the new luatex font data structure. This means that you
2404    can now set up font expansion from lua code, and that a few
2405    font-related limits are gone.
2406 * The 'top_skip' field in 'insert' nodes is renamed to 'spec',
2407    for improved consistency.
2408 * kpse.show_path() added. This behaves just like
2409    $ kpsewhich --show-path
2410 * The unicode.utf8 functions now also accept values in the range
2411    1.114.112 - 1.114.367 that is used by LUATEX for raw byte output.
2413 What's been fixed:
2415 * Better node memory (de)allocation error tracking and messages
2416 * Compilation on MacOSX 10.5 was broken
2417 * There was a bug in node.insert_after
2418 * Use of \{pre,post}hyphenchar was broken
2419 * lfs.permissions was leaking memory
2420 * Some warning and error messages are improved a bit
2421 * A set of bugs in character protrusion, this seems to be working
2422    ok now.
2423 * Also, a set of bugs in font expansion. This now works in most
2424    cases but is not quite bugfree yet (problematic files for testing
2425    are welcomed).
2426 * The functions in the kpse library would crash luatex if
2427    kpse.set_program_name() was not yet called. gives an error now.
2428 * Alignments with spanned columns could cause crashes
2429 * A patch is added for problems with filename parsing on the
2430    "first input line" (by Jonathan Kew)
2431 * The hpack_filter and vpack_filter were only called for lists longer
2432    than one node.
2433 * Luatex is now more forgiving about font subsets being smaller
2434    than their expected size (issues a warning instead of aborts now)
2435 * A "double-free ignored" error for paragraphs with lines starting
2436    with discarded items was fixed.
2438 ==============================================================
2439 Luatex beta-0.20.2 was released 20071217
2440 ==============================================================
2442 * some portability fixes to the build scripts
2443 * a fix for multi-\span in alignments causing unbreakable
2444    loops
2445 * manual improvements from Jonathan Sauer
2446 * fix for undefined csnames in \directlua if
2447    web2c's hash_extra is nonzero
2448 * fix for LR text inside of a RL document
2449 * fix for open_read_file callback not being called
2450    unless find_read_file was also registered
2451 * removed the ocp status message when \ocps are not
2452    actually used
2453 * "unicodeenc" in the fontforge to_table renamed to
2454    "unicode" for improved consistency
2456 ==============================================================
2457 Luatex beta-0.20.1 was released 20071207
2458 ==============================================================
2460 * texlua was broken on Solaris because the some C header
2461    files were loaded in the wrong order.
2462 * os.tmpdir() now accepts an argument, making it easier
2463    to use. It now generates more unique filenames when
2464    it is called repeatedly in one run.
2465 * The --luaconly commandline switch is now documented
2466    in the --help text.
2467 * The new extended hyphenation exceptions were severely
2468    broken.
2469 * \pdfprotrudechars could cause luatex to abort with an
2470    assertion failure.
2471 * There was a bug in the  \span code that could cause endless
2472    loops.
2473 * The simple forms of \leaders were messed up on windows
2474    because a variable was not properly initialized.
2475 * Non-grouped \textdir commands created invalid output.
2476 * e-TeX's pseudo files were not closed properly in ini mode.
2477 * The luatex.web now weaves properly again.
2478 * I made some small improvements to the manual.
2480 ==============================================================
2481 Luatex beta-0.20.0 was released 20071205
2482 ==============================================================
2484 News compared to the last beta (0.11.2) is as follows:
2486 * Completely overhauled hyphenation and ligkern application,
2487   including the addition of a new "lang" table in lua to
2488   interface to the language parameters, some extra functions
2489   in the "node" table, and a few extra callbacks ("hyphenate",
2490   "ligaturing", "kerning", "post_linebreak_filter").
2492   There is a new chapter in the manual to document all the
2493   changes to the hyphenation and line breaking algorithms,
2494   it is simply too much to list here.
2496 * the interface of the pre_linebreak_filter,hpack_filter,
2497   vpack_filter, and pre_output_filter has changed slightly.
2499 * boxes can now get explicit attributes different from the
2500   currently active set, using a syntax like
2502   \hbox attr2=12 attr3=-1 to 12pt {Hi!}
2504 * lpeg is now at version 0.7
2506 * a whole series of exotic bugs and compiler warnings are
2507   fixed, mostly thanks to the watchful eye of Fabrice.
2509 * texio.print now accepts multiple strings as arguments.
2511 * the lua functions os.sleep(), os.times(), os.gettimeofday()
2512   and os.tmpdir() have been added.
2514 * lua now comes with the coroutine (coco) patches from the
2515   luajit project applied.
2517 * the banner line no longer claims to be TeX.
2519 * a bunch of bugs reported on the mailing list have been
2520   fixed (I hope all of them).
2522 * (internal) we found lots of small ways to speed up lua
2523   node processing.
2525 * (internal) the node (de)allocation functions have been
2526   rewritten, so that absolutely all nodes now have a type,
2527   even the ones with variable sizes.
2530 ==============================================================
2531 Luatex snapshot-20071029 was released 20071029
2532 ==============================================================
2534 * Completely overhauled hyphenation and ligkern application.
2536   There is a new chapter in the manual to document all the
2537   changes to the hyphenation and line breaking algorithms,
2538   it is simply too much to list here.
2540 * the interface of the pre_linebreak_filter,hpack_filter,
2541   vpack_filter, and pre_output_filter has changed slightly.
2543 * lpeg is now at version 0.7
2545 * a whole series of exotic bugs and compiler warnings are
2546   fixed thanks to the watchful eye of Fabrice.
2548 * texio.print now accepts multiple strings as arguments.
2550 * The lua function os.sleep() is added
2552 ==============================================================
2553 Luatex beta-0.11.2 was released 20070918
2554 ==============================================================
2556 * Pdf inclusion and subsetting of CID-based opentype fonts
2557   now works as it should.
2559 ==============================================================
2560 Luatex beta-0.11.1 was released 20070918
2561 ==============================================================
2563 A quick list of what is new and fixed since beta 0.10.2:
2565 New:
2566 * pfb+afm fonts can now be used in 'wide' (encodingbytes=2) mode
2567 * searching in PDFS using 'wide' fonts now works reasonably well
2568   (based on the tounicode feature)
2569 * related to that, tounicode information can now be passed
2570   on inside the font metrics table
2571 * font subsetting is now supported for CID-based OpenType fonts
2572   (however, there is a known bug with KpozMinProVI-Regular.otf)
2573 * fontforge's warning and error messages are now intercepted
2574   and passed on to the lua code as a second return value of
2575   the fontforge.open() function
2576 * the new primitive \suppressfontnotfounderror can suppress
2577   the TeX error for "Font not found"
2578 * The lua function font.current can now be used to set TeX's
2579   current font
2581 Fixes:
2582 * set_attribute(-1) is now the same as unset_attribute()
2583 * OpenType lookups with glyph classes would crash luatex
2584 * luazlib would not compile on debian (fix from Norbert)
2585 * CID-based fonts would crash luatex
2586 * Bare CFF should be read in binary mode (fix from Akira)
2587 * VF processing did not process packets containing zero bytes properly
2588 * the truetype collection (.ttc) handling is fixed, so that all
2589   of the fonts inside a collection can now be used reliably
2590 * application segfaults and stack overflows are intercepted
2591   so that luatex can quit a bit more gracefully
2592 * an assertion failuer on systems with signed chars (linux-powerpc)
2593   is fixed
2594 * a crash on AMD64 linux was fixed
2595 * the lua "pdf" table code was wrong
2596 * \ifcsname did not work properly for UTF-8 characters
2597 * Use of the math-related functions using make_fraction (like \atop)
2598   caused a crash
2599 * \handling of \if\noexpand was wrong
2600 * applied a patch that cleans up XForm and page calculations
2601 * "autoconf" support from zziplib is stripped
2603 ==============================================================
2604 Luatex beta-0.10.2 was released 20070814
2605 ==============================================================
2607 Bugs fixed:
2609 * the primitive \span was completely broken
2610 * \pdfexpandfont (font expansion) misbehaved if it was used more
2611    than once
2612 * virtual fonts: sometimes they used the wrong internal font id,
2613    loading vf fonts via fonts.read_vf() was impossible, and sometimes
2614    virtual fonts created segfaults
2615 * while dumping formats, the last font parameter for each font was not
2616    dumped at all
2617 * zziplib was always compiled with pre-installed zlib headers, instead
2618    of the ones in the build tree
2619 * lua 5.1.2 has trouble quoting ^Z characters etc, the tentative patch
2620    for lua 5.2 from Luiz fixes that, hopefully
2621 * fontforge.font('font.pfb') now properly parses AFM boundingboxes
2622 * non-existing files in the argument for fontforge.open() or
2623    fontforge.info() could cause segfaults, now it generates an error
2624    instead
2625 * fontforge.open() did not return character widths for vertical fonts
2626    as it should
2627 * on Windows, fontforge believed that ttc files (TrueType Collections)
2628    were actually directories. ttc processing is still not 100% correct,
2629    but it is getting better
2630 * the build system used explicit 'make' sometimes
2631 * the auto-growing string pool was not used everywhere
2632 * there were some typos in the documentation parts of the pascal web
2633 * use of \parshape could easily exhaust all available memory
2636 New features:
2638 * support for applying Adobe Feature files (.fea) and Adobe Font
2639    Metrics (.afm) is added to the fontforge library
2640 * fontforge.info() will now return an array of tables for the contents
2641    for ttc files
2642 * support for a 'texluac' personality was added, to replace the 'luac'
2643    command from the official Lua distribution
2645 ==============================================================
2646 Luatex beta-0.10.1 was released 20070719
2647 ==============================================================
2649 This was a hotfix because beta-0.10.0 was completely broken.
2651 ==============================================================
2652 Luatex beta-0.10.0 was released 20070718
2653 ==============================================================
2655 The latest version of the manual is included in the package, and I
2656 am not going to repeat all of that. There were some minor changes
2657 compared to the previous snapshot, but mostly just bugfixes and
2658 documentation improvements.
2660 ==============================================================
2661 Luatex snapshot-20070626 was released 20070626
2662 ==============================================================
2664 * Integrated the lua library lzlib, this defines tables with
2665    bindings for zlib (including eazy-to-use gzip support)
2666 * Updated to slnunicode version 1.1
2667 * Some small cleanups in the sparse array handling
2668 * Moved the raw byte support out of the valid unicode range
2669 * Fixed a bug in the OFM font reader
2670 * Removed the pdftex snap nodes (and associated primitives)
2673 ==============================================================
2674 Luatex snapshot-20070622 was released 20070622
2675 ==============================================================
2677 Not a lot of news, but it fixes a few important bugs in the lua
2678 node processing. Also a few utility functions are added:
2680 * tex.round()
2681    rounds and bounds checks a lua number to make sure it is
2682    a valid tex integer.
2683 * tex.scale()
2684    multiplies a number (or the numeric values in a table)
2685    with a fixed quantity, and calls tex.round() on the result.
2686 * node.has_field()
2687    Test if a node has a specified field name
2688 * node.remove()
2689    removes a node from a nodelist, while keeping the list intact
2690 * node.insert_before()
2691    inserts a new node into a nodelist, just before a specified
2692    location node
2693 * node.insert_before()
2694    inserts a new node into a nodelist, just after a specified
2695    location node
2696 * node.hpack()
2697    packages a nodelist into a hlist node
2700 ==============================================================
2701 Luatex snapshot-20070619 was released 20070619
2702 ==============================================================
2704 * The lua node processing interface is completely reworked.
2705    It is now completely based on userdata, and uses a new lua table
2706    called 'node' to hold the methods. More detailed information
2707    is in the manual (of course).
2709 * There is a fifth node processing callback:
2710       pre_output_filter
2711    this is executed just before the packaging of \box 255.
2713 * The hpack_filter and pre_linebreak_filter callbacks now
2714    receive an extra argument indicating the number of top-level
2715    glyphs in the node list.
2717 * Virtual fonts can now contain a 'node' key in the glyph
2718    commands: the value should be a hlist node (i.e.: a horizontal
2719    box), and that will then be output for each character access
2720    in that font.
2722 * A new set of registers is added, called \attribute. These are
2723    values that will be automatically attached to nodes created in
2724    their scope. More information in the manual.
2726 * Direct read/write access to TeX's box registers is addded to
2727    the lua 'tex' table.
2729 * TeX's main memory now grows dynamically, and the (de)allocation
2730    routines have been rewritten completely.
2732 * The 'kpse' table is extended with extra interface functions, to
2733    allow texlua to be used as a scripting engine.
2735 * The \pdftexversion command now returns 200, not 140.
2737 * The displayed banner and --version screens are cleaned up.
2739 * The format file is now RLE compressed. Not as small as before,
2740    but unpacking is much faster.
2743 ==============================================================
2744 Luatex snapshot-20070426 was released 20070426
2745 ==============================================================
2747 This past month I have been busy with nodes and lists of nodes,
2748 so the big new feature in this release is that there are four
2749 callbacks that operate on node lists:
2751   buildpage_filter
2752   pre_linebreak_filter
2753   hpack_filter
2754   vpack_filter
2756 The preliminary documentation for these is in the manual, but the basic
2757 idea is that you can filter a node list just before LuaTeX starts doing
2758 something with it (like line breaking). This functionality is not stable
2759 yet: the node presentation of the various node types is pretty much OK
2760 now, but keep in mind the following:
2762   * math noads and math typesetting are not handled at all (yet)
2763   * not all hpacks and vpacks are intercepted (yet)
2764   * the nested node list handling will probably change
2765   * A conversion tool for nodes to/from dictionaries is planned,
2766     but not done yet
2768 The other changes in this snapshot are various bugfixes (for builds
2769 on various platforms as well as font issues) and speedups (in the
2770 execution of callbacks and the creation of lua font representations).
2773 ==============================================================
2774 Luatex snapshot-20070322 was released 20070322
2775 ==============================================================
2777 * I have changed the token_filter callback quite rigorously,
2778    mostly because of speed issues. The raw speed of trivial
2779    lua token handling is now only about 20 times slower than
2780    the native handling. Not bad at all, considering it has to move
2781    between interpreted and compiled code for each and every
2782    token. If you do not run the token filter inside \output,
2783    the effective run speed difference should not be much more
2784    than a factor 1.5.
2786    Two big differences: you have to call token.get_next()
2787    yourself, and the token table is now a three-item array
2788    instead of a five-key hash. The minimal example changes to
2790    \directlua0{
2791      callback.register('token_filter', function ()
2792        return token.get_next()
2793        end)
2794    }
2796    more details are in the manual.
2798 * I've fixed a few bugs in the handling of Opentype TTF, and added
2799    a new key in the font definition table:
2801       f.encodingbytes = (1|2)
2803    The default is 2 for opentype and truetype format, 1 otherwise.
2804    Later on, it will become possible to have a type1 font in 2-byte
2805    (CID) encoding or a truetype font in traditional encoding (1-byte),
2806    but I have not covered all cases yet.
2810 ==============================================================
2811 Luatex snapshot-20070309 was released 20070309
2812 ==============================================================
2814 * The OCP debug information is removed again.
2816 * There is a new callback that I am quite excited about myself:
2817    'token_filter'.
2820 A bit of text from the reference manual:
2821 --------------------
2822 This callback allows you to change the modify any lexical token that
2823 enters the \type{main_control} function before \LUATEX\ executes the
2824 associated command.
2826 Note: not all tokens can be intercepted yet, only those that are `seen'
2827 by \LUATEX's main control function.  Supplemental tokens like the bodies
2828 of macro definitions and the right-hand side of register assignments
2829 are not seen. For now, this is intentional.
2831 \startfunctioncall
2832       function (table <token>)
2833          return table <token>
2834       end
2835 \stopfunctioncall
2837 Calling convention for this callback is bit more complicated then for
2838 most other callbacks.  Initially, lua function will be called with the
2839 next token from \type{get_next()} as argument, represented as a small
2840 lua table.  The function should either return a lua table representing
2841 a valid to-be-processed token, or something else like nil or an empty
2842 table.
2844 If your lua function does not return a table representing a valid
2845 token, it will be immediately called again with yet another token
2846 from \type{get_next()} as argument, until it eventually does return
2847 a useful token.
2849 But if the function does return a usable token, then that token will
2850 be processed by \LUATEX. Afterwards, the function will be called
2851 again, but now without an argument. This is repeated until it stops
2852 returning tokens.  Then processing reverts back to the other branch.
2854 The point behind that roundabout calling convention is that it
2855 allows the lua function to buffer tokens for various uses. That in
2856 turn makes it possible to do some really advanced things like
2857 replacing OTPs.
2859 Now about that table. The table that the function will receive
2860 contains four fields:
2862 \starttabulate[|l|i|p|]
2863 \NC Key     \NC  type    \NC                Explanation \NC\FR
2864 \NC cmd     \NC  string \NC A representation of  \LUATEX's internal
2865                              command code\NC\NR
2866 \NC chr     \NC  number \NC The command code modifier\NC\NR
2867 \NC cs      \NC  string \NC If the token came from a csname, this
2868                              is  that csname\NC\NR
2869 \NC mod     \NC character \NC A single character string representing
2870 the current processing mode. One of {\bf v}ertical, {\bf h}orizontal,
2871 display {\bf m}ath, {\bf n}o, internal {\bf V}ertical,
2872             restricted {\bf H}orizontal, or inline {\bf M}ath mode.\NC\LR
2873 \stoptabulate
2875 If you modify the table before returning it, then it is wise to return
2876 either a (\type{cmd}, \type{chr}) pair, or a \type{cs} string.  That is
2877 because if both options are present, the pair has precedence and the
2878 string is ignored. On the return table, {\bf mod} is ignored always.
2879 --------------
2881 I have no long example code yet and it is not as complete as one
2882 would want it to be because it is not intercepting everything that
2883 comes in, only the bits that are triggered by the main control
2884 loop.
2886 I decided to do a fast snapshot release for two reasons:
2888 * It is one of the easier extensions to get started with if you want
2889    to learn a bit about lua programming
2891 * I would welcome feedback on the token interface, because it will
2892    be needed in other places as well, soon. I am still not sure
2893    whether converting the command to/from strings is worth it, for
2894    example. And maybe it would be less confusing if you could return
2895    a list of tokens instead of being called repeatedly?
2897 Here is the trivial example to get you started:
2899     \directlua0{
2900       callback.register('token_filter', function (t) return t end)
2901     }
2904 ==============================================================
2905 Luatex snapshot-20070307 was released 20070307
2906 ==============================================================
2909 * Non-CID PostScript-based Opentype fonts are now combined over
2910    the entire document, and properly subsetted. The code is
2911    borrowed from xdvipdfmx with some minor adjustments
2913    Adding support for CID-keyed OpenType fonts would not be hard
2914    but at the moment I lack example input (and incentive).
2916 * A small extension to the virtual fonts structure: you can use
2918      f.fonts[1] = { 'id' = 38}
2920    to do a backreference to a previously defined font. This saves quite
2921    a few computations
2923 * There was a bug in the handling of \leaders in the output whereby
2924    it's width was taken to be twice what it should be while writing
2925    to the PDF, fixed now.
2927 * The font inclusion code is cleaned up a bit by Hartmut.
2929 * Some compilation problems were fixed.
2931 * There is (quite a bit of) debugging information printed out when
2932    OTPs are in use, because I am tracking down a bug reported by Idris.
2934    The input of each and every OTP step is shown on the terminal in
2935    a line line this:
2937      [57902][1568][58423][1568][58408][1568][58921]
2939    those are the decimal values of ocp i/o characters. If you don't
2940    need them, don't worry about it.
2942 ==============================================================
2943 Luatex snapshot-20070302 was released 20070302
2944 ==============================================================
2946 * The 'snapshot version' banner is now calculated dynamically
2947   at build time. This aids in figuring out what binary people
2948   are actually running, but it can possibly break the build on
2949   systems that do not have a `date` command.
2951 * The do_vf() function that checks for virtual font existance
2952   is now run immediately after the font definition instead of
2953   being postponed until characters are output.
2955 * The 'define_font' callback interface has changed a little.
2956   It is now:
2957     retval = function (name,size,fontid)
2959   where fontid is the internal font number of the font that
2960   is currently being defined, and retval can be either a table
2961   (as before) or a different, previously defined fontid. This is
2962   useful if a previous definition can be reused instead of
2963   creating a whole new font structure.
2965 * The internal font data structure has been redone. Glyph index
2966   inside a font is now handled by a sparse array, so that use
2967   of e.g. 0xFB01 (fi-ligature) no longer creates a 64000+ entries
2968   character array.
2970 * The internal cache-ing of font metric information is turned
2971   off completely, because it was based on the assumption that
2972   name + size were a unique identifier for a font. This can no
2973   longer be guaranteed.
2975 * word boundary processing now works OK again, thanks to the
2976   introduction of two virtual characters in the font table
2977   definition. Besides the normal numeric entries in the
2978   f.characters table, there can now also be two string keys:
2979   "left_boundary" and "right_boundary". The  ligatures and kerns
2980   of the 'left_boundary' character are used for the pre-word
2981   boundary processing, ligatures and kerns between characters
2982   and 'right_boundary' are used for the post-word processing.
2984 * Lua font table references are no longer cached by the
2985   executable ,in order to preserve memory. (the only downside
2986   is that font.fonts[] access is now slower because of the need
2987   to recreate the lua table).
2989 * There are other some small changes to the font table formats.
2990   Please see the manual for details.
2992 * A 'real' font can now still have virtual characters if they
2993   are loaded via lua. Just set the 'commands' section and/or
2994   the 'fonts' array to your liking, and it should work out.
2996   If you have created no 'fonts' array at all, then the default
2997   font (indentifier '1')  is the current font, so that you
2998   can create virtual duplicates of already existing characters.
3000   Note: this does not work the other way. There can not be
3001   'real' characters in a virtual font!
3003 * Truetype-based opentype fonts no longer require Acrobat 7
3004   t(hey are now written out as if they are normal truetype).
3006 * A lua init script can now set 'texconfig.formatname' and/or
3007   'texconfig.jobname'. If ther is no file or format specified
3008   on the commandline, then, if, one of those keys is present,
3009   that key will be used instead of simply quitting with an
3010   error.
3012 * Placement of boxes and rules in right-to-left mode is debugged,
3013   and now seems to work ok.
3015 * Virtual font loading is debugged.
3017 * Some memory leaks are resolved
3019 * HZ font expansion should work ok again, but is not tested.
3021 * a few of the warning during opentype loading have been removed
3022   because the problems are rather harmless and turned out to be
3023   triggered by almost every font.
3026 ==============================================================
3027 Luatex snapshot-20070218 was released 20070218
3028 ==============================================================
3030 * The pdftex stuff is now updated to 1.40.3
3031   (and on top of that, it still has those extra patches announced in
3032   snapshot 20070202)
3034 * The virtual font parser is debugged and now appears rather stable.
3036 * There is one extra virtual command:
3038     "commands" = {
3039        {"slot", 1, 97}, -- place character 97 'a' in local font 1.
3040      }
3042   This is just a shortcut for {"font",1}, {"char", 97}
3044 * Some small memory leaks have been fixed. Luatex does not leak big
3045   time, but I'd like to get back to valgrind reporting '0 out of 0',
3046   instead of the current 800 bytes or so (that is a slow process).
3048 * You can read a truetype or opentype font from within lua code
3049   using font.read_ttf() or font.read_otf(), respectively.
3051   This feature uses a fair bit of the fontforge code, making the
3052   binary rather a bit larger than before. Just so you know.
3054   Apple (AAT, as well as encoding) support is still largely missing,
3055   and bitmap-only and old Multiple-Master truetype fonts are not
3056   supported at all (and never will be).
3058   The output format is (shadily) documented in the reference manual.
3059   At the moment, it very closely resembles the internal font stucture
3060   that is used by fontforge.
3062 * LuaTeX can now write wide OpenType fonts to the PDF file.
3064   There is no subsetting support yet, and a ToUnicode CMap is also
3065   still missing, but nevertheless it is already somewhat useful. The
3066   rule is very simple: if a font uses code points above 255, then it
3067   is considered to be a `wide' font, and it will be written out as
3068   a Type0 CID-keyed font to the PDF.
3070   Caveat: Getting suitable metrics into LuaTeX can be a bit of problem
3071   right now, because font.read_otf() does not produce anything that
3072   can be fed back into define_font without extra processing.  Hans has
3073   some experimental Lua code for ConTeXt (of course :-)) and that is
3074   how I know it works.  You can expect a nicer interface soon,
3075   hopefully next week, in the form of a simplistic table conversion
3076   routine.
3078 * I have started work on supporting Aleph's bidi typesetting in PDF
3079   mode as well, simple text seems to be largely ok. More complicated
3080   documents will no doubt still show some bugs, but fixing those will
3081   be easy (once they are discovered). Exactly what happens with specials
3082   is not yet investigated.
3084 * Omega's (16-bit) wide virtual fonts now work OK in PDF mode. This
3085   means that many Aleph files can now be run in PDF mode directly.
3086   (the documents that use UTF-8 input encoding)
3089 ==============================================================
3090 Luatex snapshot-20070202 was released 20070202
3091 ==============================================================
3094 * The pdftex stuff is now updated to 1.40.2, and on top of that, it has
3096    - an extra patch from Han The Thanh that adds a primitive to control
3097      the merging of fonts from external pdf images (\pdfreplacefonts),
3098      and a bugfix for virtual font handling.
3100    - an extra patch by Hartmut Henkel that removes a number of malloc()s
3101      and free()s from the calls to the compression library, thereby
3102      making luatex run a bit faster.
3104 * luatex now happily accepts the following low-level syntax:
3106     \font\myfont = <general text> <at specifier>
3108    It feeds the <general text> to either kpathsea or a lua script for
3109    further processing after stripping the braces.
3111    In itself, this is not all that useful, but the reason for this
3112    syntax extension is that it paves the road for a macro package
3113    to do something like this:
3115     \font\myfont = {font="Times New Roman", color="\darkred",
3116                     encoding="ec", features="liga", size=10bp}
3118    without having to resort to system-specific quoting mechanisms.
3119    Macro (and other) expansion takes inside the braced argument.
3121    (I am considering adding this extension to \input as well).
3123 * It is now possible to define a font into the font.fonts[]
3124    directly from lua, but becayse use is limited, I am only
3125    mentioning it to be complete.
3127    Syntax:
3128         <number> id = font.define(<table> font)
3130 * There is a (not very reliable yet) virtual font parser accessible
3131    from lua.
3133    Syntax:
3134         <table> vfdata = font.read_vf(<string> name, <number> size)
3136    The interpreter tries to give a reasonable representation of a
3137    virtual font file (the .vf file). Besides a few simple top-level
3138    items:
3140      designsize  -- in scaled points
3141      size        -- also in sp
3142      name        -- the file name
3143      checksum    -- the vf checksum
3144      header      -- the header comment  (if any)
3146    it also has a top-level array 'fonts' wherein each item is a mini-
3147    array describing one of te mapped fonts. An example makes this
3148    easy to understand
3150     "fonts" = { {"ptmr8a",655360}, {"psyr", 600000} }
3152    says that the first referenced font (index 1) in this virtual font
3153    is ptrmr8a.tfm loaded at 10pt,  and the second is psyr.tfm loaded
3154    at a little over 9pt. These index numbers are used by the character
3155    command definitions that follow.
3157    At top level, there is a 'characters' array, just as for a normal
3158    font, except that each item has only two keys:
3160      "width"    -- the tfm width (as stored in the .vf)
3161      "commands" -- an array of virtual font commands for a character.
3163    each of the items in the 'commands' array is itself a tiny hash.
3165    Each of those mini-hashes represents a single character packet
3166    command. Here is a 'commands' entry that contains every possible
3167    one at least once:
3169      "commands" = {
3170         {"push"},                     -- remember where we are
3171         {"right", 5000},              -- move right 0.08pt
3172         {"font", 1},                  -- select the fonts[1] entry
3173         {"setchar", 97},              -- place character 97 'a'
3174         {"pop"},                      -- go all the way back
3175         {"down", -200000},            -- move *up* about 3pt
3176         {"special", "pdf: 1 0 0 rg"}  -- switch to red color
3177         {"rule", 500000, 20000}       -- draw a bar
3178         {'special',"pdf: 0 g"}        -- back to black
3179       }
3182 * But the big news is that you can now define your own virtual fonts
3183    on the fly, by adding a few statements to the table returned to
3184    the 'define_font' callback.
3186    There are a few requirements:
3188    - The table has to have a top-level key 'type', and it's value
3189      must be 'virtual'.
3191      The presence of this key with the specific value 'virtual'
3192      will trigger handling of the rest of the special virtual font
3193      fields in the table, but the mere existance of 'type' is
3194      enough to prevent luatex from looking for a virtual font
3195      on its own.
3197      Therefore, this also works 'in reverse': if you are absolutely
3198      certain that a font is not a virtual font, assigning the value
3199      'base' or 'real' to 'type' will inhibit tex from looking for a
3200      virtual font file, thereby saving you a disk search.
3202    - There must be a top-level 'fonts' array, as explained above.
3203      Any fonts that are not yet known to luatex at that moment,
3204      will be loaded automatically (Warning: do not ever use a font
3205      in 'fonts' with the same name you will return in the table you
3206      are defining right now!).
3208    - Each and every character in the fonts needs to have a 'commands'
3209      key, as explained above.
3211    The main point behind these restrictions is that a font is
3212    *either* a base font *or* a virtual font. It cannot be both
3213    at the same time.
3216 ==============================================================
3217 Luatex snapshot-20070126 was released 20070126
3218 ==============================================================
3221 * Underscores in pascal identifiers are now retained.
3223    This took quite a bit of work. The web2c conversion tools
3224    needed only small adjustments, but most of the existing C
3225    code depended on the removal of the underscores. I had to
3226    go through changing many lines. 99% of all identifiers are
3227    now written the same on the pascal side as on the C side.
3228    This makes writing interface code quite a bit less confusing.
3230    Not everything is completely clean yet, because I did
3231    not want to change the web2c-specific C files. I often
3232    took the other approach and removed the underscores
3233    from the web2c options (like 'parsefirstlinep') in the
3234    change file instead. Ugly, but predictable.
3236    There is about a dozen or so of #defines left, that map
3237         memoryword -> memory_word
3238          strpool    -> str_pool
3239    etc.
3241 * The virtual font parsing and interpreting is now done in C.
3242    (this is because it needs to be interfaced with the lua-based
3243    font loader)
3245 * I am in the process of merging: the VF stuff; the TFM stuff;
3246    the lua font loading; and the pdftex font backend into one
3247    interface, so there were some smallish changes relating to
3248    that as well. Nothing worth mentioning just yet except that
3249    luatex now will read "ovf" files as well as "vf" files.
3251 * There are a few really small bugfixes for bug reports I received
3252   on this list and by email.
3254 ==============================================================
3255 Luatex snapshot-20070119 was released 20070119
3256 ==============================================================
3258 The largest new bit is the existence of a font.fonts array, that you
3259 can use to query/adjust the internal defined tex fonts. See the manual
3260 for more details.
3262 Two small new lua extensions are added as well:
3264    * os.setenv() -- to change the environment
3265    * os.exec()   -- a non-returning os.execute()
3267 And a bit of cleanup in the commandline processing.
3270 ==============================================================
3271 Luatex snapshot-20070117 was released 20070117
3272 ==============================================================
3274 * the pdftex core is updated to 1.40.1, and web2c to 7.5.6
3276 * the pdftex-specific documentation is removed
3278 * lua lpeg library updated to 0.4
3279    ( http://www.inf.puc-rio.br/~roberto/lpeg.html )
3281 * the C part of the lua md5 library is added to the binary
3282    ( http://www.inf.puc-rio.br/~roberto/md5/md5-5/md5.html )
3284 * --luaonly now puts the script itself at arg[0], and
3285    preceding commandline items in the negative indices
3286    (instead of starting the count at zero).
3287    This new approach is compatible with the standalone lua
3288    interpreter.
3291 ==============================================================
3292 Luatex snapshot-20070107 was released 20070107
3293 ==============================================================
3295 Hot on the heels of 20070105, a new snapshot. It turns out
3296 that using the callback to define a font broke all ligatures.
3297 This snapshot fixes that, and it has a few minor updates to
3298 the manual. Next shapshot will be after the inclusion of
3299 pdftex 1.40.1.
3301 ==============================================================
3302 Luatex snapshot-20070105 was released 20070105
3303 ==============================================================
3305  * the calculations that converted lua strings into tex units
3306    were horrendously wrong, this was discovered by Pawel.
3308  * io.lines() was still using the old, line ending sensitive,
3309    code from the lua core distribution
3311  * The main font memory is allocated as needed^(1) instead of
3312    statically pre-allocated.
3314  * ligatures and kerns are separated completely from each other,
3315    so use of \noligatures no longer inhibits kerning as well
3317  * Metrics can be loaded using a callback: 'define_font'.
3318    The value returned should be a lua table representing a tfm
3319    file.
3321  * there is a new lua table: font. It has one function:
3322    font.read_tfm() that returns a table reprentation of the tfm
3323    contents, for use with the above mentioned callback
3325  * I dropped suppport for "Level 1" OFM files. I would like
3326    to have a try at those extended font files, but I lack
3327    examples (fonts nor documents). I am not even sure such
3328    fonts have ever existed in the 'real world'.
3332 ==============================================================
3333 Luatex snapshot-20061208 was released 20061208
3334 ==============================================================
3336 * There is a new switch: --safer. This disables a number of lua
3337    functions that are more or less dangerous (a detailed list is
3338    in the manual)
3340 * Two longstanding bugs have been fixed: \latelua works once
3341    again (patch by Hartmut) and a bug that caused mysterious crashes
3342    turned out to be a problem inside the paragraph builder
3343    (reconstitution of ligatures)
3345 * Six new string iterators have been added to the string library:
3346       string.characters        (one 1-letter string)
3347       string.bytes             (one byte)
3348       string.characterpairs    (two 1-letter strings)
3349       string.bytepairs         (two bytes)
3350       string.utfcharacters     (a one-character utf-8 string)
3351       string.utfvalues         (a unicode code point number)
3353 * The top 256 values of the unicode range (starting at hex
3354    value "10FF00) are now reserved for byte output. Characters
3355    in that range will be written by luatex after substracting
3356    that offset. The net result is that \char"10FFA9 is written
3357    as byte value hex A9 = decimal 169 = copyright sign in latin1
3359    This trick allows byte-oriented output to \pdfliterals and
3360    \specials, but should be considered very experimental.
3362 * There is a new callback called 'process_input_buffer' that can
3363     be used to mutate the line buffer just before LuaTeX actually
3364     starts looking at it.
3366 * The statistics table now has readable items
3367         statistics.inputid
3368         statistics.lasterrorstring
3369     that represent TeX's current input id and the last error string
3371 * The show_error_hook callback no longer receives any arguments
3372 * There is a new switch: --safer. This disables a number of lua
3373    functions that are more or less dangerous (a detailed list is
3374    in the manual)
3376 * Two longstanding bugs have been fixed: \latelua works once
3377    again (patch by Hartmut) and a bug that caused mysterious crashes
3378    turned out to be a problem inside the paragraph builder
3379    (reconstitution of ligatures)
3381 * Six new string iterators have been added to the string library:
3382       string.characters        (one 1-letter string)
3383       string.bytes             (one byte)
3384       string.characterpairs    (two 1-letter strings)
3385       string.bytepairs         (two bytes)
3386       string.utfcharacters     (a one-character utf-8 string)
3387       string.utfvalues         (a unicode code point number)
3389 * The top 256 values of the unicode range (starting at hex
3390    value "10FF00) are now reserved for byte output. Characters
3391    in that range will be written by luatex after substracting
3392    that offset. The net result is that \char"10FFA9 is written
3393    as byte value hex A9 = decimal 169 = copyright sign in latin1
3395    This trick allows byte-oriented output to \pdfliterals and
3396    \specials, but should be considered very experimental.
3398 * There is a new callback called 'process_input_buffer' that can
3399     be used to mutate the line buffer just before LuaTeX actually
3400     starts looking at it.
3402 * The statistics table now has readable items
3403         statistics.inputid
3404         statistics.lasterrorstring
3405     that represent TeX's current input id and the last error string
3407 * The show_error_hook callback no longer receives any arguments
3409 * The statistics table now has readable items
3410         statistics.luabytecodes
3411         statistics.luastates
3412         statistics.luabytecode_bytes
3413         statistics.luastate_bytes
3414    for memory statistics reporting
3417 * The statistics table now has readable items
3418         statistics.luabytecodes
3419         statistics.luastates
3420         statistics.luabytecode_bytes
3421         statistics.luastate_bytes
3422    for memory statistics reporting
3425 ==============================================================
3426 Luatex snapshot-20061204 was released 20061204
3427 ==============================================================
3429 * The LuaTeX interpreter can now be run as a standalone lua script
3430   processor, by using a commandline like this:
3432     luatex --luaonly=luatools.lua
3434 * Luafilesystem (http://www.keplerproject.org/luafilesystem/ ) is
3435   included.
3437 * There are a total of eight new file discovery callbacks:
3438     find_vf_file
3439     find_ocp_file
3440     find_map_file
3441     find_enc_file
3442     find_sfd_file
3443     find_pk_file
3444     find_data_file
3445     find_opentype_file
3446   this enhances the orthogonality of the callback system, nothing
3447   fundamental is changed.
3449 * There is a new callback called 'process_input_buffer' that can
3450   be used to mutate the line buffer just before LuaTeX actually
3451   starts looking at it.
3453 * The 'reader' and 'close' functions from 'open_read_file' now
3454   receive the table they are defined in as a function argument,
3455   that can be used as a per file localized data store.
3457 * Updated the Lua to the latest 5.1.1, with all known bug patches
3458   from the website applied as well
3460 * Runtime autoloading of lua .so files is now off on all platforms.
3462 * The statistics table now has readable items
3463     statistics.filename
3464     statistics.linenumber
3465   that represent TeX's current file name and line number
3467 * The support for user-defined type3 font .pgc files and the
3468   associated 'read_miscfonts_file' callback has been removed.
3469   (nobody used it anyway)
3471 * General cleanups to the source tree and build process.
3473 ==============================================================
3474 Luatex snapshot-20061023 was released 20061023
3475 ==============================================================
3477 * there was a missing callback: find_font_file
3478 * program_invocation_name was not set
3479 * buf_size could not be more that 300k
3482 ==============================================================
3483 Luatex snapshot-20061013 was released 20061013
3484 ==============================================================
3486 Last friday I uploaded a new snapshot and today I finally
3487 finished updating the manual to go with it. The changes all
3488 relate to startup, file i/o, and callbacks. The main achievement
3489 is: you can now run luatex without it *ever* initializing kpathsea.
3491 Because I am lazy, I have checked in the pdf of the manual
3492 as well, so that I can say: Please look at
3494   https://foundry.supelec.fr/plugins/scmsvn/viewcvs.php/manual/
3495     /luatexref-t.pdf?root=luatex&rev=148&view=log
3497 for all the details.  :-)
3499 ==============================================================
3500 Luatex snapshot-20061002 was released 20061002
3501 ==============================================================
3504 * Some infrastructure changes:
3506   libs/slnunicode-0.9.1/ renamed to libs/slnunicode/
3507   libs/zziplib added
3508   libs/luazip added
3510   (zziplib is using a different version of autofoo. I know I have
3511   messed up something in the build process, but the bit we need
3512   compiles ok so I've postponed attempting to fix it)
3514 * The callback logic has changed quite a bit.
3516   - all callbacks are now only possible in lua state 0.
3518   - The callback 'input_line' has disappeared, and is replaced by
3519     'open_read_file'. One of the return values of that callback
3520     is a table that defines a 'reader' function for line reading.
3522     See the manual for further information on this.
3524   - There are some new callbacks for the reading of various binary
3525     files. The current ones are:
3527     "read_ocp_file", "read_vf_file", "read_data_file", "read_font_file",
3528     "read_map_file".
3530     The rest of the file types will follow soon (fonts, enc files, and
3531     images).
3533   - There are also some new callbacks that 'find' a file's pathname:
3535     "find_truetype_file", "find_type1_file", "find_image_file"
3537     here too, more will follow later.
3539   - the functions from io. that were copied to texio have been removed
3540     again. The new callbacks do not pass file pointers around, so
3541     they ere not longer needed
3543   - the 'open_write_file' is temporarily unavailable
3545 * startup.lua is now always loaded into lua state 0
3547 * The luazip library from kepler is linked in, so there the table 'zip'
3548   is accessible from all lua states.
3550 ==============================================================
3551 Luatex snapshot-20060922 was released 20060922
3552 ==============================================================
3554 * The texio table has gained a new function:
3556      tex_file = texio.open(filename)
3558    returns a file handle of a type that luatex can use
3559    internally (the return of io.open is unusable in callbacks
3560    because it will be garbage-collected at a random time)
3563 * In related news, there are two new callbacks you can define:
3565         callback.register('open_read_file', f)
3566         callback.register('open_write_file', f)
3568    where your function should have the following conventions:
3570    function f (number id_number, string asked_name)
3571       return boolean success, string actual_name, tex_file filep
3572    end
3574    id_number:   zero for the log or \input files  or TeX's \read
3575                 number incremented by one (\read0 becomes 1).
3576    asked_name:  the user-supplied filename
3578    success:     return false for error, true otherwise.
3580    The remaining two items are only looked at if you return true:
3582    actual_name:  the true filename used (with extension!)
3583    filep:        a file object opened though texio.open()
3586 * The tex.print function has an extra optional parameter:
3588        tex.print(ctt_id n, strings ...)
3590    This prints the strings using the catcode regime defined by
3591    \catcodetable n (assuming n is valid, see below)
3593 * The new function tex.sprint has the same lua conventions as
3594    tex.print, but behaces slightly different on the tex side:
3596    ** tex does not switch to the 'new_line' state (this implies
3597       that leading spaces are not ignored)
3598    ** no \endlinechars are inserted
3599    ** trailing spaces are not removed from the argument
3601 * Catcode tables are a completely new feature, that allows
3602    you to switch the current catcode regime in one simple
3603    statement:
3605    \catcodetable <count>
3607       Switches to the use of a different set of catcodes (table),
3608       that is stored under the number <count>. Such a table has to
3609       be previously created using one of the two command below, or
3610       the number 0 (which is pre-inititialized)
3612       This command obeys normal grouping rules.
3614    \initcatcodetable <count>
3616       creates a new, global, independent catcode table with catcodes
3617       matching the code that are predefined by initex (tex -ini).
3619      This allocation is global
3621    \savecatcodetable <count>
3623       copies the current set of catcodes to a new, global, table
3624       with id number <count>. The definitions in this new table
3625       are all treated as if they were made in the outermost level.
3627      This allocation is global
3629    At the end of each grouping level, items within all existing
3630    catcodetables are restored, regardless of which one is the
3631    currently active table.
3633    Catcode table numbers cannot be larger than 0xFFFFFFF (228-1)
3635 * There is a new lua table: lua. It contains three read-only
3636    items:
3638      lua.id          -- the id number of the instance
3639      lua.version     -- a luatex version identifier string
3640      lua.startupfile -- the full filename (+path) of startup.lua
3642    and it also contains a read/write array:
3644      lua.bytecode[]  -- lua executable bytecode
3646    This array can be used to save and restore lua functions
3647    across lua states. The accepted values are for assignments
3648    are functions and nil. Likewise, the retrieved value is
3649    either a function or nil.
3651    The contents of the lua.bytecode array is stored inside the
3652    format file, so it can also be used to preload lua code.
3655 * The format files are quire a bit smaller than before
3658 ==============================================================
3659 Luatex snapshot-20060915 was released 20060915
3660 ==============================================================
3662 * There is a new TEX primitive: \formatname. It is similar
3663   to \jobname (read-only). In initex, the expansion is empty,
3664   otherwise the expansion is the same as the \jobname from
3665   the initex run.
3667 * the lua "tex" table has been expanded with a few of the 'convert'
3668   codes (read-only). The supported ones at this moment are:
3670   tex.eTeXVersion
3671   tex.OmegaVersion
3672   tex.AlephVersion
3673   tex.pdftexrevision
3674   tex.pdftexbanner
3675   tex.pdfnormaldeviate
3676   tex.jobname
3677   tex.formatname
3678   tex.eTeXrevision
3679   tex.Omegarevision
3680   tex.Alephrevision
3682   This list looks haphazard,  but it really is not. These are
3683   all the cases of the 'convert' internal command that do not
3684   require an argument.
3686 * The metatables of the subtables like tex.dimen[] etc. are now
3687   adjustable from lua (not that I recommend doing that;-)).
3689 * On the lua side, there is a new global value: "luaid"
3690   It holds the internal id number of this \directlua instance.
3692 * There is a new lua table, "callback", that has the single function
3693   "callback.register", used to register callbacks.   This replaces
3694   the previous concoction (see my message about snapshot 20060901).
3695   Syntax is :
3697   callback.register(<callback name>,function (f) ... end)
3699   where the <callback name> is for the moment, either "input_line"
3700   or "show_error_hook".
3702   This function internalizes the callback function in such a way
3703   that you no longer have to worry about \luacallback (which has
3704   been removed), nor does it matter if you redefine a function
3705   accidentally.
3707  The internal testing for callback presence is also quite a bit
3708  faster, thanks to this change. Callback assignments are global
3709  and the "input_line" always takes effect starting on the next
3710  input line to be read from an actual file.
3713 * \detokenizedlua has been removed. It is functionally replaced by
3714   the new function call tex.write("").
3716   Each argument to each call of tex.write () counts as an input
3717   line, but:
3718   ** all catcodes on that line are either 'space' (for " ") or
3719      'character' for all others.
3720   ** there is no \newlinechar appended.
3722 * The implementation of tex.print() has changed as well:
3724   ** the very last tex.print() line from a \directlua
3725      will no longer have a trailing \newlinechar
3726      (this is very convenient when \directlua is used
3727      within an \edef)
3728   ** tex.print() is quite a lot faster than before, and the total amount
3729      of returnable text from a \directlua is now only limited by
3730      available system RAM. However, each separate tex.print ()
3731      argument has to fit in TeX's input buffer.
3733 * The new primitive \luastartup can be set inside the format file
3734   to specify the lua instance number in which a possible runtime
3735   startup.lua script is executed (initex always uses 0)
3737 * There is a new primitive \scantextokens. Differences with
3738   eTeX's \scantokens are:
3740   ** the last line (usually only) from \scantextokens
3741      does not have a \newlinechar
3743   ** \scantextokens never raises an eof error.
3745   This means things like
3747   \edef\testone
3748         {\scantextokens{\ifnum1=1 true}\else false\fi}
3750   are legal input (but potentially dangerous!).
3752 * If you say
3753      local d  = tex.dimen["unknowndimen"]
3754   'd' will now become "nil" instead of raising an error
3756    However,
3757      tex.dimen["unknowndimen"] = d
3758    is still (and probably will remain) illegal
3760 ==============================================================
3761 Luatex snapshot-20060908 was released 20060908
3762 ==============================================================
3764 * BIG CHANGE: \directlua now runs \scantokens internally.
3766   There is no longer a need to call scantokens yourself, the
3767   tex.print() output is now fed straight into a pseudo file.
3768   This is quite a bit faster as well as easier to use, but
3769   just in case you want it, the old behaviour is still present,
3770   under the new name
3772     \detokenizedlua
3775 * The texio library now has its own (partial) set of I/O commands,
3776   so that the standard lua io library is back to the distributed
3777   state (no more patched garbage collector)
3779   Note: This is really a very small change (it should not have any
3780   impact on wellbehaved input files), but I attempt to be complete
3781   in these notes, since there is no official documentation yet.
3784 * There is a new standard library available: kpse
3786   The most important function in that library is find_file:
3788     string = kpse.find_file(string filename
3789                             [,string type]
3790                             [,boolean mustexist])
3792   both "type" and "mustexist" are optional, so the function
3793   has from one upto three arguments.
3795   "type" is like the '-format' argument of kpsewhich. You can
3796      run 'kpsewich -h'  for a list. The default type is "tex".
3798   "mustexist" is like '-must-exist', and the default  is false.
3799      If you specify "true" (or a nonzero integer), then the kpse
3800      library will search the disk as well as the ls-R databases
3802   The new library also has three other functions that map
3803   straight to kpsewhich commandline options:
3805     string = kpse.expand_path(string)
3806     string = kpse.expand_var(string)
3807     string = kpse.expand_braces(string)
3809 * There is a second callback possibility:
3811     texio.show_error_hook(string message,
3812                           string|number indicator,
3813                           number lineno)
3815   This command is run from inside the TeX error function, and the
3816   idea is to allow you to do some extra reporting on top of what
3817   TeX already does (none of the normal actions are removed).
3819   "message" is the formal error message tex has given to the
3820      user (the line after the "! ")
3821   "indicator" is either a filename (when it is a string) or a
3822      location indicator (a number) that can means lots of different
3823      things like a token list id or a \read number.
3824   "lineno"  is the current line number
3826   This is an investigative item only, comments are welcome but do
3827   not take the syntax seriously.
3829   The final goal IMO is the total replacement of TeX's error
3830   handling routines, but that needs lots of adjustments
3831   in the web source because TeX deals with errors in a somewhat
3832   haphazard fashion (it needs unification first). The current
3833   hook is only for 'testing the water'.
3835 * It is now possible to use named items in the
3837     tex.count[]
3838     tex.dimen[]
3839     tex.toks[]
3841   subtables, so you can have
3843     tex.count.scratchcounter = 0
3844         local enormous = tex.dimen["maxdimen"]
3846   Luatex looks up the value for you on the fly. You have to use a
3847   valid \countdef (or \dimendef, or \toksdef), anything else will
3848   generate an error.
3850   In a normal TeX file, you don't do \dimen\maxdimen, but the
3851   lua syntax seems to be a bit cleaner to me. The intention is
3852   to evntually also allow \chardefs and macros that expand
3853   into a number (todo)
3856 * The tex table has also been extended with a large list of internal
3857   parameters (partially read/write). It is possible to access
3858   about every primitive that you can use after \the *and* is a
3859   single token. So there is
3861        integer   = tex.tracingcommands (\the\tracingcommands)
3862        integer   = tex.prevgraf        (\the\prevgraf)
3863        string    = tex.output          (\the\output)
3865   etc. for all of the internal parameters, but not the items
3866   that need extra arguments (like \the\scriptfont )
3868   The subset comprising simple integer and dimension registers
3869   are writable as well as readable (stuff like \tracingcommands
3870   and \parindent).
3872   The fact that both lists are still quite limited is a result of
3873   the very different types of things that can occur after \the and
3874   also on the LHS of an assignment. The remaining primitives will
3875   be filled in when there is a real need or implementation becomes
3876   simple, whichever comes first.
3880 ==============================================================
3881 Luatex snapshot-20060901 was released 20060901
3882 ==============================================================
3884 All changes are related to lua this time, and most are quite unstable
3885 / experimental. But first the things that are stabel/fixed bugs:
3887 * A VF loading bug that turned up in some of Hans' fonts
3888   has been fixed
3890 * A small series of bounds checking fixes to \ocplist has been
3891   added to prevent the system from crashing due to array indexes
3892   running out of bounds.
3894 * The Lua file searching paths are now fixed. The search path for lua
3895   script files now contains the following items (tried in order)
3896   1. the local directory:
3897        ./?.lua
3898     (for document-specific files)
3899   2. the items from the expansion of kpathsea's $TEXMFSCRIPTS variable,
3900     but only the parts containing 'lua' as a subpath:
3901        $TEXMFSCRIPTS<lua>/?.lua
3902        $TEXMFSCRIPTS<lua>/?/init.lua
3903      (for format-specific files)
3904   3. the $SELFAUTOPARENT sibling directory named 'lib'.
3905        $SELFAUTOPARENT/lib/lua/5.1/?.lua
3906        $SELFAUTOPARENT/lib/lua/5.1/?/init.lua
3907      (for files that are not related to tex)
3909   The search path for dynamic libraries has only
3910   1. the local directory:
3911        ./?.so
3912     (for document-specific files)
3913   2. and the $SELFAUTOPARENT sibling directory named 'lib'.
3914        $SELFAUTOPARENT/lib/lua/5.1/?.so
3916   (of course the extension is .dll on windows, but .dlls do not
3917    work at the moment so it will not do you much good)
3919 * There are two functions available within a new table called
3920   texio:
3921     texio.write (luastring)
3922     texio.write_nl (luastring)
3923   both write the luastring to the same location(s) TeX writes
3924   its stuff. So if \batchmode is on, it writes only to the
3925   log, inside a \write, it prints to the current write file,
3926   etc.
3928   A read|write interface to TeX's "file selector" will
3929   follow shortly.
3931 * At startup, luatex searches for a script named
3932     startup.lua
3933   in the path list I explained above. If such a file exists, it is
3934   loaded.
3936   This happens right before the first input file needs to be opened
3937   (that is after format loading, but before any \everyjob tokens).
3939   From within the script, you can check the value of
3941     tex.formatname
3943   that is the 'format identification' as used by TEX. When the variable
3944   is equal to nil, luatex in in 'initex' mode, otherwise it will be
3945   something like: " (format=plain 2006.9.1)"
3948 Now for the experimental portion: callbacks. Here is what I have done
3949 so far:
3951 * The main reason for wanting startup.lua is file (input) re-encoding.
3952   For this purpose, it is now possible to set up a callback for
3953   luatex to execute.
3955   If you attach a Lua function to
3957     texio.input_line
3959   then from the next input line onwards, luatex will run that
3960   function whenever it needs a new input line from a text file.
3962   Your function will receive a file handle as argument, and
3963   should return either a string or nil (with nil signalling that
3964   the end of file has occurred).
3966   The trivial case is simply this:
3968     function reader (f)
3969         return f:read()
3970     end
3971     texio.input_line = reader
3974   Warning: The implementation is not totally finished yet. For the
3975   moment the file handle ("f" in the example) is a normal lua file,
3976   with a simple but important restriction: you cannot alter its value.
3977   You cannot f:close() it, or assign it a different value. luatex
3978   will eventually close the file itself.
3980   The restriction is a side-effect of a synchronisation problem with
3981   the lua garbage collector. Because of this, it also was necessary
3982   to turn off the automatic file closing code for normal lua io
3983   files (In other words: you have to close yourself all the files
3984   you opened yourself, and you should not close any files you did
3985   not open yourself).
3987   In the near future, "f" will become a special 'texio' file object
3988   and the needed functionality from the normal io library will be
3989   reimplemented. Along with that change, there will also be a callback
3990   to open (i.e. find) files, and a simple interface to the compiled-in
3991   kpathsea to use within that callback.
3994 ==============================================================
3995 Luatex snapshot-20060825 was released 20060825
3996 ==============================================================
3998 The main change in this snapshot is that it uses far less memory.
3999 luatex -ini on my linux machine went from 326Mb (last week) to
4000 93Mb (now), and "texexec luatex" now ends at 184Mb instead of
4001 over 1/2Gb.
4003 This is achieved by two big changes:
4005 * The \mathcode, \delcode, \catcode, \sfcode, \lccode and \uccode
4006    tables are now sparse arrays that are implemented in C. They
4007    are no longer part of the TeX "equivalence table" and because
4008    each had 1.1 million entries with a few memory words each, this
4009    makes a major difference.
4011    See mathcodes.c and textcodes.c if you are interested in the
4012    gory details, but be warned: the code is still extremely
4013    rough and ugly. In particular, the dump and undump routines
4014    are far from optimal, resulting in somewhat larger format files
4015    than before (approx 1.3Mb larger with unicode-letters loaded,
4016    10k without); and the assignments do not show up when using
4017    the etex tracing routines \tracingassigns and \tracingrestores
4018    (code simply not written yet)
4020 * Single-character commands are no longer "special" internally,
4021    they are stored in the hash just like the multiletter csnames.
4024 ==============================================================
4025 Luatex snapshot-20060818 was released 20060818
4026 ==============================================================
4028 The snapshot is up to par with Aleph-RC4 (from texlive devel)
4029 and the latest pdftex beta (even newer than 20060811). However,
4030 there are some differences, to summarize:
4032 * There is no pool file (all strings are embedded)
4034 * -8bit and -translate-file are silently ignored
4036 * There is no mltex nor enctex (conflicts with aleph)
4038 * The tex functionality is always present and enabled
4039   (but see below about TeXXeT), so the asterisk or
4040   -etex switch for initex is not needed
4042 * "plus 1 filllllllll" does not generate any errors from TeX
4044 * TeXXeT (from eTeX) is not present, so the primives
4045     \TeXXeTstate
4046     \beginR
4047     \beginL
4048     \endR
4049     \endL
4050   are missing
4052 * The experimental pdftex regex match operations are removed,
4053   because that feature does not make much sense when lua is
4054   available so the primitives
4055         \pdfmatch
4056     \pdflastmatch
4057   are missing
4059 * The input translations from Aleph are not implemented, the
4060   16 related primitives are all missing
4061      \DefaultInputMode
4062      \noDefaultInputMode
4063      \noInputMode
4064      \InputMode
4065      \DefaultOutputMode
4066      \noDefaultOutputMode
4067      \noOutputMode
4068      \OutputMode
4069      \DefaultInputTranslation
4070      \noDefaultInputTranslation
4071      \noInputTranslation
4072      \InputTranslation
4073      \DefaultOutputTranslation
4074      \noDefaultOutputTranslation
4075      \noOutputTranslation
4076      \OutputTranslation
4077   All file IO assumes UTF-8, except that all the low-ascii
4078   controls except TAB, CR en LF are written to the terminal
4079   using ^^  notation (even these are binary in the log file).
4081 * Input characters can use the full range of Unicode,
4082   but it probably only makes sense to use values above
4083   the base plane for \mathcode and \catcode assignments,
4084   since the fonts as well as the hyphenation patterns
4085   are strictly 16-bit still.
4087 * The primitives
4088      \pdfpagewidth and \pagewidth,
4089      \pdfpageheight and \pageheight,
4090      \fontcharwd and \charwd,
4091      \fontcharht and \charht,
4092      \fontchardp and \chardp,
4093      \fontcharic and \charic,
4094   are all aliases of eachother.
4096 * The new primitive
4097      \clearmarks<number>
4098   clears a marks class completely.
4100 * The experimental pdftex primitives
4101      \pdfprimitive
4102      \ifpdfprimitive
4103      \ifpdfabsnum
4104      \ifpdfabsdim
4105   and provided without the extra 'pdf' prefix, so they are
4106   simply called
4107      \primitive
4108      \ifprimitive
4109      \ifabsnum
4110      \ifabsdim
4111   instead.
4113 * I probably forgot to mention some things :-)