diff options
author | Karl Berry <karl@freefriends.org> | 2010-05-28 15:54:16 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2010-05-28 15:54:16 +0000 |
commit | 7db7ee076f98cc2b3dca7228ae0e38ba4e88715a (patch) | |
tree | c15a7028a935446f0d5dcce2b5008a6f24e2242f /Master/texmf-dist/doc/luatex | |
parent | ae29f8fd830ee6798b80ee088fdd0c92b1a215f4 (diff) |
luatexbase update (27may10)
git-svn-id: svn://tug.org/texlive/trunk@18560 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/luatex')
15 files changed, 42 insertions, 43 deletions
diff --git a/Master/texmf-dist/doc/luatex/luatexbase/Changes b/Master/texmf-dist/doc/luatex/luatexbase/Changes index 8e3be94fc07..ce253fecdde 100644 --- a/Master/texmf-dist/doc/luatex/luatexbase/Changes +++ b/Master/texmf-dist/doc/luatex/luatexbase/Changes @@ -1,5 +1,14 @@ Changes in the luatexbase package/bundle +2010/05/27 v0.2a + attr + - allocate from 1 to avoid problems with some external code + - provide a Lua interface: new_attribute() and unset_attribute(). + modutils + - fix bug with module require_module()-ed many times. + luatexbase + - new, loads: compat,loader,regs,attr,cctb. + Summary of backwards-incompatible interface changes between 0.1 and 0.2: - Lua objects are now in table luatexbase, not luatextra. - Lua tables tex.attributenumber and tex.catcodetablenumber are not diff --git a/Master/texmf-dist/doc/luatex/luatexbase/README b/Master/texmf-dist/doc/luatex/luatexbase/README index 100f8c584ac..f81c990bdce 100644 --- a/Master/texmf-dist/doc/luatex/luatexbase/README +++ b/Master/texmf-dist/doc/luatex/luatexbase/README @@ -1,56 +1,46 @@ The luatexbase generic bundle -luatexbase provides basic resource management, similar to the way TeX -resources are handled by Plain TeX and LaTeX, for new resources introduced by -LuaTeX. +The bundle provides basic facilities for LuaTeX macro programmers, mostly +resource allocation and convenience packages. Provided are: -Each resource is handled in a separate package. +– luatexbase-compat: compatibility helpers; +– luatexbase-loader: Lua module loading; +– luatexbase-regs: allocation of registers and the like; +– luatexbase-attr: attribute allocation; +– luatexbase-cctb: catcode table allocation; +– luatexbase-modutils: Lua module declaration; and +- luatexbase-mcb: callbacks extensions. -The resources considered are: -- registers (\count, \box, etc.) -> luatexbase-regs -- Lua module loading -> luatexbase-loader -- \attribute's -> luatexbase-attr -- \catcodetable's -> luatexbase-cctb -- Lua callbacks -> luamcallbacks - -Additional convenience packages: -- Lua module declaration -> luatexbase-modutils -- compatibility helpers -> luatexbase-compat - -WARNING: these packages are subject to change or even be merged or disappear in -the near future! +Additionally, a `luatexbase' package loads all of the above in one step (and +does nothing else) for your convenience. Installation ------------ Here are the recommended installation methods (preferred first). -(Methods "commented out" are not available right now.) -% 1. If you are using TeX Live 2009 or later, use 'tlmgr install luatexbase'. -% Alternatively, try your (TeX or Linux) distribution's package management system. -% -% 2. a. Grab luatextra.tds.zip on the CTAN. -% b. Unzip it at the root of one or your TDS trees. -% c. You may need to update some filename database after this, see your TeX -% distribution's manual for details. +1. If you are using TeX Live 2010 or later, use 'tlmgr install luatexbase'. +Alternatively, try your (TeX or Linux) distribution's package management system. + +2. a. Grab luatextra.tds.zip on the CTAN. + b. Unzip it at the root of one or your TDS trees. + c. You may need to update some filename database after this, see your TeX + distribution's manual for details. (Hint: with TeX Live, run 'mktexlsr'; + with MikTeX, look for "Refresh FNDB" in the MikTeX menu.) 3. a. Grab the sources from CTAN or github. b. Run 'make install TEXMFROOT=/path/to/texmf'. + (Warning: 'make install' without giving a TEXMFROOT will + put files in './texmf', which is probably not what you want.) c. See 2c. -4. Try to figure it out by looking at the Makefile and comments in the sources. - - License ------- -This work and the derived files are under the Creative Commons CC0 license. - -See the full text at - -http://creativecommons.org/publicdomain/zero/1.0/legalcode - -and a FAQ at +This work and the derived files are under the Creative Commons CC0 license, +which is as close to public domain as possible in the country of the authors. +See the full text [1] or the FAQ [2]. -http://wiki.creativecommons.org/CC0 +[1]: http://creativecommons.org/publicdomain/zero/1.0/legalcode +[2]: http://wiki.creativecommons.org/CC0 diff --git a/Master/texmf-dist/doc/luatex/luatexbase/TODO b/Master/texmf-dist/doc/luatex/luatexbase/TODO index 556c5d2ea5c..a7e62206c71 100644 --- a/Master/texmf-dist/doc/luatex/luatexbase/TODO +++ b/Master/texmf-dist/doc/luatex/luatexbase/TODO @@ -1,4 +1,4 @@ -loader: kpse emulation is still wrong, see kpathsea's manual 4.2 +attr: \newluatexattribute -> \newattribute modutils -------- @@ -20,12 +20,6 @@ mcb - General review of code and comments. - Update user documentation. -luatexbase ----------- - -- create it, make it load the others (except maybe mcb for now) -- create general documentation - afterwards ---------- diff --git a/Master/texmf-dist/doc/luatex/luatexbase/luatexbase-attr.pdf b/Master/texmf-dist/doc/luatex/luatexbase/luatexbase-attr.pdf Binary files differindex 8179ad2e487..ce5cc04ccf0 100644 --- a/Master/texmf-dist/doc/luatex/luatexbase/luatexbase-attr.pdf +++ b/Master/texmf-dist/doc/luatex/luatexbase/luatexbase-attr.pdf diff --git a/Master/texmf-dist/doc/luatex/luatexbase/luatexbase-cctb.pdf b/Master/texmf-dist/doc/luatex/luatexbase/luatexbase-cctb.pdf Binary files differindex e992827b145..1a6ff2fbea8 100644 --- a/Master/texmf-dist/doc/luatex/luatexbase/luatexbase-cctb.pdf +++ b/Master/texmf-dist/doc/luatex/luatexbase/luatexbase-cctb.pdf diff --git a/Master/texmf-dist/doc/luatex/luatexbase/luatexbase-compat.pdf b/Master/texmf-dist/doc/luatex/luatexbase/luatexbase-compat.pdf Binary files differindex 62b82063c26..eea31071cdc 100644 --- a/Master/texmf-dist/doc/luatex/luatexbase/luatexbase-compat.pdf +++ b/Master/texmf-dist/doc/luatex/luatexbase/luatexbase-compat.pdf diff --git a/Master/texmf-dist/doc/luatex/luatexbase/luatexbase-loader.pdf b/Master/texmf-dist/doc/luatex/luatexbase/luatexbase-loader.pdf Binary files differindex 13591dc9363..12268eac2e8 100644 --- a/Master/texmf-dist/doc/luatex/luatexbase/luatexbase-loader.pdf +++ b/Master/texmf-dist/doc/luatex/luatexbase/luatexbase-loader.pdf diff --git a/Master/texmf-dist/doc/luatex/luatexbase/luatexbase-mcb.pdf b/Master/texmf-dist/doc/luatex/luatexbase/luatexbase-mcb.pdf Binary files differindex c61b6c3b41c..ab8c549c8fe 100644 --- a/Master/texmf-dist/doc/luatex/luatexbase/luatexbase-mcb.pdf +++ b/Master/texmf-dist/doc/luatex/luatexbase/luatexbase-mcb.pdf diff --git a/Master/texmf-dist/doc/luatex/luatexbase/luatexbase-modutils.pdf b/Master/texmf-dist/doc/luatex/luatexbase/luatexbase-modutils.pdf Binary files differindex b0ff8000350..94c2f8a4f06 100644 --- a/Master/texmf-dist/doc/luatex/luatexbase/luatexbase-modutils.pdf +++ b/Master/texmf-dist/doc/luatex/luatexbase/luatexbase-modutils.pdf diff --git a/Master/texmf-dist/doc/luatex/luatexbase/luatexbase-regs.pdf b/Master/texmf-dist/doc/luatex/luatexbase/luatexbase-regs.pdf Binary files differindex 83b38997629..9d132c31e05 100644 --- a/Master/texmf-dist/doc/luatex/luatexbase/luatexbase-regs.pdf +++ b/Master/texmf-dist/doc/luatex/luatexbase/luatexbase-regs.pdf diff --git a/Master/texmf-dist/doc/luatex/luatexbase/luatexbase.pdf b/Master/texmf-dist/doc/luatex/luatexbase/luatexbase.pdf Binary files differnew file mode 100644 index 00000000000..7e58d051e10 --- /dev/null +++ b/Master/texmf-dist/doc/luatex/luatexbase/luatexbase.pdf diff --git a/Master/texmf-dist/doc/luatex/luatexbase/test-attr-latex.tex b/Master/texmf-dist/doc/luatex/luatexbase/test-attr-latex.tex index ac9bb4d7905..0885e7a2122 100644 --- a/Master/texmf-dist/doc/luatex/luatexbase/test-attr-latex.tex +++ b/Master/texmf-dist/doc/luatex/luatexbase/test-attr-latex.tex @@ -17,6 +17,8 @@ \unsetluatexattribute\testattr \catcode64 11 \luatexbase@directlua{assert(luatexbase.attributes.testattr)} +\luatexbase@directlua{luatexbase.new_attribute('luatestattr')} +\luatexbase@directlua{assert(luatexbase.attributes.luatestattr)} \begingroup \escapechar64 \newluatexattribute\anotherattr diff --git a/Master/texmf-dist/doc/luatex/luatexbase/test-attr-plain.tex b/Master/texmf-dist/doc/luatex/luatexbase/test-attr-plain.tex index b3a376474b1..050d53dfa1a 100644 --- a/Master/texmf-dist/doc/luatex/luatexbase/test-attr-plain.tex +++ b/Master/texmf-dist/doc/luatex/luatexbase/test-attr-plain.tex @@ -17,6 +17,8 @@ \unsetluatexattribute\testattr \catcode64 11 \luatexbase@directlua{assert(luatexbase.attributes.testattr)} +\luatexbase@directlua{luatexbase.new_attribute('luatestattr')} +\luatexbase@directlua{assert(luatexbase.attributes.luatestattr)} \begingroup \escapechar64 \newluatexattribute\anotherattr diff --git a/Master/texmf-dist/doc/luatex/luatexbase/test-modutils-latex.tex b/Master/texmf-dist/doc/luatex/luatexbase/test-modutils-latex.tex index 4785b3ac422..ece22be054b 100644 --- a/Master/texmf-dist/doc/luatex/luatexbase/test-modutils-latex.tex +++ b/Master/texmf-dist/doc/luatex/luatexbase/test-modutils-latex.tex @@ -12,6 +12,7 @@ %% See source file 'luatexbase-modutils.dtx' for details. %% \RequirePackage{luatexbase-modutils} +\luatexUseModule{test-modutils} \luatexRequireModule [1970/01/01] {test-modutils} diff --git a/Master/texmf-dist/doc/luatex/luatexbase/test-modutils-plain.tex b/Master/texmf-dist/doc/luatex/luatexbase/test-modutils-plain.tex index 4f3f564e8a9..f00ecc41b8d 100644 --- a/Master/texmf-dist/doc/luatex/luatexbase/test-modutils-plain.tex +++ b/Master/texmf-dist/doc/luatex/luatexbase/test-modutils-plain.tex @@ -12,6 +12,7 @@ %% See source file 'luatexbase-modutils.dtx' for details. %% \input luatexbase-modutils.sty +\luatexUseModule{test-modutils} \luatexRequireModule {test-modutils} {1970/01/01} |