summaryrefslogtreecommitdiff
path: root/lualibs.dtx
diff options
context:
space:
mode:
Diffstat (limited to 'lualibs.dtx')
-rw-r--r--lualibs.dtx65
1 files changed, 60 insertions, 5 deletions
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",