From e5b88ab6891e9bb2dc1ac846e942f5bf4e21dfe0 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Tue, 18 Sep 2012 23:41:25 +0000 Subject: tex-overview (16sep12) git-svn-id: svn://tug.org/texlive/trunk@27724 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/tex-overview/README | 4 +- .../doc/latex/tex-overview/tex-overview-aux.tex | 106 ++++- .../doc/latex/tex-overview/tex-overview.pdf | Bin 225010 -> 261096 bytes .../doc/latex/tex-overview/tex-overview.tex | 468 ++++++++++++++------- 4 files changed, 415 insertions(+), 163 deletions(-) (limited to 'Master/texmf-dist/doc/latex/tex-overview') diff --git a/Master/texmf-dist/doc/latex/tex-overview/README b/Master/texmf-dist/doc/latex/tex-overview/README index eb9751dab36..dac82d1fe9f 100644 --- a/Master/texmf-dist/doc/latex/tex-overview/README +++ b/Master/texmf-dist/doc/latex/tex-overview/README @@ -1,4 +1,4 @@ -# TeX-overview +# TeX-overview # This document gives an overview about the developments that followed TeX: its children (new engines that provide more features) and its friends @@ -11,7 +11,7 @@ or you will miss most of the information. Mail me any suggestions and corrections: arno dot trautmann at gmx dot de -# Licence +# Licence # This work may be distributed and/or modified under the conditions of the LaTeX Project Public License, either version 1.3 of this license or diff --git a/Master/texmf-dist/doc/latex/tex-overview/tex-overview-aux.tex b/Master/texmf-dist/doc/latex/tex-overview/tex-overview-aux.tex index f13cd90e28a..9af03281d34 100644 --- a/Master/texmf-dist/doc/latex/tex-overview/tex-overview-aux.tex +++ b/Master/texmf-dist/doc/latex/tex-overview/tex-overview-aux.tex @@ -1,4 +1,4 @@ -%% This document is part of the document tex-overview. It contains the formatting and definitions for typesetting. Please do *not* consider anything here as an example of good TeX coding style. It is not. +%% This document is part of the document tex-overview. It contains the formatting and definitions for typesetting. Please do *not* consider anything here as an example of good TeX coding style – it's not. %% author: Arno Trautmann % !TeX root = tex-overview.tex @@ -7,15 +7,21 @@ \usepackage[svgnames]{xcolor} \usepackage{ + array, bookmark, + booktabs, cooltooltips, + colortbl, dtklogos, %% for \NTS etc. ⇒  what about metalogo? fontspec, geometry, hyperref, + longtable, + luacode, multicol, microtype, pdftexcmds, + tabu, tikz, xparse } @@ -69,10 +75,12 @@ \tl_set:Nn\histdistro{purple} %% shorthand to keep a good structure of the node positions -\fp_new:N\layer -\fp_new:N\layerdist -\fp_set:Nn\layer{0} -\fp_set:Nn\layerdist{-1} +\fp_new:N\layer_num +\fp_new:N\layerdist_num +\fp_set:Nn\layer_num{0} +\fp_set:Nn\layerdist_num{-1} + +\cs_new:Npn\layer{\fp_use:N\layer_num} %% width of the tooltip-boxes (negative value to make them disappear at all) \dim_set:Nn\fboxrule{-1mm} @@ -90,7 +98,7 @@ \cs_gset:Nn\addtotextviews:f{\tl_gput_right:No\to_textviews{#1}} %% environment to set the graphs -\NewDocumentCommand\tograph{sD(){}+m} +\NewDocumentCommand\tograph{s+D(){}+m} { \IfBooleanT{#1}{ \ExplSyntaxNamesOn @@ -162,10 +170,10 @@ %% a nice way to control the vertical position of nodes \NewDocumentCommand{\setlayer}{m}{ - \fp_set:Nn\layer{#1} + \fp_set:Nn\layer_num{#1} } -\NewDocumentCommand{\steplayer}{O{\layerdist}}{ - \fp_add:Nn\layer{#1} +\NewDocumentCommand{\steplayer}{O{\layerdist_num}}{ + \fp_add:Nn\layer_num{#1} } \NewDocumentCommand\topart{m}{ @@ -203,6 +211,13 @@ \cs_gset_eq:NN\tonodestyle#4 } +%% the sectioning of the names table +\NewDocumentCommand\totablesec{m}{ +~ \\[-2ex] + \rowcolor[gray]{0.9}\hspace*{2em}\Large \strut \large\rmfamily #1 \\ + ~ \\[-2ex] +} + %% a command for creation of bib-items. \NewDocumentCommand\tobibsection{m}{ \subsection*{#1} @@ -211,9 +226,10 @@ \subsection*{#1} } \NewDocumentCommand\tobib{mD<>{}O{}}{ - \vspace*{1.5ex} -\begin{minipage}{\textwidth} %% to prevent page breaks - \large #1\normalsize\\ \hspace*{1em} \parbox{\textwidth-1.5em}{\url{#2} #3} + \medskip +\begin{minipage}{\textwidth} %% to prevent page breaks within bib-items + \large #1\normalsize\\ \hspace*{1em} \parbox{.95\textwidth} +{\url{#2} #3} \end{minipage} } @@ -222,11 +238,69 @@ \AtBeginDocument{ { \centering - \huge\bfseries An overview of \TeX, its children\\ and their friends~\dots\par + \huge\bfseries An overview of \TeX, its children\\ + and their friends~\dots + \vspace*{-.2cm} \flushright\parbox{4cm}{ - \Large \color[rgb]{.4 0 0} Arno Trautmann\\ \fontsize{9.85}{10}\selectfont arno.trautmann@gmx.de + \large \color[rgb]{.4 0 0} Arno Trautmann\\ + \fontsize{8.25}{10}\selectfont arno.trautmann@gmx.de } - \hspace*{2cm}\par + \hspace*{.7cm}\par } \vspace*{1cm} -} \ No newline at end of file +} + +%% ok, now something just for fun, but I wanted to use this in a "real life" document: +% we first define some Lua functions for drawing and then use them to colorize the corners of the document. +\begin{luacode} +function pdf_print (...) + for _, str in ipairs({...}) do + pdf.print(str .. " ") + end + pdf.print("\string\n") +end + +function move (p) + pdf_print(p[1],p[2],"m") +end + +function line (p) + pdf_print(p[1],p[2],"l") +end + +function curve(p1,p2,p3) + pdf_print(p1[1], p1[2], + p2[1], p2[2], + p3[1], p3[2], "c") +end + +function linewidth (w) + pdf_print(w,"w") +end + +function disturb_point(point,strength) + if strength then else strength = 5 end + return {point[1] + math.random()*2*strength - strength, + point[2] + math.random()*2*strength - strength} +end + +function sloppyline(start,stop) + local start_line = disturb_point(start,10) + local stop_line = disturb_point(stop,10) + move(start) curve(start_line,stop_line,stop) + pdf_print("S") -- stroke +end +\end{luacode} + +\AtBeginShipout{% + \AtBeginShipoutUpperLeft{% + \color[rgb]{.6 0 0} + \luatexlatelua{ + linewidth(40) + sloppyline({-30,-30},{30,30}) + sloppyline({620,-30},{560,30}) + sloppyline({-30,-800},{30,-860}) + sloppyline({620,-800},{560,-860}) + } + }% +} diff --git a/Master/texmf-dist/doc/latex/tex-overview/tex-overview.pdf b/Master/texmf-dist/doc/latex/tex-overview/tex-overview.pdf index c0b4ffea022..0dce2410367 100644 Binary files a/Master/texmf-dist/doc/latex/tex-overview/tex-overview.pdf and b/Master/texmf-dist/doc/latex/tex-overview/tex-overview.pdf differ diff --git a/Master/texmf-dist/doc/latex/tex-overview/tex-overview.tex b/Master/texmf-dist/doc/latex/tex-overview/tex-overview.tex index 9c74e9cdacf..5a2de1127a3 100644 --- a/Master/texmf-dist/doc/latex/tex-overview/tex-overview.tex +++ b/Master/texmf-dist/doc/latex/tex-overview/tex-overview.tex @@ -1,16 +1,16 @@ -%% Engine needed: LuaTeX ≥ 0.65 +%% Engine needed: LuaTeX ≥ 0.70.1 %% Format needed: LaTeX2ε -%% Packages needed: see list in the -aux.tex file … -%% use an up-to-date TeX live2011 (with tl-contrib updates) +%% use an up-to-date TeX Live2012 (with tl-contrib updates) -% this document has version number 0.1e-ish. +% this document has version number 0.1f-ish. \input{tex-overview-aux} %% everything that is not content-related \begin{document} \savegeometry{normal} \begin{abstract} -{\centering \Large \hyperref[textextview]{Link for the impatient.}\\[2ex]} In the world of \TeX, there are many developments and ambiguous names. This paper tries to give an overview of the development of \TeX\ and related programs. Contributions are very welcome!\footnote{The current source code of this document is availble at \url{http://github.com/alt/tex-overview}. Please feel free to patch there or mail me any suggestions and comments. I'll be happy to extend and correct this document!} + +{\centering \Large \hyperref[textextview]{Link for the impatient.}\\[2ex]} \end{abstract} \section*{Introduction} @@ -26,8 +26,16 @@ In the tree views, every node has a tooltip that shows up when you hover the mou \newpage \tableofcontents +\section{The Difference Between Engine, Format and Distribution} +There are three kinds of terms that are often confused especially by new users. This will try to explain them very shortly: +\begin{description} +\item[engine] This is the program that does all the actual work. The original program is \TeX, a famous development is pdf\TeX, while Lua\TeX\ is the latest successor. +\item[format] A format is a (large) collection of abbreviations (macros) that make the life easy when working with \TeX. The most commonly used formats are \LaTeX, Con\TeX t and plain\TeX. The latter one is a minimal set of macros provided by Don Knuth. Formats can be combined with different engines, exploiting the special abilities of these engines. A format is first a collection of text files, but can be compiled into a binary format that can be read in faster by the engine. +\item[distribution] In addition to formats, a large set of suppelmentary files can be used to work with \TeX, called \emph{packages} for \LaTeX, \emph{modules} for Con\TeX t, and many external programs have proven useful for the work with \TeX. Distributions such as \TeX~Live and MiK\TeX\ strive to provide a full set of such programs and macros by using a package manager to take care of package dependencies and updating. Many Linux distributions, as well as cygwin for Windows, repackage a \TeX\ distribution (mostly \TeX~Live) using the Linux distribution's package system. +\end{description} -\section*{How to read this document} +\newpage +\section{How to read this document} This document consists of several graphs showing the development of software more or less directly related to \TeX. The graphs try to show the time development (downwards), as well as dependencies, changes, etc. I tried to make the graphs more readable by using colors for different categories. The decisions about what is important and what is “normal” reflect my personal opinion only. @@ -57,14 +65,6 @@ Some of the graphs are quite complex, which is the reason why there are two vers In most cases I did not mention the authors of the programs/packages. This is not to diminish their effort but only for brevity (long names make things harder to read). I did not write any of the below-mentioned programs or packages. The authors are given in the documents linked in the references. -\section{The Difference Between Engine, Format and Distribution} -There are three kinds of terms that are often confused especially by new users. This will try to explain them very shortly: -\begin{description} -\item[engine] This is the program that does all the actual work. The original program is \TeX, a famous development is pdf\TeX, while Lua\TeX\ is the latest successor. -\item[format] A format is a (large) collection of abbreviations (macros) that make the life easy when working with \TeX. The most commonly used formats are \LaTeX, Con\TeX t and plain\TeX. The latter one is a minimal set of macros provided by Don Knuth. Formats can be combined with different engines, exploiting the special abilities of these engines. A format is first a collection of text files, but can be compiled into a binary format that can be read in faster by the engine. -\item[distribution] In addition to formats, a large set of suppelmentary files can be used to work with \TeX, called \emph{packages} for \LaTeX, \emph{modules} for Con\TeX t etc. To get all needed files in a convinient way, there are distributions that contain everything and are (or should be) easy to install. Examples are MiKTeX and \TeX~live. -\end{description} - \section{How to contribute} I hope one day this document would become the standard reference for questions like ”What program do I need for …?“, ”What's the difference between …\TeX\ and …\TeX?“, ”Why is it called …?“ etc. @@ -73,26 +73,25 @@ To get to this point, I need some help of people who know more about the \TeX\ w \item font technologies \item METAFONT and succesors \item Bib\TeX\ and successors/alternatives -\item information about e-p\TeX\ and p\BibTeX, as the only documentation I found is japanese. If you know japanese, I'd be happy about a translation! \end{itemize} It is up to you to contribute texts, references, links, descriptions, hints etc. I'll be happy about anything I can add here. Also, if you have suggestions about the layout, let me know. \section{Problems with PDF viewers} -As this document makes heavy use of PDF-features, some PDF viewers are not able to show everything correct and as intended. My experiences with viewers are as follows: +As this document makes heavy use of PDF-features, some PDF viewers are not able to show everything correct and as intended. My experiences with viewers are as follows, where the number is the version which I tested: \begin{description} -\item[evince] Shows the document correct and complete. Tested using Linux. +\item[evince 3.0.2] Shows the document correct and complete. (Tested on Arch Linux) -\item[Acrobat Reader] will show all the information but might hide some text of very long tooltips (at least that's the case on my machine). Also, it draws annoying green boxes around the tooltips which do not belong there. +\item[Adobe Reader 9] will show all the information but might hide some text of very long tooltips (at least that's the case on my machine). Also, it draws annoying green boxes around the tooltips which do not belong there. (Tested on Arch Linux) -\item[TeXworks] The built-in PDF viewer of the TeXworks editor does not break lines of tooltips, therefore long annotations are not shown completely. +\item[\TeX works 0.5 r869] The built-in PDF viewer of the \TeX works editor does not break lines of tooltips, therefore long annotations are not shown completely. (Tested on Arch Linux) -\item[okular] also does not break the lines. +\item[okular 0.13] also does not break the lines. (Tested on Arch Linux) -\item[xpdf] shows only very short tooltips. Most of the information is not visible in the graphs. +\item[xpdf 3.03] shows only very short tooltips. Most of the information is not visible in the graphs. (Tested on Arch Linux) -\item[gv] shows no tooltips, but the annoying green boxes. (Linux) +\item[gv 3.7.2] shows no tooltips, but the annoying green boxes. (Tested on Arch Linux) \end{description} \subsection*{About this document} @@ -115,106 +114,136 @@ This document is typeset in the \TeX\ Gyre Pagella font using the Lua\LaTeXe\ fo \tonode[\program](ant)(13,\layer){ANT} \todraw[dotted](tex)(ant) + + \tonode[\program](hex)(0,\layer){HeX} + \todraw[dotted](tex)(hex) \steplayer[-1.5] - \tonode(tex-xet)(3,\layer){\TeX-\XeT} + \tonode(tex-xet)(4,\layer){\TeX-\XeT} \todraw(tex)(tex-xet) \tonode(nihongo)(10,\layer){Nihongo \TeX} \todraw(tex)(nihongo) \tonode(jtex)(15,\layer){j\TeX} - \todraw(tex)(jtex) + \todraw(tex)(jtex) - \steplayer[-1.5] - \tonode(ptex)(10,\layer){p\TeX} - \todraw(nihongo)(ptex) + \steplayer[-2] + + \tonode(tex--xet)(4,\layer){\TeX-{}-\XeT} + \todraw(tex-xet)(tex--xet) - \steplayer[-1.5] - \tonode(tex--xet)(3,\layer){\TeX-{}-\XeT} - \todraw(tex-xet)(tex--xet) - \tonode[\vip](tex3)(7,\layer){\TeX3} - \todraw*(tex)(tex3) + \todraw*(tex)(tex3) - \tonode(eptex)(13,\layer){e-p\TeX} - \todraw(ptex)(eptex) + \steplayer[-1.5] + + \tonode(ptex)(12,\layer){p\TeX} + \todraw(nihongo)(ptex) + \todraw(tex3)(ptex) + + \steplayer[-1.5] - \steplayer[-2] \tonode(enctex)(5.9,\layer){enc\TeX} \todraw(tex3)(enctex) \tonode(mltex)(8,\layer){ML\TeX} \todraw(tex3)(mltex) - \tonode[\experimental](uptex)(11,\layer){up\TeX} - \todraw(tex3)(uptex) - \todraw(ptex)(uptex) - - \steplayer[-2] - \tonode(tex2pdf)(7,\layer){\TeX2PDF} - \todraw(enctex)(tex2pdf) - \todraw(mltex)(tex2pdf) - + \tonode[\experimental](uptex)(14,\layer){up\TeX} + \todraw(ptex)(uptex) \steplayer[-2] - \tonode(omega)(1,\layer){$\Omega$} - \todraw(tex3)(omega) + + \tonode[\experimental](omega)(1,\layer){$\Omega$} + \todraw(tex3)(omega) \tonode[\vip](etex)(4,\layer){$\varepsilon$-\TeX} - \todraw(tex--xet)(etex) - \todraw'(tex3)(etex) - - \tonode[\vip](pdftex)(7,\layer){pdf\TeX} - \todraw(tex2pdf)(pdftex) - \todraw'(tex3)(pdftex) - - \tonode(texgx)(9.5,\layer){\TeX{}gX} - \todraw(tex3)(texgx) + \todraw(tex--xet)(etex) + \todraw'(tex3)(etex) + + \tonode(tex2pdf)(7,\layer){\TeX2PDF} + \todraw(enctex)(tex2pdf) + \todraw(mltex)(tex2pdf) \tonode(nts)(12,\layer){\NTS} - \todraw(tex3)(nts) - - \steplayer[-2] + \todraw(tex3)(nts) + + \steplayer[-1] + + \tonode(texgx)(10,\layer)<"GX" stands for Graphic eXtension, a font technology available only on Mac OS. TeXGX was able to handle these fonts.>{\TeX{}gX} + \todraw(tex3)(texgx) + + \steplayer[-1] + \tonode[\experimental](omega2)(0,\layer){$\Omega_2$} - \todraw(omega)(omega2) + \todraw(omega)(omega2) \tonode[\experimental](vtex)(3.6,\layer){V\TeX} - \todraw(etex)(vtex) - - \steplayer[-2] - \tonode[\experimental](aleph)(1,\layer){$\aleph$ (Aleph)} - \todraw(omega)(aleph) - \todraw(etex)(aleph) + \todraw(etex)(vtex) + + \steplayer[-1] + + \tonode(eptex)(13.7,\layer){ε-p\TeX} + \todraw(ptex)(eptex) + \todraw(etex)(eptex) + + \steplayer[-1.5] + + \tonode(euptex)(15.2,\layer)<>{ε-up\TeX} + \todraw(etex)(euptex) + \todraw(uptex)(euptex) + + \steplayer[-.5] + + \tonode(aleph)(1,\layer){$\aleph$ (Aleph)} + \todraw(omega)(aleph) + \todraw(etex)(aleph) - \tonode[\vip](XeTeX)(8,\layer){\XeTeX} - \todraw(texgx)(XeTeX) - \todraw*(etex)(XeTeX) + \tonode[\vip](pdftex)(7,\layer){pdf\TeX} + \todraw(tex2pdf)(pdftex) + \todraw'(tex3)(pdftex) + \steplayer[-1] + \tonode[\experimental](extex)(12,\layer){$\epsilon\chi$\TeX} - \todraw(nts)(extex) - \todraw(omega)(extex) - \todraw(etex)(extex) - \todraw(pdftex)(extex) + \todraw(nts)(extex) + \todraw(omega)(extex) + \todraw(etex)(extex) + \todraw(pdftex)(extex) + + \steplayer[-1] - \tonode[\vip](pdfetex)(5,\layer){pdf($\epsilon$)-\TeX} - \todraw*(etex)(pdfetex) - \todraw*(pdftex)(pdfetex) + \tonode[\vip](pdfetex)(6,\layer){pdf($\epsilon$)-\TeX} + \todraw*(etex)(pdfetex) + \todraw*(pdftex)(pdfetex) + + \tonode[\vip](XeTeX)(10,\layer){\XeTeX} + \todraw(texgx)(XeTeX) + \todraw*(etex)(XeTeX) + \todraw'(pdfetex)(XeTeX) \steplayer[-2] - \tonode[\experimental](eetex)(6,\layer){ee\TeX} - \todraw(pdfetex)(eetex) + + \tonode[\experimental](eetex)(8,\layer){ee\TeX} + \todraw(pdfetex)(eetex) - \steplayer[-2] + \steplayer[-1] + \tonode[\program](lua)(0,\layer){Lua} - \tonode[\vip](luatex)(4,\layer){Lua\TeX} - \todraw(aleph)(luatex) - \todraw*(pdfetex)(luatex) - \todraw[dashed](lua)(luatex) + \tonode[\vip](luatex)(4,\layer){Lua\TeX} + \todraw(aleph)(luatex) + \todraw*(pdfetex)(luatex) + \todraw[dashed](lua)(luatex) - \steplayer[-2] - \tonode[\experimental](itex)(7,\layer){i\TeX} + \steplayer[-3] + \tonode[\experimental](itex)(7,\layer){i\TeX} } +\vfill + +{\flushleft The chronological order may not be exact in this graph. I have to work hard on the arrangement to show both chronological order and code dependence, and for now only the code dependence is (should be) correct. + +} \clearpage @@ -223,9 +252,13 @@ This document is typeset in the \TeX\ Gyre Pagella font using the Lua\LaTeXe\ fo \tonode(plaintex)(0,\layer){plain\TeX} \steplayer[-2] - \tonode(ecplain)(-2,\layer){ec-plain} - \tonode(eplain)(2,\layer){eplain} + \tonode[\experimental](ecplain)(-2,\layer){ec-plain} + \tonode[\experimental](csplain)(2,\layer){csplain} \todraw(plaintex)(ecplain) + \todraw(plaintex)(csplain) + +\steplayer[-2] + \tonode[\experimental](eplain)(0,\layer){eplain} \todraw(plaintex)(eplain) } \clearpage @@ -266,7 +299,7 @@ This document is typeset in the \TeX\ Gyre Pagella font using the Lua\LaTeXe\ fo \todraw(latex209)(amslatex11) \steplayer[-1.7] - \tonode[\vip](latex2ε)(0,\layer){\LaTeX\,2\raisebox{-.5ex}ε} + \tonode[\vip](latex2ε)(0,\layer){\LaTeX\,2\raisebox{-.5ex}ε} \todraw*(latex209)(latex2ε) \todraw[dashed](slitex)(latex2ε) \todraw[dashed](amslatex11)(latex2ε) @@ -286,21 +319,13 @@ This document is typeset in the \TeX\ Gyre Pagella font using the Lua\LaTeXe\ fo \todraw(latex2ε)(alatex) \steplayer[-1.5] - \tonode(amslatex21)(8,\layer){\AMS\LaTeX 2.2} + \tonode(amslatex21)(8,\layer){\AMS\LaTeX 2.2} \todraw(amslatex12)(amslatex21) \steplayer[-1.5] - \tonode[\vip](pdflatex)(2,\layer){pdf\LaTeX} - \todraw*(latex2ε)(pdflatex) - - \tonode[\vip](xelatex)(5,\layer){\XeLaTeX} - \todraw*(latex2ε)(xelatex) - \tonode(platex)(-4.6,\layer){p\LaTeX} \todraw(latex2ε)(platex) - \tonode[\vip](lualatex)(-1.8,\layer){Lua\LaTeX} - \todraw*(latex2ε)(lualatex) \steplayer[-1.5] \tonode[\package](expl3)(1.5,\layer){expl3} @@ -339,20 +364,20 @@ This document is typeset in the \TeX\ Gyre Pagella font using the Lua\LaTeXe\ fo \todraw(inrstex)(pragmatex) \steplayer[-2] - \tonode(mki)(0,\layer){\ConTeXt MkI} - \todraw(mki)(pragmatex) + \tonode(MKi)(0,\layer){\ConTeXt\ MKI} + \todraw(MKi)(pragmatex) \steplayer[-2] - \tonode[\vip](mkii)(0,\layer){\ConTeXt MkII} - \todraw(mki)(mkii) + \tonode[\vip](MKii)(0,\layer){\ConTeXt\ MKII} + \todraw(MKi)(MKii) \steplayer[-2] - \tonode(mkiii)(4,\layer){\ConTeXt\ MkIII} - \todraw(mkii)(mkiii) + \tonode[\vip](MKiv)(0,\layer){\ConTeXt\ MKIV} + \todraw*(MKii)(MKiv) \steplayer[-2] - - \tonode[\vip](mkiv)(0,\layer){\ConTeXt MkIV} - \todraw*(mkii)(mkiv) + + \tonode[\experimental](MKvi)(0,\layer){\ConTeXt\ MKVI} + \todraw(MKiv)(MKvi) } %% go on with the rare formats @@ -360,7 +385,7 @@ This document is typeset in the \TeX\ Gyre Pagella font using the Lua\LaTeXe\ fo %%%% formats %%%% \tostruct[Other Formats]{Other Formats} %%% AMSTeX %%% -\tograph(\tostruct(1)[\AMS-\TeX]{\AMS-\TeX}){ +\tograph(\tostruct(1)[\texorpdfstring{\AMS}{AMS}-\TeX]{\AMS-\TeX}){ \tonode(amstex20)(0,\layer){\AMS-\TeX 2.0} \steplayer[-1] @@ -389,7 +414,7 @@ This document is typeset in the \TeX\ Gyre Pagella font using the Lua\LaTeXe\ fo %%% JadeTeX %%% \tograph(\tostruct(1)[Jade\TeX]{Jade\TeX}){ - \tonode(jadetex)(0,0){Jade\TeX} + \tonode(jadetex)(0,0){Jade\TeX} } %%% Lollipop %%% @@ -404,6 +429,11 @@ This document is typeset in the \TeX\ Gyre Pagella font using the Lua\LaTeXe\ fo \tonode(macrotex)(0,0){Macro\TeX} } +%%% MEX %%% +\tograph(\tostruct(1)[MeX]{MeX}){ + \tonode(mex)(0,0){MeX} +} + %%% PHYS(E) %%% \tograph(\tostruct(1)[PHYS(E)]{PHYS(E)}){ \tonode(physe)(0,0){Texinfo} } +%%% TeXsis %%% +\tograph(\tostruct(1)[TeXsis]{\TeX sis}[\normalimportant]){ + \tonode(texsis)(0,0){\TeX sis} +} + %%% XMLTeX %%% \tograph(\tostruct(1)[XML\TeX]{XML\TeX}){ \tonode(xmltex)(0,\layer){XML\TeX} @@ -450,10 +485,10 @@ This section will feature the main distributions of \TeX\ and related programs. } \ExplSyntaxOn -\fp_gset:Nn\layerdist{-1.5} +\fp_gset:Nn\layerdist_num{-1.5} \ExplSyntaxOff -\tograph(\tostruct(1)[\TeX\ live]{\TeX\ live}){ +\tograph(\tostruct(1)[\TeX\ Live]{\TeX\ Live}){ \tonode(web2c)(0,\layer){Web2C} \steplayer %% PCTeX? (Breitenloher) [need more information] @@ -471,43 +506,53 @@ This section will feature the main distributions of \TeX\ and related programs. \tonode(fptex)(3,\layer){fp\TeX} \todraw(fptex)(tetex) + + \tonode(gnutex)(3,\layer){GNU\TeX\ 0.x} + \todraw(gnutex)(tetex) + \steplayer[-2.5] \tonode[\histdistro](xemtex)(4,\layer){XEm\TeX} \todraw(xemtex)(fptex) - \tonode[\histdistro](tlpre2008)(0,\layer){\TeX\ live 1996\,–\,2007} + \tonode[\histdistro](tlpre2008)(0,\layer){\TeX\ Live 1996\,–\,2007} \todraw(tetex)(tlpre2008) \todraw(4alltexcd)(tlpre2008) \todraw.(web2c)(tlpre2008) \steplayer - \tonode(tl2008)(0,\layer){\TeX\ live2008} + \tonode(tl2008)(0,\layer){\TeX\ Live 2008} \todraw.(tl2008)(tlpre2008) - \tonode[\histdistro](gwtex)(5,\layer){gw\TeX} + \tonode[\histdistro](gwtex)(5,\layer){gw\TeX} \todraw(tlpre2008)(gwtex) \steplayer - \tonode(tl2009)(0,\layer){\TeX\ live2009} + \tonode(tl2009)(0,\layer){\TeX\ Live 2009} \todraw(tl2009)(tl2008) \steplayer - \tonode(tl2010)(0,\layer){\TeX\ live2010} + \tonode(tl2010)(0,\layer){\TeX\ Live 2010} \todraw(tl2010)(tl2009) - \tonode(tlcontrib)(-5,\layer){TLContrib} + \tonode(tlcontrib)(-5,\layer){TLContrib} \todraw.(tl2010)(tlcontrib) \steplayer - \tonode(tl2011)(0,\layer){\TeX\ live2011} + \tonode(tl2011)(0,\layer)<2011 release of TeX Live.>{\TeX~Live 2011} \todraw(tl2011)(tl2010) \todraw.(tl2011)(tlcontrib) - \tonode(mactex)(5,\layer){Mac\TeX} - \todraw(tl2011)(mactex) + \steplayer + + \tonode(tl2012)(0,\layer){\TeX~Live 2012} + \todraw(tl2012)(tl2011) + \todraw.(tl2012)(tlcontrib) + + \tonode(mactex)(5,\layer){Mac\TeX} + \todraw(tl2012)(mactex) } \tograph(\tostruct(1)[MiK\TeX]{MiK\TeX}){ @@ -526,7 +571,7 @@ This section will feature the main distributions of \TeX\ and related programs. \todraw(mt28)(mt27) \steplayer - \tonode(mt29)(0,\layer){MiK\TeX\ 2.9} + \tonode(mt29)(0,\layer){MiK\TeX\ 2.9} \todraw(mt29)(mt28) \steplayer @@ -535,15 +580,16 @@ This section will feature the main distributions of \TeX\ and related programs. } \tograph(\tostruct(1)[\TeX\ collection]{\TeX\ collection}){ - \tonode(texcollection)(0,\layer){\TeX\ Collection} + \tonode(texcollection)(0,\layer){\TeX\ Collection} } -\tograph(\tostruct(1)[Con\TeX t minimals]{Con\TeX t minimals}){ - \tonode(minimals)(0,\layer){Con\TeX t minimals} - \steplayer - \tonode(standalone)(0,\layer){Con\TeX t standalone} - \todraw(minimals)(standalone) +\tograph(\tostruct(1)[standalone Con\TeX t]{standalone Con\TeX t}){ + \tonode(minimals)(-3,\layer){Standalone} +} + +\tograph(\tostruct(1)[Ker\TeX]{Ker\TeX}){ + \tonode(kertex)(0,\layer){Ker\TeX} } \tograph(\tostruct(1)[W32\TeX]{W32\TeX}){ @@ -585,22 +631,35 @@ The following pages will be a hodge-podge of many things that are related to \Te \tonode(metafont)(0,\layer){METAFONT} \steplayer - \tonode(metafog)(3,\layer){Metafog} + \tonode(metafog)(4,\layer){Metafog} \todraw(metafog)(metafont) - \tonode(metatype1)(-3,\layer){MetaType1} + \tonode(metatype1)(-4,\layer){MetaType1} \todraw(metatype1)(metafont) + \steplayer[-1] \tonode(metapost)(0,\layer){MetaPost} \todraw(metapost)(metafont) - \steplayer[-3] + \steplayer[-1] + + \tonode[\normalimportant](mptopdf)(-4,\layer){mptopdf} + \todraw.(metapost)(mptopdf) + + \tonode[\experimental](mflua)(4,\layer){MFLua} + \todraw(mflua)(metafont) + \steplayer[-2] + + \tonode[\normalimportant](metappeal)(4,\layer)<"Metappeal is an extension to Plain MetaPost, providing a lightweight framework +for consistent development in MetaPost.">{Metappeal} + \todraw(metappeal)(metapost) + \steplayer[-1] \tonode[\experimental](megapost)(0,\layer){MegaPost} \todraw(metapost)(megapost) + \steplayer[-1] - \tonode[\normalimportant]%% to indicate that it is a format rather than a program … - (metafun)(3,\layer)<“MetaFun is Hans Hagen's extension to (or module for) the MetaPost language.” A format for MetaPost that is useable with ConTeXt.>{MetaFun} + \tonode[\normalimportant](metafun)(3,\layer)<“MetaFun is Hans Hagen's extension to (or module for) the MetaPost language.” A format for MetaPost that is useable with ConTeXt.>{MetaFun} \todraw(metafun)(metapost) } @@ -613,37 +672,46 @@ and precision of the internal data types.”>{MegaPost} \todraw(nbibtex)(bibtex) \steplayer[-0.5] - \tonode(bibtex8)(0,\layer){\BibTeX8} + \tonode(bibtex8)(0,\layer){\BibTeX8} \todraw(bibtex8)(bibtex) - \tonode(mlbibtex)(-4,\layer){MlBibTeX} + \tonode(mlbibtex)(-4,\layer){MlBibTeX} \todraw(mlbibtex)(bibtex) \steplayer \tonode(bibtexu)(0,\layer){\BibTeX u} \todraw(bibtex8)(bibtexu) - \tonode(pbibtex)(-4,\layer){p\BibTeX} - \todraw(bibtex8)(pbibtex) + \tonode(jbibtex)(-4,\layer){j\BibTeX} + \todraw(bibtex8)(jbibtex) \tonode(pybtex)(3,\layer){Pybtex} \todraw(pybtex)(bibtexu) \steplayer + + \tonode(pbibtex)(-4,\layer){p\BibTeX} + \todraw(jbibtex)(pbibtex) + \steplayer + + \tonode(upbibtex)(-6,\layer){up\BibTeX} + \todraw(pbibtex)(upbibtex) + \steplayer \tonode(biber)(0,\layer){biber} \todraw(bibtexu)(biber) - \tonode[\package](biblatex)(3,\layer){Bib\LaTeX} - \todraw(biber)(biblatex) - \todraw(bibtexu)(biblatex) \steplayer - \tonode[\package](librarian)(5,\layer){Librarian} + \tonode[\package](biblatex)(3,\layer){Bib\LaTeX} + \todraw.(biber)(biblatex) + \todraw.(bibtexu)(biblatex) + + \tonode[\package](librarian)(7,\layer){Librarian} } %%% dvipdfm and similar ones %%% \tograph(\tostruct(1)[{(x)dvipdf(m)(x)}]{(x)dvipdf(m)(x)}){ - \tonode(dvipdf)(0,0){dvipdf} + \tonode(dvipdf)(0,0){dvipdf} \tonode(xdv2pdf)(4,0){xdv2pdf} \steplayer @@ -660,7 +728,7 @@ and precision of the internal data types.”>{MegaPost} \tograph(\tostruct(1)[Fonts]{Fonts}[\fonttechnology] \parbox{\textwidth}{\large -This section tries to cover the development of fonts – the most important thing for a typesetting system is it's font mechanism …\\[4ex]} +This section tries to cover the development of fonts – the most important thing for a typesetting system are font mechanism …\\[4ex]} ){ \tonode(bitmap)(0,\layer){Bitmap fonts} \steplayer[-3] @@ -683,6 +751,35 @@ This section tries to cover the development of fonts – the most important thin \todraw(aat)(gx) } +\newpage +\tograph(\tostruct(1)[Work Flow]{Work Flow – Under Construction!}[\vip] +{ +\flushleft +\large Ok, this section might never be ready, but I will leavi it here in the hope that someone will help out: I want to try to depict the typical work flow for working with \TeX. This will never be complete as there are many ways to work with any of the \TeX\ flavours, including helper programs etc. We will start with a simple \LaTeX\ document, and maybe we will extend this to different formats, engines etc. … + +The preliminary nomenclature is: +\begin{itemize} +\item[red] necessary files +\item[yellow] additional input files +\item[blue] automatically produced files +\item[green] program that is used – editor, processing tool, viewer, … +\end{itemize} + +%% yes, this is stupid, but for now that's how it is …: +\let\necessary\vip +\let\additional\experimental +\let\automatic\normalimportant +\let\program\package +} +){ + \tonode(texfile)(0,\layer){.tex} + \steplayer[-5] + + \tonode(pdffile)(0,\layer){.pdf} + + \draw[->,very thick](texfile) to node{latex} (pdffile); +} + \topart{Text Views} \label{sec:text} @@ -696,30 +793,97 @@ This section tries to cover the development of fonts – the most important thin \addtocontents{toc}{\string\end{multicols}} \onecolumn +\tostruct[Program Names]{Program Names}[\normalimportant] +\flushleft %% centering was still active until here +The following list tries to explain what happens if a programm is called by a given name. E.\,g. calling the command \texttt{latex} on the command line will start the PDFε-\TeX\ engine\footnote{Actually it's only called PDF\TeX\ now, but it is always the version that includes ε-\TeX\ extensions. Here, always the full name is used for clearness.} in DVI mode with the format \LaTeX\,2\raisebox{-.5ex}ε. This will list the names used in the \emph{official} (upstream) \TeX~Live~2012 distribution, which should mostly (but not all) be the same in MiK\TeX. + +\begin{longtabu}{>{\ttfamily\large}lX} +\rowcolor[gray]{0.8}\LARGE \bfseries program \strut & \LARGE meaning\\ +\\[-2ex] +\totablesec{engines / no preloaded format} +initex & INI\TeX\ (same as \texttt{tex --ini})\\ +texlua & Lua\TeX\ in Lua mode\\ +texluac & Lua\TeX\ as byte compiler\\ + +\totablesec{plain formats} +tex & \TeX\ with the plain format\\ + +aleph & Aleph with the plain format\\ +csplain & PDFε-\TeX\ with the csplain format and DVI output\\ +dviluatex & Lua\TeX\ with the plain format and DVI output\\ +eplain & PDFε-\TeX\ with the eplain format and DVI output\\ +eptex & ε-p\TeX\ with the plain format\\ +euptex & ε-up\TeX\ with the plain format\\ +etex & PDFε-\TeX\ with the plain format and DVI output\\ +luatex & Lua\TeX\ with the plain format and PDF output\\ +mltex & PDFε-\TeX\ with ML\TeX\ extensions enabled, DVI output\\ +pdfcsplain & PDFε-\TeX\ with the csplain format and PDF output\\ +pdfetex & PDFε-\TeX\ with the plain format and PDF output\\ +pdftex & PDFε-\TeX\ with the plain format and PDF output\\ +ptex & p\TeX\ with the plain format\\ +xetex & \XeTeX\ with the plain format\\ + +\totablesec{\LaTeXe} +latex & PDFε-\TeX\ with the \LaTeXe\ format and DVI output\\ +dvilualatex & Lua\TeX\ with the \LaTeXe\ format and DVI output\\ +lamed & Aleph with the Lamed format\\ +lualatex & Lua\TeX\ with the \LaTeXe\ format and PDF output\\ +mllatex & PDFε-\TeX\ with ML\TeX\ extensions enabled, \LaTeXe\ format and DVI output\\ +pdflatex & PDFε-\TeX\ with the \LaTeXe\ format and PDF output\\ + +platex & ε-p\TeX\ with the p\LaTeX\ format and DVI output\\ +uplatex & ε-up\TeX\ with the up\LaTeX\ format and DVI output\\ +xelatex & \XeTeX\ with the \LaTeXe\ format\\ + +\totablesec{Con\TeX t} +texexec & PDFε-\TeX with Con\TeX t MKII format and PDF output\\ +texexec --interface = de & dito, with german interface (only an example, more languages available)\\ +texexec --xtx & \XeTeX with Con\TeX t MKII format\\ +context & Lua\TeX\ with Con\TeX t MKIV format and PDF output\\ +context --interface = de & dito, with german interface (only an example)\\ +\totablesec{other formats} +amstex & PDFε-\TeX\ with the \AMS\TeX\ format and DVI output\\ +jadetex & PDFε-\TeX\ with the Jade\TeX\ format and DVI output\\ +mex & PDFε-\TeX\ with the MeX format and DVI output\\ +pdfjadetex & PDFε-\TeX\ with the Jade\TeX\ format and PDF output\\ +pdfmex & PDFε-\TeX\ with the MeX format and PDF output\\ +pdfxmltex & PDFε-\TeX\ with the XML\TeX\ format\\%% FIXME: what output? … +texsis & PDFε-\TeX\ with the \TeX sis format and DVI output\\ +utf8mex & PDFε-\TeX\ with the UTF8MeX format and DVI output\\ +xmltex & PDFε-\TeX\ with the XML\TeX\ format \\%% FIXME: what output? … + +\totablesec{metafont} +mf & the METAFONT program\\ +mp & the METAPOST program\\ +mptopdf & PDFε-\TeX\ with the mptopdf format and PDF output\\ +\end{longtabu} + \appendix \topart{Appendix} %% -%% I've chosen to typeset the bibliography “by hand” for full control of formatting and behaviour. Also, I can choose my own syntax ☺ +%% This is kind-of a bibliography. %% \tostruct{References} \label{sec:refs} -\obeylines\flushleft %% centering was still active until here +\obeylines -The references are in order of occurance in the above document. i.\,e. if you want information about Lua\TeX, it will be below e.\,g. $\epsilon$\TeX. Everything that is not listet as ”book“ is freely available on the internet. +The references are in order of occurance in the above document. i.\,e. if you want information about Lua\TeX, it will be below e.\,g. ε\TeX. Everything that is not listet as ”book“ is freely available on the internet. (TUGboat articles will become freely accessible about one year after publication.) \tobibsection{Books} \tobib{D.E. Knuth, D.~Bibby, and I.~Makai. \textit{The \TeX book}\\ Addison-Wesley Reading, MA, 1986.} \tobib{F.~Mittelbach, M.~Goossens, J.~Braams, D.~Carlisle, C.~Rowley, C.~Detig, and J.~Schrod. \textit{The \LaTeX\ companion.} \\ Addison-Wesley, 2004.} - \tobibsection{Overview Articles} + \tobibsection{Overview Articles / Pages} \tobib{Arthur Reutenauer. \textit{A Brief History of \TeX}. Talk at EuroBacho\TeX\ 2007.}% \tobib{\textit{A Brief History of \LaTeX}} \tobib{Hans Hagen: \textit{16 years of Con\TeX t}. Article in TUGboat Vol. 32, Number 1, 2011.} \tobib{Short Article About Omega And Aleph} \tobib{Interviews with Will Robertson, Hans Hagen et.\,al.} + \tobib{The levels of \TeX\ – explains shortly the differences between engines, distributions, front ends etc.} + \tobib{Things with “\TeX” in the name – a page with a similar aim as this document, and many interesting links} \tobibsection{Archives} \tobib{CTAN – Comprehensive \TeX\ Archive Network:} @@ -727,8 +891,10 @@ The references are in order of occurance in the above document. i.\,e. if you wa \tobibsection{Engines} \tobib{ANT project page} + \tobib{HeX project page} \tobib{Yasuki S AITO. Report on JTEX: A Japanese TEX. TUGboat 8 (1987), no. 2, 103\,–\,116.}% + \tobib{p\TeX\ page} \tobib{p\TeX\ sources and documentation} \tobib{enc\TeX\ page} \tobib{ML\TeX\ source (CH file)} @@ -739,6 +905,7 @@ The references are in order of occurance in the above document. i.\,e. if you wa \tobib{$\epsilon\chi$\TeX\ project page} \tobib{ee\TeX\ project page} \tobib{Lua\TeX\ project page} + \tobib{\textit{i\TeX—Document formatting in an ereader world.} TUGboat 32 (2011), no. 2, 158\,–\,163.} \tobib{i\TeX\ announcement by Don Knuth at the TUG 2010} \tobibsection{Formats} @@ -760,15 +927,17 @@ The references are in order of occurance in the above document. i.\,e. if you wa \tobib{PHYZZX on CTAN} \tobib{Star\TeX\ on CTAN} \tobib{Texinfo project page} + \tobib{\TeX sis project page} \tobib{XML\TeX\ manual} \tobib{Y\TeX\ on CTAN} \tobib{Zz\TeX: Article in TUGboat 13 (1992), No. 4} \tobibsection{Distributions} \tobib{fp\TeX: Announcment at TUG 1999} - \tobib{\TeX\ live development history} + \tobib{\TeX\ Live development history} \tobib{gw\TeX\ project page} \tobib{Brief History of gwTeX} + \tobib{Frank Mittelbach: \textit{Reflections on the history of the \LaTeX\ Project Public License (LPPL)—A software license for \LaTeX\ and more.} In: TUGboat Vol. 32 (2011) No.~1, p.~83~ff.} \tobib{TLContrib project page} \tobib{Mac\TeX\ project page} \tobib{MiKTeX project page} @@ -776,6 +945,7 @@ The references are in order of occurance in the above document. i.\,e. if you wa \tobib{Pro\TeX t project page} \tobib{\TeX Collection page} \tobib{Con\TeX t minimals on Con\TeX t garden wiki} + \tobib{Ker\TeX\ project page} \tobib{Win32 project page} \tobib{Oz\TeX\ project page} \tobib{\TeX\ on Amiga} @@ -798,6 +968,14 @@ I have to thank some people for helping me to improve this document. Of course I \item Paul Isambert, for usefull discussions and testing. \item Heiko Oberdiek, for solving a bug that broke the document with Acrobat Reader. \item Peter Dyballa, for detailed historic information. +\item Mojca Miklavec, for many information, especially on Con\TeX t-related stuff. +\item Hironori Kitagawa, for information about Japanese-specific programs. + \item Many people that stumbled upon my questions on different mailinglist, mostly texhax. \end{itemize} + +\section{To do list} +\begin{itemize} +\item (maybe) Add copyright and licence mark to each software. +\end{itemize} \end{document} \ No newline at end of file -- cgit v1.2.3