doc: better attribution + history section

3 files changed, 35 insertions, 10 deletions

diff --git a/lltxb-dtxstyle.tex b/lltxb-dtxstyle.tex
index 7a5c00b..804dbfb 100644
--- a/lltxb-dtxstyle.tex
+++ b/lltxb-dtxstyle.tex
@@ -1,6 +1,7 @@
 % preamble for dtx documentations of the luatexbase package/bundle.
 
 % packages
+\usepackage[utf8]{inputenc}
 \usepackage[T1]{fontenc}
 \usepackage{textcomp}
 \usepackage{lmodern}
@@ -53,12 +54,21 @@
 }
 
 % constant metadata
+\newif\ifluatexbase
 \author{%
-  Manuel P\'egouri\'e-Gonnard \& \'Elie Roux \\
-  Support: \email{lualatex-dev@tug.org}%
+  Heiko Oberdiek (primary author of \pk{luatex}) \\
+  Élie Roux (primary author of \pk{luatextra}) \\
+  Manuel Pégourié-Gonnard (current developper)\thanks{%
+    See ``History''
+    \ifluatexbase\else in \href{luatexbase.pdf}{\file{luatexbase.pdf}} \fi
+    for details.}%
+  \\[1ex]
+  \url{https://github.com/mpg/luatexbase} \\
+  \email{lualatex-dev@tug.org}%
 }
 \hypersetup{%
-  pdfauthor = {Manuel Pegourie-Gonnard and Elie Roux},
+  pdfsubject = {Basic resource management for LuaTeX},
+  pdfauthor = {Manuel Pégourié-Gonnard, Élie Roux, Heiko Oberdiek},
 }
 
 % other metadata
diff --git a/luatex.dtx b/luatex.dtx
index 691a5b7..7d68279 100644
--- a/luatex.dtx
+++ b/luatex.dtx
@@ -94,13 +94,6 @@ See the aforementioned source file(s) for copyright and licensing information.
 %   Grave accent  \`     Left brace    \{     Vertical bar  \|
 %   Right brace   \}     Tilde         \~}
 %
-% \author{%
-%   Heiko Oberdiek \& Manuel P\'egouri\'e-Gonnard\\
-%   Support: \email{lualatex-dev@tug.org}%
-% }
-% \hypersetup{%
-%   pdfauthor = {Manuel Pegourie-Gonnard and Heiko Oberdiek},
-% }
 % \pkdate{luatex}{v0.5 2011-05-24}
 %
 % \maketitle
diff --git a/luatexbase.dtx b/luatexbase.dtx
index 97a79d6..9032370 100644
--- a/luatexbase.dtx
+++ b/luatexbase.dtx
@@ -66,6 +66,7 @@ See the aforementioned source file(s) for copyright and licensing information.
 %<*driver>
 \documentclass{ltxdoc}
 \input{lltxb-dtxstyle}
+\luatexbasetrue
 \newcommand\subpk[1]{%
   \item[\href{luatexbase-#1.pdf}{luatexbase-#1}\normalfont:]}
 \begin{document}
@@ -129,6 +130,27 @@ See the aforementioned source file(s) for copyright and licensing information.
 % 2008; the next release of this package will only support 0.40.6 and greater
 % with formats from \texlive 2009 and greater.
 %
+% \subsection{History}
+%
+% The first package for managing \luatex's new resources was the \pk{luatex}
+% by Heiko Oberdiek. Later, Élie Roux wrote \pk{luatextra} which reprised many
+% features of \pk{luatex} with little extensions to some of them and added
+% independant low-level features (currently found in the \pk{modutils} and
+% \pk{mcb} subpackages), as well as user-level things. Later, \pk{luatexbase}
+% was created by Manuel Pégourié-Gonnard by isolating the general low-level
+% features of \pk{luatextra}, and later expanding on them.
+%
+% For some time there was two conflicting packages controling access to
+% \luatex's resources: \pk{luatex} and \pk{luatexbase}, neither of which was a
+% subset of the other, and with small differences in their overlapping parts
+% (mainly macro names).
+%
+% Then \pk{luatexbase} was expanded by absorbing the features of \pk{luatex}
+% that were previously missing (essentially the advanced scheme for catcode
+% table management). It currently provides the \pk{luatex} package as a
+% wrapper around the relevant subpackages, so that the two are no longer in
+% conflict.
+%
 %    \section{Implementation}
 %
 %    \begin{macrocode}