From 80e5c6eed03712ab06c068b5e22f1808b99f0616 Mon Sep 17 00:00:00 2001 From: Philipp Gesang Date: Fri, 19 Oct 2012 23:49:10 +0200 Subject: update doc --- NEWS | 5 +++++ lualibs.dtx | 65 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++----- lualibs.lua | 54 ++++++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 119 insertions(+), 5 deletions(-) create mode 100644 lualibs.lua diff --git a/NEWS b/NEWS index 30e5e40..8b367bf 100644 --- a/NEWS +++ b/NEWS @@ -1,4 +1,9 @@ History of the lualibs package +2012/10/19 v0.9/ + * sync with ConTeXt beta 2012.10.17 + * move some files to util-* prefix + * add util-sto util-lua util-sto util-jsn + 2011/01/20 v0.96 * Fix computability with lfs in luatex 0.65 diff --git a/lualibs.dtx b/lualibs.dtx index cc3142a..e38e89f 100644 --- a/lualibs.dtx +++ b/lualibs.dtx @@ -33,7 +33,7 @@ \input docstrip.tex \Msg{************************************************************************} \Msg{* Installation} -\Msg{* Package: lualibs 2011/01/20 v0.96 Lua additional functions.} +\Msg{* Package: lualibs 2012/10/19 v0.97 Lua additional functions.} \Msg{************************************************************************} \keepsilent @@ -90,7 +90,7 @@ and the derived file lualibs.lua. %<*driver> \NeedsTeXFormat{LaTeX2e} \ProvidesFile{lualibs.drv} - [2011/01/20 v0.96 Lua additional functions.] + [2012/10/19 v0.97 Lua additional functions.] \documentclass{ltxdoc} \EnableCrossrefs \CodelineIndex @@ -120,7 +120,7 @@ and the derived file lualibs.lua. % \GetFileInfo{lualibs.drv} % % \title{The \textsf{lualibs} package} -% \date{2011/01/20 v0.96} +% \date{2012/10/19 v0.97} % \author{Elie Roux \\ \texttt{elie.roux@telecom-bretagne.eu}} % % \maketitle @@ -151,6 +151,61 @@ and the derived file lualibs.lua. % initialize \textsf{kpse} library so that |require()| can find files under % TEXMF tree: |kpse.set_program_name("luatex")|. % +% \section{Files} +% +% The \textsf{lualibs} bundle contains files from two Con\TeX t Lua +% library categories: The generic auxiliary functions (original file prefix: +% |t-|) together form something close to a standard libary. Most of these are +% extensions of an existing namespace, like for instance |l-table.lua| which +% adds full-fledged serialization capabilities to the Lua table library. +% They were imported under the \textsf{lualibs}-prefix. +% (For a list see table~\ref{tab:extensions}.) +% +% \begin{table}[h] +% \centering +% \caption{Extensions of the Lua standard library.} +% \begin{tabular}{l l l} +% \textsf{lualibs} name & Con\TeX t name & content \\ +% \hline +% lualibs-string.lua & l-string.lua & string manipulation \\ +% lualibs-lpeg.lua & l-lpeg.lua & patterns \\ +% lualibs-boolean.lua & l-boolean.lua & boolean converter \\ +% lualibs-number.lua & l-number.lua & bit set \\ +% lualibs-math.lua & l-math.lua & math functions \\ +% lualibs-table.lua & l-table.lua & serialization, conversion \\ +% lualibs-io.lua & l-io.lua & reading and writing files \\ +% lualibs-os.lua & l-os.lua & platform specific code \\ +% lualibs-file.lua & l-file.lua & filesystem operations \\ +% lualibs-md5.lua & l-md5.lua & checksum functions \\ +% lualibs-dir.lua & l-dir.lua & directory handling \\ +% lualibs-unicode.lua & l-unicode.lua & utf and unicode \\ +% lualibs-url.lua & l-url.lua & url handling \\ +% lualibs-set.lua & l-set.lua & sets \\ +% \end{tabular} +% \label{tab:extensions} +% \end{table} +% +% The second category comprises a selection of files mostly from the +% utilities namespace (|util-|; cf. table~\ref{tab:utilities}). +% Their purpose is more specific and at times quite low-level. +% +% \begin{table}[h] +% \centering +% \caption{Utility functions.} +% \begin{tabular}{l l l} +% \textsf{lualibs} name & Con\TeX t name & content \\ +% \hline +% lualibs-util-lua.lua & util-lua.lua & operations on bytecode \\ +% lualibs-util-sto.lua & util-sto.lua & table allocation \\ +% lualibs-util-mrg.lua & util-mrg.lua & merging lua sources \\ +% lualibs-util-dim.lua & util-dim.lua & converters for dimensions \\ +% lualibs-util-str.lua & util-str.lua & extra string functions \\ +% lualibs-util-tab.lua & util-tab.lua & extra table functions \\ +% lualibs-util-jsn.lua & util-jsn.lua & conversion to and from json \\ +% \end{tabular} +% \label{tab:utilities} +% \end{table} +% % \pagebreak % \section{\texttt{lualibs.lua}} % @@ -163,8 +218,8 @@ module('lualibs', package.seeall) local lualibs_module = { name = "lualibs", - version = 0.96, - date = "2011/01/20", + version = 0.97, + date = "2012/10/19", description = "Lua additional functions.", author = "Hans Hagen, PRAGMA-ADE, Hasselt NL & Elie Roux", copyright = "PRAGMA ADE / ConTeXt Development Team", diff --git a/lualibs.lua b/lualibs.lua new file mode 100644 index 0000000..cf9b039 --- /dev/null +++ b/lualibs.lua @@ -0,0 +1,54 @@ +-- +-- This is file `lualibs.lua', +-- generated with the docstrip utility. +-- +-- The original source files were: +-- +-- lualibs.dtx (with options: `lua') +-- This is a generated file. +-- +-- Copyright (C) 2009 by PRAGMA ADE / ConTeXt Development Team +-- +-- See ConTeXt's mreadme.pdf for the license. +-- +-- This work consists of the main source file lualibs.dtx +-- and the derived file lualibs.lua. +-- +module('lualibs', package.seeall) + +local lualibs_module = { + name = "lualibs", + version = 0.97, + date = "2012/10/19", + description = "Lua additional functions.", + author = "Hans Hagen, PRAGMA-ADE, Hasselt NL & Elie Roux", + copyright = "PRAGMA ADE / ConTeXt Development Team", + license = "See ConTeXt's mreadme.pdf for the license", +} + +if luatexbase and luatexbase.provides_module then + luatexbase.provides_module(lualibs_module) +end +require("lualibs-string") +require("lualibs-lpeg") +require("lualibs-boolean") +require("lualibs-number") +require("lualibs-math") +require("lualibs-table") +require("lualibs-io") +require("lualibs-os") +require("lualibs-file") +require("lualibs-md5") +require("lualibs-dir") +require("lualibs-unicode") +require("lualibs-url") +require("lualibs-set") +require("lualibs-util-lua") +require("lualibs-util-sto") +require("lualibs-util-mrg") +require("lualibs-util-dim") +require("lualibs-util-str") +require("lualibs-util-tab") +require("lualibs-util-jsn") +-- +-- End of File `lualibs.lua'. -- cgit v1.2.3