diff options
Diffstat (limited to 'Master')
-rw-r--r-- | Master/texmf-dist/doc/latex/latex-tds/README | 898 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/latex-tds/README.html | 2694 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/latex-tds/README.pdf | bin | 0 -> 127331 bytes | |||
-rw-r--r-- | Master/texmf-dist/source/latex/latex-tds/README | 617 | ||||
-rw-r--r-- | Master/texmf-dist/source/latex/latex-tds/README.asciidoc | 689 | ||||
-rwxr-xr-x | Master/texmf-dist/source/latex/latex-tds/build.pl | 115 | ||||
-rw-r--r-- | Master/texmf-dist/source/latex/latex-tds/patch/lb2.err.diff | 19 |
7 files changed, 4382 insertions, 650 deletions
diff --git a/Master/texmf-dist/doc/latex/latex-tds/README b/Master/texmf-dist/doc/latex/latex-tds/README new file mode 100644 index 00000000000..de8fefa9cda --- /dev/null +++ b/Master/texmf-dist/doc/latex/latex-tds/README @@ -0,0 +1,898 @@ +============================ +README for project latex-tds +============================ + +Heiko Oberdiek +2013/02/26 + + +Table of Contents +================= + + 1. Project latex-tds + 1.1. How it has started + 1.2. Goals of the project + 1.3. Scope + 1.4. Module list + 1.5. Author + 1.6. Home + 2. Abbreviations, Glossary + 3. Download + 4. Installation Hints + 4.1. Hints + 5. Copyright, License + 6. Manifest + 6.1. Documentation + 6.2. Licenses + 6.3. Scripts + 6.4. Configuration + 6.5. Documentation driver + 6.6. Patches + 7. Design Principles + 8. Remarks + 8.1. Base + 8.2. Tools + 8.3. Babel + 8.4. Knuth + 8.5. e-TeX + 9. Build Hints + 10. History + + +1. Project latex-tds +===================== + +Version: 2013/02/26 + +1.1. How it has started +------------------------ + +The project started as I wanted to install the new LaTeX release 2005/12/01 +that was announced at 2006/04/27. However the files are not packed in TDS +format, ready for unpacking in the destination directory. And the documentation +files were not yet generated or the provided PDF files are lacking of basic +features such as bookmarks or link support. Thus this project has started. I +thought it could be finished during the afternoon at the day of the +announcement … + +1.2. Goals of the project +-------------------------- + + • From the sources a TDS compliant tree is constructed and populated. The + zipped result is distributed. + + • All the documentation is generated from the sources. The PDF files are user + friendly and provide navigational support with bookmarks and links. + + • The PDF files are post-processed to reduce the file size. + +1.3. Scope +----------- + +I do not have the time to assemble a TeX distribution with thousands of +packages. Therefore I restricted myself to the LaTeX base distribution and the +required bundles. In the following I will use the term ‘module’ for a package +bundle. + +1.4. Module list +----------------- + +base + + CTAN:macros/latex/base.zip + CTAN:macros/latex/doc.zip + http://www.latex-project.org/guides/lb2.err + http://www.latex-project.org/guides/lgc2.err + http://www.latex-project.org/guides/manual.err + http://www.latex-project.org/guides/tlc2.err + +tools + + CTAN:macros/latex/required/tools.zip + +cyrillic + + CTAN:macros/latex/required/cyrillic.zip + +amslatex + + CTAN:install/macros/latex/required/amslatex/amscls.tds.zip + CTAN:install/macros/latex/required/amslatex/math.tds.zip + CTAN:macros/latex/contrib/amsrefs.zip + CTAN:macros/latex/required/amslatex.zip + ftp://ftp.ams.org/pub/tex/amsrefs/amsrefs.zip + ftp://ftp.ams.org/pub/tex/amscls.zip + ftp://ftp.ams.org/pub/tex/amsmath.zip + +amsfonts + + CTAN:install/fonts/amsfonts.tds.zip + +psnfss + + CTAN:macros/latex/required/psnfss.zip + +babel + + CTAN:macros/latex/required/babel.zip + +tds + + CTAN:tds.zip + +knuth + + CTAN:systems/knuth/dist/errata.zip + CTAN:systems/knuth/dist/etc.zip + CTAN:systems/knuth/dist/mfware.zip + CTAN:systems/knuth/dist/texware.zip + CTAN:systems/knuth/dist/web.zip + CTAN:systems/knuth/dist/tex.zip + CTAN:systems/knuth/dist/mf.zip + +etex + + CTAN:systems/e-tex/v2.1/etex_doc.zip + +1.5. Author +------------ + +Heiko Oberdiek <heiko.oberdiek at googlemail.com> + +1.6. Home +---------- + +CTAN home with distribution files: + +CTAN:macros/latex/contrib/latex-tds/ + +Source repository (without distribution files): + +https://github.com/oberdiek/latex-tds + + +2. Abbreviations, Glossary +=========================== + +CTAN + + Comprehensive TeX Archive Network. + FAQ entry: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=archives + For example, you can resolve the prefix CTAN: by using http:// + mirror.ctan.org/. + +latex-tds + + The name of this project. + +TDS + + TeX Directory Structure. + FAQ entry: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds + Specification: http://www.ctan.org/pkg/tds + + +3. Download +============ + +The home of the project is located at: + +CTAN:macros/latex/contrib/latex-tds/ + +The following files can be downloaded: + + • README, README.html, README.pdf: The README file in different formats. + + • <module>.tds.zip: The module distribution files, see section ‘Module list’ + above for the available modules. + + • source.tds.zip: The sources, mainly the build script, configuration and + driver files, and patches. Some of the used tools are not provided, see + section ‘Build Hints’. + + • latex-tds.tds.zip: The universe, the contents of all the ZIP files above, + merged together. + + +4. Installation Hints +====================== + +Hopefully the result of this project helps you in the installation process. You +get a TDS compliant tree just by unpacking. + +Example: + + cd /some/where/texmf + unzip latex-tds + +or unzip’s option -d: + + unzip latex-tds -d /some/where/texmf + +Instead of the universe ZIP file single modules can be selected. + +Important to remember, point your unpack process right in the root directory of +your TDS tree. The directory structure in the ZIP files start with the +top-level directories: + + doc/latex/base/... + tex/latex/tools/... + source/... + +Rationale: The root directory of a TDS tree can have different names, such as +texmf-dist, texmf-local, … + +4.1. Hints +----------- + + • Refresh the file name database. + + • Be aware that unpacking can insert and update files, but never deletes + obsolete ones. Remainders of previous releases can cause trouble. + + • Depending on the module further installation steps can be necessary, + consult the module’s own documentation. + +4.1.1. Module base + + • The default texsys.cfg that LaTeX provides is put into TDS:tex/latex/base. + It must be removed, if you need a specialized version. Consult your TeX + distribution and TDS:doc/latex/base/source2e.pdf (module ltdirchk). Usually + changes are not required for many TeX distributions such as Unix (web2c), + MikTeX, … + + • Formats need rebuilding (e.g., fmtutil). + +4.1.2. Module babel + + • Most hyphenation patterns are not provided here. Usually you can find them + somewhere below CTAN:language/hyphenation/. + + • Language configuration (language.dat), see the documentation of your TeX + distribution. + + • Formats need rebuilding. + +4.1.3. Module psnfss + + • The map files need further configuring (e.g., updmap). + +4.1.4. Module graphics + + • Module graphics does not provide all driver files, because some are + developed independently (pdftex.def, …). + + +5. Copyright, License +====================== + +Copyright © 2006-2013 Heiko Oberdiek. + +License is LPPL 1.3c: + +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 (at your option) +any later version. The latest version of this license is in http:// +www.latex-project.org/lppl.txt and version 1.3c or later is part of all +distributions of LaTeX version 2005/12/01 or later. + +This work has the LPPL maintenance status ‘maintained’. + +The Current Maintainer of this work is Heiko Oberdiek. + +See the following section ‘Manifest’ for a list of all files belonging to the +project ‘latex-tds’. + + +6. Manifest +============ + +Included are the projects ‘adjust_checksum’ and ‘ziptimetree’. They are +projects of their own. + +6.1. Documentation +------------------- + +README this file + +6.2. Licenses +-------------- + +license/lppl.txt LPPL (The LaTeX Project Public License) for + latex-tds and adjust_checksum + +license/ziptimetree/lgpl.txt LGPL (GNU Lesser General Public License) for + ziptimetree + +6.3. Scripts +------------- + +build.pl main script for building the distribution + +lib/adjust_checksum.pl Perl script that runs a DTX file through LaTeX and + corrects its \Checksum if necessary + +lib/ziptimetree.pl Perl script that generates a ZIP file from a + directory tree with sorted entries (LGPL) + +6.4. Configuration +------------------- + +tex/docstrip.cfg enables TDS feature and creates directories + +tex/errata.cfg for errata lists of latex/base + +tex/hyperref.cfg hyperref configuration file + +tex/ltnews.cfg for LaTeX News of latex/base + +tex/ltxdoc.cfg setup for class ltxdoc + +tex/ltxguide.cfg setup for the guide manuals in latex/base and + required/psnfss + +tex/ltugboat.cls setup for class ltugboat + +tex/lualatex-tds.ini init file for format generation for LuaTeX + +tex/lualatex-tds2.ini init file for LuaTeX format without LM Math + +tex/manual.cfg setup for errata list of the LaTeX manual in latex/ + base + +tex/pdflatex-tds.ini init file for format generation for pdfTeX + +tex/tdsguide.cfg setup for class tdsguide.cls + +6.5. Documentation driver +-------------------------- + +tex/ams.drv generic doc driver for files from the amslatex and + babel bundle + +tex/babel.tex doc driver with patches for babel.drv + +tex/doc_lppl.tex doc driver for base/lppl.tex + +tex/errata.all doc driver for knuth/errata/errata.pdf + +tex/errata.drv doc driver for knuth/errata/errata_*.pdf + +tex/errorlog.drv doc driver for knuth/errata/errorlog.tex + +tex/etex_man.drv doc driver for etex/etex_man.tex + +tex/greek-usage.tex doc driver with patches for babel/usage.tex + +tex/knuth.drv doc driver for knuth/{texware,mfware,etc}+/*.web+ + +tex/ltnews.tex master file that merges all base/ltnews*.tex + +tex/ltxcheck.drv doc driver with patches for ltxcheck.tex + +tex/psnfss2e.drv doc driver with patches for psnfss2e.tex + +tex/tools-overview.cls class for tools.tex + +tex/tools.tex master file for tools overview, generated by the + build.pl script from tools/manifest.txt + +6.6. Patches +------------- + +Diff/patch file Patched file + +patch/amsclass.dtx.diff amslatex/amsclass.dtx + +patch/amsfndoc.def.diff amsfonts/amsfndoc.def + +patch/amsfndoc.tex.diff amsfonts/amsfndoc.tex + +patch/amsldoc.tex.diff amslatex/amsldoc.tex + +patch/changes.tex.diff amslatex/amsrefs/changes.tex + +patch/encguide.tex.diff base/encguide.tex + +patch/hebrew.fdd.diff babel/hebrew.fdd + +patch/logmac.tex.diff knuth/errata/logmac.tex + +patch/source2e.tex.diff base/source2e.tex + +patch/tlc2.err.diff base/tlc2.err + +patch/tripman.tex.diff knuth/tex/tripman.tex + +patch/trapman.tex.diff knuth/mf/trapman.tex + +patch/utf8ienc.dtx.diff base/utf8ienc.dtx + +patch/webman.tex.diff knuth/web/webman.tex + + +7. Design Principles +===================== + + • Compliance with the latest TDS specification. + + • No redundancy. + + • User friendly PDF files with navigational support: + + □ bookmarks + + □ links + + • Complete documentation. The documentation generation with enhanced PDF + files is the tricky part and should be saved from the user. + + • Output format of generated documentation is PDF, see above. Other formats + such as DVI or PS are not generated and provided. + + • Documentation bundles are preferred to many partial documentation files + (e.g. source2e.pdf or ltnews.pdf). + + • If several expansion stages of a documentation are available, then just the + most complete expansion stage should be used. + + • Files that do not fit in a program sub tree of TDS stay below TDS:source + (e.g. latexbug.el from latex/base). Then they do not get lost at least. + + • Page layout: a4paper with reduced vertical margins (exception: ltnews). + (This also decreases the page number usually.) + + • … + + +8. Remarks +=========== + +8.1. Base +---------- + + • source2e.pdf is used instead of many single lt*.pdf files. + + • ltnews.pdf is introduced to avoid cluttering the doc directory with many + single sheet ltnews*.pdf files. + + • Patch for ltfssdcl.dtx: Checksum fixed. + + • … + +8.2. Tools +----------- + + • Added: tools.pdf as overview/contents/index file with links and short + descriptions of the single packages. (It uses the data from manifest.txt). + + • … + +8.3. Babel +----------- + + • Babel’s TeX files consists of three groups of files: + + 1. Hyphenation pattern, see below. + + 2. Generic files: + + ☆ *.ldf (language definition files) + + ☆ *.sty (from bbcompat.dtx, these are plain TeX files, LaTeX user + have the package babel) + + ☆ babel.def, switch.def + + ☆ plain.def + + ☆ b*plain.tex + + ☆ esbst.tex + + 3. LaTeX files: + + ☆ *.fd + + ☆ *enc.def (for package fontenc) + + ☆ cp*.def, 8859-8.def, si960.def (for package inputenc) + + ☆ babel.sty + + ☆ romanidx.tex + + ☆ athnum.sty, grmath.sty, grsymb.sty (greek.ins) + + ☆ heb*.sty + + Full TDS compliance would use different format subtrees for the generic + and LaTeX files. However practice (TeX Live, teTeX, VTeX, …) put them + in generic, mainly because of maintenance issues. Also babel’s *.ins + files specify \usedir{tex/generic/babel}. There can be problems, if + different TDS trees have different babel versions installed and the + same file can be found both in generic and latex. The natural search + strategy for TDS compliant trees would be to look first in tex/latex + across the trees, then in tex/generic. Thus it can happen to use files + from the same package, but different versions. Therefore latex-tds put + these files in the generic subtree. + + • Babel already contains babel.pdf as documentation. It is a superset of + user.pdf. Thus I have dropped the latter one to avoid redundancy. Also the + name babel.pdf is much more useful (texdoc). + + • … + +8.4. Knuth +----------- + + • Current CTAN → TDS mapping in use: CTAN:systems/knuth/dist → TDS:<toplevel> + /knuth + + • Unsure where to put trip/trap files. Currently they are put in TDS:source, + because the documentation files (tripman.pdf, trapman.pdf) are in TDS:doc. + They lists the trip/trap files already. + + • Not covered is CTAN:systems/knuth/dist/lib/ In TeX Live 2007/2008 the files + are installed at different locations: + + texmf-dist/fonts/source/public/mflogo/logo10.mf + texmf-dist/fonts/source/public/mflogo/logo8.mf + texmf-dist/fonts/source/public/mflogo/logo9.mf + texmf-dist/fonts/source/public/mflogo/logobf10.mf + texmf-dist/fonts/source/public/mflogo/logo.mf + texmf-dist/fonts/source/public/mflogo/logosl10.mf + texmf-dist/fonts/source/public/misc/grayf.mf + texmf-dist/fonts/source/public/misc/manfnt.mf + texmf-dist/fonts/source/public/misc/slant.mf + texmf-dist/metafont/base/expr.mf + texmf-dist/metafont/base/io.mf + texmf-dist/metafont/base/null.mf + texmf-dist/metafont/base/plain.mf + texmf-dist/metafont/misc/3test.mf + texmf-dist/metafont/misc/6test.mf + texmf-dist/metafont/misc/rtest.mf + texmf-dist/metafont/misc/test.mf + texmf-dist/metafont/misc/waits.mf + texmf-dist/metafont/misc/ztest.mf + texmf-dist/mft/base/cmbase.mft + texmf-dist/mft/base/plain.mft + texmf-dist/tex/generic/misc/null.tex + texmf-dist/tex/plain/base/manmac.tex + texmf-dist/tex/plain/base/mftmac.tex + texmf-dist/tex/plain/base/plain.tex + texmf-dist/tex/plain/base/story.tex + texmf-dist/tex/plain/base/testfont.tex + texmf-dist/tex/plain/base/webmac.tex + texmf/tex/generic/hyphen/hyphen.tex + +8.5. e-TeX +----------- + + • Only the manual ‘etex_man’ is covered by this module. + + +9. Build Hints +=============== + +The most important advice I can give: ‘Forget it’! The purpose of the source +files are rather to show, what was done in which way. The *.zip with TDS trees +are the goal of the project, not the build process. Some remarks, if someone +wants to build the modules himself: + + • TeX compiler: LuaTeX and pdfTeX (≥ 1.30). + + • An up-to-date LaTeX installation, at least TeX Live 2012. + + • Additional packages can be necessary, e.g. CTAN:language/armenian/ + armtex.zip is not part of TeX Live 2012. + + • Most of the PDF files are generated using lualatex and package ‘fontspec’ + that uses the Latin Modern fonts as default. They are available as OpenType + fonts. LuaTeX generates with OpenType fonts considerably smaller PDF files. + Also PDF object stream compression is used (PDF 1.5). Therefore the further + post-processing of PDF files are currently dropped. + + • (Outdated since 2011-07-01) PDF post-processing, I have used two steps: + + 1. First step: + + 1. I have written a tool that analyzes page stream contents and + optimizes them (removal of unnecessary color settings, minimize + translation operations, …) → pdfbox-rewrite.jar. + + 2. For reading and writing the PDF file I have used PDFBox → + PDFBox-0.7.2.jar (http://pdfbox.apache.org/). + + 3. To get better results I patched some of the classes of PDFBox + (especially the write module) → pdfbox-rewrite.jar. + + 2. The final conversion step was done by Multivalent, because it makes a + very good job in PDF compression: → Multivalent20060102.jar (http:// + multivalent.sourceforge.net/) + + Multivalent and PDFBox are available, pdfbox-rewrite.jar, however, is just + a first prototype, not ripe for a release. Therefore this step of + post-processing is optional for the project latex-tds. The build script + looks for the library and skips this steps automatically if necessary. If + you give the build script the option --nopostprocess, then it will skip the + postprocess steps (building is faster, the pdf files a little larger). + Install the jar files in the directory lib where they are expected by the + build script. + + • Unix, Perl background is expected. + + • No support or documentation. + + +10. History +============ + +2006/04/27 + □ Start of the project (without babel, amslatex, psnfss). + +2006/06/01 + □ Module amslatex added. + +2006/06/03 + □ Modules psnfss and babel added, now all modules are covered. + +2006/06/07 + □ The project uploaded to CTAN. + +2006/07/31 + □ Index added to base/classes.dtx. + + □ ZIP files renamed: *-tds.zip → *.zip + + □ Comment added to ZIP files. + + □ Update of readme.txt. + +2006/08/26 + □ Module tds for CTAN:tds/ added. + + □ Obsolete hyphenation patterns added to babel’s source directory to + avoid violation of LPPL. + + □ Script adjust_checksum added and scripts are put below TDS:scripts. + + □ TDS:makeindex/base/ renamed to TDS:makeindex/latex/ + + □ Exception for sample2e.tex and small2e.tex that now go into TDS:tex/ + latex/base/. + +2006/08/28 + □ Default texsys.cfg is generated. + + □ adjust_checksum.pl and ziptimetree.pl now moved from the scripts branch + to TDS:source/latex/latex-tds/lib/. + +2006/12/27 + □ Fix of ltxguide.cfg that had loaded doc.sty that disturbs the verbatim + stuff in fntguide.tex. + +2007/01/08 + □ Fix for documentation of longtable. + +2007/03/19 + □ Patch for babel/latin.dtx added (babel/3922). + +2007/09/04 + □ A minor update on CTAN regarding babel: iahyphen.tex, icehyph.tex, and + lahyph.tex are now symbolic links to their location in CTAN:language/ + hyphenation/. Therefore also lahyph.tex is now installed in TDS:tex/ + generic/hyphen/. + +2007/10/18 + □ Update of module amslatex because of updated package amsrefs. + + □ Fix in latin.dtx.diff. + +2007/10/24 + □ Update of babel. + + □ Update of amsrefs (TDS:tex/latex/amscls → TDS:tex/latex/amsrefs). + +2008/04/01 + □ Update of babel (2008/03/17). + +2008/04/02 + □ Fix: latex/base/*.err added to TDS:source/latex/base/. + +2008/04/05 + □ Using .tds.zip instead of .zip to follow CTAN:install's naming + conventions. + +2008/06/28 + □ Update of babel (2008/06/01). + + □ Babel documentation: table of contents reformatted. + +2008/07/07 + □ Update of babel (2008/07/06). + +2008/07/10 + □ Module knuth added. + + □ Update of babel (2008/07/07). + +2008/07/11 + □ Fixes and additions for module knuth. + +2008/07/25 + □ Module amslatex: instr-l.tex vanished from CTAN (but not at AMS side). + + □ Some unwanted spaces in generated PDF files fixed. (Caused by a wrong + package file that was found on my system first.) + +2008/08/10 + □ Module latex3 added. + + □ Module base: CTAN hyperlinks fixed. + + □ Module amslatex: Outdated URL fixed in amsldoc.tex. + + □ Module babel: Problem with already defined \meta in tb1604.tex fixed. + +2008/09/06 + □ Module base: + + ☆ Using uptodate versions from LaTeX project page for errata lists. + + ☆ lgc2.err added (LaTeX Graphics Companion, 2. ed.). + + ☆ Various fixes in errata lists. + + □ Module tools: array.dtx: documentation fixed (tools/4044). + +2008/09/10 + □ Module base: Missing title date for utf8ienc.pdf fixed. + +2009/09/05 + □ Module amslatex: updated. + + □ Module latex3: xpackages updated. + + □ Module latex3: expl3 removed, because nothing to do. + +2009/09/25 + □ Module amslatex: updated. + + □ Module babel: updated. + + □ Update of LaTeX, release 2009/09/24. + +2009/12/07 + □ Module amslatex: Unhappily the .zip files are quite a mess, because + they contain a mixup of old and new versions. Tried to sort this out + and fix the last update. + + □ Module latex3: xpackages removed, because nothing to do. + + □ Module latex3 removed, nothing left to do. + +2010/05/04 + □ Module base: page layout for source2e fixed (changes, index). + + □ Module base: update of .err files. + +2010/10/27 + □ Module amslatex: amscls and amsrefs updated. + + □ Module etex added (only for etex_man). + + □ Erratas updated. + +2011/03/10 + □ Module base: patch for latex/4148 (Missing \label and \ref in + lppl.tex). + +2011/04/18 + □ Module amslatex: There is an outdated version of amsthm.sty in + CTAN:install/macros/latex/required/amslatex/amscls.tds.zip. The package + amsthm.sty is now generated from the source. + + □ Using TDS tree for missing packages that are not part of TeX Live. + Module base: CTAN:language/armenian/armtex.zip. + +2011/06/24 + □ Module amslatex: Two downloads from AMS server removed, because the + files are not longer available (and they are on CTAN). + + □ Module amslatex: 00readme.txt and amsrefs.dtx taken from CTAN:macros/ + latex/contrib/amsrefs.zip instead of CTAN:install/macros/latex/contrib/ + amsrefs.tds.zip because the later archive file is out of sync. + +2011/06/30 + □ Module base: + + ☆ Update of LaTeX, release 2011/06/27. + + ☆ Patch ltpatch.ltx to match the kernel version. + + ☆ Patch lppl.tex.diff removed (no longer needed). + + ☆ Patch ltfssdcl.dtx.diff added (checksum fixed). + + □ Module tools: Release 2011/06. + + □ Module babel: Release 2011/06. + +2011/07/01 + □ PDF generation: + + ☆ Use of LuaTeX instead of pdfTeX for most of the files. + + ☆ Use of package ‘fontspec’ with Latin Modern fonts as default in + OpenType format (smaller PDF file sizes). The post-processing of + PDF files is skipped. + + ☆ Various patches and fixes for LuaLaTeX and package ‘fontspec’. + + □ Module base: + + ☆ Update of LaTeX. + + ☆ Patches ltpatch.ltx.diff and ltfssdcl.dtx.diff removed (no longer + needed). + + □ Module tools: Update. + +2011/07/03 + □ build.pl: + + ☆ Caching for PDF generation added. + + ☆ ‘FINAL’ markers in the output of build.pl for final (Lua|pdf)TeX + runs. + +2011/07/26 + □ PDF generation: Use of package unicode-math with Latin Modern Math + where possible. + +2011/08/10 + □ Update of tools. + +2011/10/05 + □ Update of tools (varioref). + +2011/11/16 + □ Update of babel. + +2012/05/12 + □ Update of amslatex (amsrefs). + + □ Update of readme.txt that is renamed to README (CTAN convention). + + □ Update of tlc2.err. + +2013/02/14 + □ Update of amslatex (amsrefs). + + □ Module amslatex: cite-x*.tex, jb.bib in TDS:source/, because these + files are now classified as test files. + + □ Module base: lb2.err and tlc2.err updated. + + □ Change in version control system from CVS to git with public source + repository. + +2013/02/15 + □ Module amsfonts added. + +2013/02/25 + □ Patch file lb2.err.diff removed by call of sed inside build.pl. + + □ README rewritten in text document format AsciiDoc and added as HTML and + PDF files. + + □ README.asciidoc updated. + + □ Makefile: Target ‘check-links’ added. + +2013/02/26 + □ README generated from README.asciidoc via README.html. + +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ +Last updated 2013-02-26 04:22:43 CET diff --git a/Master/texmf-dist/doc/latex/latex-tds/README.html b/Master/texmf-dist/doc/latex/latex-tds/README.html new file mode 100644 index 00000000000..3bc4d4b8410 --- /dev/null +++ b/Master/texmf-dist/doc/latex/latex-tds/README.html @@ -0,0 +1,2694 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
+ "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
+<head>
+<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
+<meta name="generator" content="AsciiDoc 8.6.6" />
+<title>README for project latex-tds</title>
+<style type="text/css">
+/* Shared CSS for AsciiDoc xhtml11 and html5 backends */
+
+/* Default font. */
+body {
+ font-family: Georgia,serif;
+}
+
+/* Title font. */
+h1, h2, h3, h4, h5, h6,
+div.title, caption.title,
+thead, p.table.header,
+#toctitle,
+#author, #revnumber, #revdate, #revremark,
+#footer {
+ font-family: Arial,Helvetica,sans-serif;
+}
+
+body {
+ margin: 1em 5% 1em 5%;
+}
+
+a {
+ color: blue;
+ text-decoration: underline;
+}
+a:visited {
+ color: fuchsia;
+}
+
+em {
+ font-style: italic;
+ color: navy;
+}
+
+strong {
+ font-weight: bold;
+ color: #083194;
+}
+
+h1, h2, h3, h4, h5, h6 {
+ color: #527bbd;
+ margin-top: 1.2em;
+ margin-bottom: 0.5em;
+ line-height: 1.3;
+}
+
+h1, h2, h3 {
+ border-bottom: 2px solid silver;
+}
+h2 {
+ padding-top: 0.5em;
+}
+h3 {
+ float: left;
+}
+h3 + * {
+ clear: left;
+}
+h5 {
+ font-size: 1.0em;
+}
+
+div.sectionbody {
+ margin-left: 0;
+}
+
+hr {
+ border: 1px solid silver;
+}
+
+p {
+ margin-top: 0.5em;
+ margin-bottom: 0.5em;
+}
+
+ul, ol, li > p {
+ margin-top: 0;
+}
+ul > li { color: #aaa; }
+ul > li > * { color: black; }
+
+pre {
+ padding: 0;
+ margin: 0;
+}
+
+#author {
+ color: #527bbd;
+ font-weight: bold;
+ font-size: 1.1em;
+}
+#email {
+}
+#revnumber, #revdate, #revremark {
+}
+
+#footer {
+ font-size: small;
+ border-top: 2px solid silver;
+ padding-top: 0.5em;
+ margin-top: 4.0em;
+}
+#footer-text {
+ float: left;
+ padding-bottom: 0.5em;
+}
+#footer-badges {
+ float: right;
+ padding-bottom: 0.5em;
+}
+
+#preamble {
+ margin-top: 1.5em;
+ margin-bottom: 1.5em;
+}
+div.imageblock, div.exampleblock, div.verseblock,
+div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
+div.admonitionblock {
+ margin-top: 1.0em;
+ margin-bottom: 1.5em;
+}
+div.admonitionblock {
+ margin-top: 2.0em;
+ margin-bottom: 2.0em;
+ margin-right: 10%;
+ color: #606060;
+}
+
+div.content { /* Block element content. */
+ padding: 0;
+}
+
+/* Block element titles. */
+div.title, caption.title {
+ color: #527bbd;
+ font-weight: bold;
+ text-align: left;
+ margin-top: 1.0em;
+ margin-bottom: 0.5em;
+}
+div.title + * {
+ margin-top: 0;
+}
+
+td div.title:first-child {
+ margin-top: 0.0em;
+}
+div.content div.title:first-child {
+ margin-top: 0.0em;
+}
+div.content + div.title {
+ margin-top: 0.0em;
+}
+
+div.sidebarblock > div.content {
+ background: #ffffee;
+ border: 1px solid #dddddd;
+ border-left: 4px solid #f0f0f0;
+ padding: 0.5em;
+}
+
+div.listingblock > div.content {
+ border: 1px solid #dddddd;
+ border-left: 5px solid #f0f0f0;
+ background: #f8f8f8;
+ padding: 0.5em;
+}
+
+div.quoteblock, div.verseblock {
+ padding-left: 1.0em;
+ margin-left: 1.0em;
+ margin-right: 10%;
+ border-left: 5px solid #f0f0f0;
+ color: #888;
+}
+
+div.quoteblock > div.attribution {
+ padding-top: 0.5em;
+ text-align: right;
+}
+
+div.verseblock > pre.content {
+ font-family: inherit;
+ font-size: inherit;
+}
+div.verseblock > div.attribution {
+ padding-top: 0.75em;
+ text-align: left;
+}
+/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
+div.verseblock + div.attribution {
+ text-align: left;
+}
+
+div.admonitionblock .icon {
+ vertical-align: top;
+ font-size: 1.1em;
+ font-weight: bold;
+ text-decoration: underline;
+ color: #527bbd;
+ padding-right: 0.5em;
+}
+div.admonitionblock td.content {
+ padding-left: 0.5em;
+ border-left: 3px solid #dddddd;
+}
+
+div.exampleblock > div.content {
+ border-left: 3px solid #dddddd;
+ padding-left: 0.5em;
+}
+
+div.imageblock div.content { padding-left: 0; }
+span.image img { border-style: none; }
+a.image:visited { color: white; }
+
+dl {
+ margin-top: 0.8em;
+ margin-bottom: 0.8em;
+}
+dt {
+ margin-top: 0.5em;
+ margin-bottom: 0;
+ font-style: normal;
+ color: navy;
+}
+dd > *:first-child {
+ margin-top: 0.1em;
+}
+
+ul, ol {
+ list-style-position: outside;
+}
+ol.arabic {
+ list-style-type: decimal;
+}
+ol.loweralpha {
+ list-style-type: lower-alpha;
+}
+ol.upperalpha {
+ list-style-type: upper-alpha;
+}
+ol.lowerroman {
+ list-style-type: lower-roman;
+}
+ol.upperroman {
+ list-style-type: upper-roman;
+}
+
+div.compact ul, div.compact ol,
+div.compact p, div.compact p,
+div.compact div, div.compact div {
+ margin-top: 0.1em;
+ margin-bottom: 0.1em;
+}
+
+tfoot {
+ font-weight: bold;
+}
+td > div.verse {
+ white-space: pre;
+}
+
+div.hdlist {
+ margin-top: 0.8em;
+ margin-bottom: 0.8em;
+}
+div.hdlist tr {
+ padding-bottom: 15px;
+}
+dt.hdlist1.strong, td.hdlist1.strong {
+ font-weight: bold;
+}
+td.hdlist1 {
+ vertical-align: top;
+ font-style: normal;
+ padding-right: 0.8em;
+ color: navy;
+}
+td.hdlist2 {
+ vertical-align: top;
+}
+div.hdlist.compact tr {
+ margin: 0;
+ padding-bottom: 0;
+}
+
+.comment {
+ background: yellow;
+}
+
+.footnote, .footnoteref {
+ font-size: 0.8em;
+}
+
+span.footnote, span.footnoteref {
+ vertical-align: super;
+}
+
+#footnotes {
+ margin: 20px 0 20px 0;
+ padding: 7px 0 0 0;
+}
+
+#footnotes div.footnote {
+ margin: 0 0 5px 0;
+}
+
+#footnotes hr {
+ border: none;
+ border-top: 1px solid silver;
+ height: 1px;
+ text-align: left;
+ margin-left: 0;
+ width: 20%;
+ min-width: 100px;
+}
+
+div.colist td {
+ padding-right: 0.5em;
+ padding-bottom: 0.3em;
+ vertical-align: top;
+}
+div.colist td img {
+ margin-top: 0.3em;
+}
+
+@media print {
+ #footer-badges { display: none; }
+}
+
+#toc {
+ margin-bottom: 2.5em;
+}
+
+#toctitle {
+ color: #527bbd;
+ font-size: 1.1em;
+ font-weight: bold;
+ margin-top: 1.0em;
+ margin-bottom: 0.1em;
+}
+
+div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
+ margin-top: 0;
+ margin-bottom: 0;
+}
+div.toclevel2 {
+ margin-left: 2em;
+ font-size: 0.9em;
+}
+div.toclevel3 {
+ margin-left: 4em;
+ font-size: 0.9em;
+}
+div.toclevel4 {
+ margin-left: 6em;
+ font-size: 0.9em;
+}
+
+span.aqua { color: aqua; }
+span.black { color: black; }
+span.blue { color: blue; }
+span.fuchsia { color: fuchsia; }
+span.gray { color: gray; }
+span.green { color: green; }
+span.lime { color: lime; }
+span.maroon { color: maroon; }
+span.navy { color: navy; }
+span.olive { color: olive; }
+span.purple { color: purple; }
+span.red { color: red; }
+span.silver { color: silver; }
+span.teal { color: teal; }
+span.white { color: white; }
+span.yellow { color: yellow; }
+
+span.aqua-background { background: aqua; }
+span.black-background { background: black; }
+span.blue-background { background: blue; }
+span.fuchsia-background { background: fuchsia; }
+span.gray-background { background: gray; }
+span.green-background { background: green; }
+span.lime-background { background: lime; }
+span.maroon-background { background: maroon; }
+span.navy-background { background: navy; }
+span.olive-background { background: olive; }
+span.purple-background { background: purple; }
+span.red-background { background: red; }
+span.silver-background { background: silver; }
+span.teal-background { background: teal; }
+span.white-background { background: white; }
+span.yellow-background { background: yellow; }
+
+span.big { font-size: 2em; }
+span.small { font-size: 0.6em; }
+
+span.underline { text-decoration: underline; }
+span.overline { text-decoration: overline; }
+span.line-through { text-decoration: line-through; }
+
+
+/*
+ * xhtml11 specific
+ *
+ * */
+
+tt {
+ font-family: monospace;
+ font-size: inherit;
+ color: navy;
+}
+
+div.tableblock {
+ margin-top: 1.0em;
+ margin-bottom: 1.5em;
+}
+div.tableblock > table {
+ border: 3px solid #527bbd;
+}
+thead, p.table.header {
+ font-weight: bold;
+ color: #527bbd;
+}
+p.table {
+ margin-top: 0;
+}
+/* Because the table frame attribute is overriden by CSS in most browsers. */
+div.tableblock > table[frame="void"] {
+ border-style: none;
+}
+div.tableblock > table[frame="hsides"] {
+ border-left-style: none;
+ border-right-style: none;
+}
+div.tableblock > table[frame="vsides"] {
+ border-top-style: none;
+ border-bottom-style: none;
+}
+
+
+/*
+ * html5 specific
+ *
+ * */
+
+.monospaced {
+ font-family: monospace;
+ font-size: inherit;
+ color: navy;
+}
+
+table.tableblock {
+ margin-top: 1.0em;
+ margin-bottom: 1.5em;
+}
+thead, p.tableblock.header {
+ font-weight: bold;
+ color: #527bbd;
+}
+p.tableblock {
+ margin-top: 0;
+}
+table.tableblock {
+ border-width: 3px;
+ border-spacing: 0px;
+ border-style: solid;
+ border-color: #527bbd;
+ border-collapse: collapse;
+}
+th.tableblock, td.tableblock {
+ border-width: 1px;
+ padding: 4px;
+ border-style: solid;
+ border-color: #527bbd;
+}
+
+table.tableblock.frame-topbot {
+ border-left-style: hidden;
+ border-right-style: hidden;
+}
+table.tableblock.frame-sides {
+ border-top-style: hidden;
+ border-bottom-style: hidden;
+}
+table.tableblock.frame-none {
+ border-style: hidden;
+}
+
+th.tableblock.halign-left, td.tableblock.halign-left {
+ text-align: left;
+}
+th.tableblock.halign-center, td.tableblock.halign-center {
+ text-align: center;
+}
+th.tableblock.halign-right, td.tableblock.halign-right {
+ text-align: right;
+}
+
+th.tableblock.valign-top, td.tableblock.valign-top {
+ vertical-align: top;
+}
+th.tableblock.valign-middle, td.tableblock.valign-middle {
+ vertical-align: middle;
+}
+th.tableblock.valign-bottom, td.tableblock.valign-bottom {
+ vertical-align: bottom;
+}
+
+
+/*
+ * manpage specific
+ *
+ * */
+
+body.manpage h1 {
+ padding-top: 0.5em;
+ padding-bottom: 0.5em;
+ border-top: 2px solid silver;
+ border-bottom: 2px solid silver;
+}
+body.manpage h2 {
+ border-style: none;
+}
+body.manpage div.sectionbody {
+ margin-left: 3em;
+}
+
+@media print {
+ body.manpage div#toc { display: none; }
+}
+</style>
+<script type="text/javascript">
+/*<![CDATA[*/
+var asciidoc = { // Namespace.
+
+/////////////////////////////////////////////////////////////////////
+// Table Of Contents generator
+/////////////////////////////////////////////////////////////////////
+
+/* Author: Mihai Bazon, September 2002
+ * http://students.infoiasi.ro/~mishoo
+ *
+ * Table Of Content generator
+ * Version: 0.4
+ *
+ * Feel free to use this script under the terms of the GNU General Public
+ * License, as long as you do not remove or alter this notice.
+ */
+
+ /* modified by Troy D. Hanson, September 2006. License: GPL */
+ /* modified by Stuart Rackham, 2006, 2009. License: GPL */
+
+// toclevels = 1..4.
+toc: function (toclevels) {
+
+ function getText(el) {
+ var text = "";
+ for (var i = el.firstChild; i != null; i = i.nextSibling) {
+ if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
+ text += i.data;
+ else if (i.firstChild != null)
+ text += getText(i);
+ }
+ return text;
+ }
+
+ function TocEntry(el, text, toclevel) {
+ this.element = el;
+ this.text = text;
+ this.toclevel = toclevel;
+ }
+
+ function tocEntries(el, toclevels) {
+ var result = new Array;
+ var re = new RegExp('[hH]([2-'+(toclevels+1)+'])');
+ // Function that scans the DOM tree for header elements (the DOM2
+ // nodeIterator API would be a better technique but not supported by all
+ // browsers).
+ var iterate = function (el) {
+ for (var i = el.firstChild; i != null; i = i.nextSibling) {
+ if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
+ var mo = re.exec(i.tagName);
+ if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {
+ result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
+ }
+ iterate(i);
+ }
+ }
+ }
+ iterate(el);
+ return result;
+ }
+
+ var toc = document.getElementById("toc");
+ if (!toc) {
+ return;
+ }
+
+ // Delete existing TOC entries in case we're reloading the TOC.
+ var tocEntriesToRemove = [];
+ var i;
+ for (i = 0; i < toc.childNodes.length; i++) {
+ var entry = toc.childNodes[i];
+ if (entry.nodeName == 'div'
+ && entry.getAttribute("class")
+ && entry.getAttribute("class").match(/^toclevel/))
+ tocEntriesToRemove.push(entry);
+ }
+ for (i = 0; i < tocEntriesToRemove.length; i++) {
+ toc.removeChild(tocEntriesToRemove[i]);
+ }
+
+ // Rebuild TOC entries.
+ var entries = tocEntries(document.getElementById("content"), toclevels);
+ for (var i = 0; i < entries.length; ++i) {
+ var entry = entries[i];
+ if (entry.element.id == "")
+ entry.element.id = "_toc_" + i;
+ var a = document.createElement("a");
+ a.href = "#" + entry.element.id;
+ a.appendChild(document.createTextNode(entry.text));
+ var div = document.createElement("div");
+ div.appendChild(a);
+ div.className = "toclevel" + entry.toclevel;
+ toc.appendChild(div);
+ }
+ if (entries.length == 0)
+ toc.parentNode.removeChild(toc);
+},
+
+
+/////////////////////////////////////////////////////////////////////
+// Footnotes generator
+/////////////////////////////////////////////////////////////////////
+
+/* Based on footnote generation code from:
+ * http://www.brandspankingnew.net/archive/2005/07/format_footnote.html
+ */
+
+footnotes: function () {
+ // Delete existing footnote entries in case we're reloading the footnodes.
+ var i;
+ var noteholder = document.getElementById("footnotes");
+ if (!noteholder) {
+ return;
+ }
+ var entriesToRemove = [];
+ for (i = 0; i < noteholder.childNodes.length; i++) {
+ var entry = noteholder.childNodes[i];
+ if (entry.nodeName == 'div' && entry.getAttribute("class") == "footnote")
+ entriesToRemove.push(entry);
+ }
+ for (i = 0; i < entriesToRemove.length; i++) {
+ noteholder.removeChild(entriesToRemove[i]);
+ }
+
+ // Rebuild footnote entries.
+ var cont = document.getElementById("content");
+ var spans = cont.getElementsByTagName("span");
+ var refs = {};
+ var n = 0;
+ for (i=0; i<spans.length; i++) {
+ if (spans[i].className == "footnote") {
+ n++;
+ var note = spans[i].getAttribute("data-note");
+ if (!note) {
+ // Use [\s\S] in place of . so multi-line matches work.
+ // Because JavaScript has no s (dotall) regex flag.
+ note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];
+ spans[i].innerHTML =
+ "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +
+ "' title='View footnote' class='footnote'>" + n + "</a>]";
+ spans[i].setAttribute("data-note", note);
+ }
+ noteholder.innerHTML +=
+ "<div class='footnote' id='_footnote_" + n + "'>" +
+ "<a href='#_footnoteref_" + n + "' title='Return to text'>" +
+ n + "</a>. " + note + "</div>";
+ var id =spans[i].getAttribute("id");
+ if (id != null) refs["#"+id] = n;
+ }
+ }
+ if (n == 0)
+ noteholder.parentNode.removeChild(noteholder);
+ else {
+ // Process footnoterefs.
+ for (i=0; i<spans.length; i++) {
+ if (spans[i].className == "footnoteref") {
+ var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");
+ href = href.match(/#.*/)[0]; // Because IE return full URL.
+ n = refs[href];
+ spans[i].innerHTML =
+ "[<a href='#_footnote_" + n +
+ "' title='View footnote' class='footnote'>" + n + "</a>]";
+ }
+ }
+ }
+},
+
+install: function(toclevels) {
+ var timerId;
+
+ function reinstall() {
+ asciidoc.footnotes();
+ if (toclevels) {
+ asciidoc.toc(toclevels);
+ }
+ }
+
+ function reinstallAndRemoveTimer() {
+ clearInterval(timerId);
+ reinstall();
+ }
+
+ timerId = setInterval(reinstall, 500);
+ if (document.addEventListener)
+ document.addEventListener("DOMContentLoaded", reinstallAndRemoveTimer, false);
+ else
+ window.onload = reinstallAndRemoveTimer;
+}
+
+}
+asciidoc.install(2);
+/*]]>*/
+</script>
+</head>
+<body class="article">
+<div id="header">
+<h1>README for project latex-tds</h1>
+<span id="author">Heiko Oberdiek</span><br />
+<span id="revdate">2013/02/26</span>
+<div id="toc"> + <div id="toctitle">Table of Contents</div> + <noscript><p><b>JavaScript must be enabled in your browser to display the table of contents.</b></p></noscript> +</div>
+</div>
+<div id="content">
+<div class="sect1">
+<h2 id="_project_latex_tds">1. Project latex-tds</h2>
+<div class="sectionbody">
+<div class="paragraph"><p>Version: 2013/02/26</p></div>
+<div class="sect2">
+<h3 id="_how_it_has_started">1.1. How it has started</h3>
+<div class="paragraph"><p>The project started as I wanted to install the new LaTeX release 2005/12/01
+that was announced at 2006/04/27. However the files are not packed in
+TDS format, ready for unpacking in the destination directory. And
+the documentation files were not yet generated or the provided
+PDF files are lacking of basic features such as bookmarks or link support.
+Thus this project has started. I thought it could be finished during
+the afternoon at the day of the announcement …</p></div>
+</div>
+<div class="sect2">
+<h3 id="_goals_of_the_project">1.2. Goals of the project</h3>
+<div class="ulist"><ul>
+<li>
+<p>
+From the sources a TDS compliant tree is constructed and populated.
+ The zipped result is distributed.
+</p>
+</li>
+<li>
+<p>
+All the documentation is generated from the sources. The PDF files
+ are user friendly and provide navigational support with bookmarks
+ and links.
+</p>
+</li>
+<li>
+<p>
+The PDF files are post-processed to reduce the file size.
+</p>
+</li>
+</ul></div>
+</div>
+<div class="sect2">
+<h3 id="_scope">1.3. Scope</h3>
+<div class="paragraph"><p>I do not have the time to assemble a TeX distribution with
+thousands of packages. Therefore I restricted myself to the
+LaTeX base distribution and the required bundles.
+In the following I will use the term ‘module’ for a package bundle.</p></div>
+</div>
+<div class="sect2">
+<h3 id="_module_list">1.4. Module list</h3>
+<div class="dlist"><dl>
+<dt class="hdlist1">
+<strong>base</strong>
+</dt>
+<dd>
+<p>
+ <a href="http://mirror.ctan.org/macros/latex/base.zip">CTAN:macros/latex/base.zip</a><br />
+ <a href="http://mirror.ctan.org/macros/latex/doc.zip">CTAN:macros/latex/doc.zip</a><br />
+ <a href="http://www.latex-project.org/guides/lb2.err">http://www.latex-project.org/guides/lb2.err</a><br />
+ <a href="http://www.latex-project.org/guides/lgc2.err">http://www.latex-project.org/guides/lgc2.err</a><br />
+ <a href="http://www.latex-project.org/guides/manual.err">http://www.latex-project.org/guides/manual.err</a><br />
+ <a href="http://www.latex-project.org/guides/tlc2.err">http://www.latex-project.org/guides/tlc2.err</a><br />
+</p>
+</dd>
+<dt class="hdlist1">
+<strong>tools</strong>
+</dt>
+<dd>
+<p>
+ <a href="http://mirror.ctan.org/macros/latex/required/tools">CTAN:macros/latex/required/tools.zip</a>
+</p>
+</dd>
+<dt class="hdlist1">
+<strong>cyrillic</strong>
+</dt>
+<dd>
+<p>
+ <a href="http://mirror.ctan.org/macros/latex/required/cyrillic.zip">CTAN:macros/latex/required/cyrillic.zip</a>
+</p>
+</dd>
+<dt class="hdlist1">
+<strong>amslatex</strong>
+</dt>
+<dd>
+<p>
+ <a href="http://mirror.ctan.org/install/macros/latex/required/amslatex/amscls.tds.zip">CTAN:install/macros/latex/required/amslatex/amscls.tds.zip</a><br />
+ <a href="http://mirror.ctan.org/install/macros/latex/required/amslatex/math.tds.zip">CTAN:install/macros/latex/required/amslatex/math.tds.zip</a><br />
+ <a href="http://mirror.ctan.org/macros/latex/contrib/amsrefs.zip">CTAN:macros/latex/contrib/amsrefs.zip</a><br />
+ <a href="http://mirror.ctan.org/macros/latex/required/amslatex.zip">CTAN:macros/latex/required/amslatex.zip</a><br />
+ <a href="ftp://ftp.ams.org/pub/tex/amsrefs/amsrefs.zip">ftp://ftp.ams.org/pub/tex/amsrefs/amsrefs.zip</a><br />
+ <a href="ftp://ftp.ams.org/pub/tex/amscls.zip">ftp://ftp.ams.org/pub/tex/amscls.zip</a><br />
+ <a href="ftp://ftp.ams.org/pub/tex/amsmath.zip">ftp://ftp.ams.org/pub/tex/amsmath.zip</a>
+</p>
+</dd>
+<dt class="hdlist1">
+<strong>amsfonts</strong>
+</dt>
+<dd>
+<p>
+ <a href="http://mirror.ctan.org/install/fonts/amsfonts.tds.zip">CTAN:install/fonts/amsfonts.tds.zip</a>
+</p>
+</dd>
+<dt class="hdlist1">
+<strong>psnfss</strong>
+</dt>
+<dd>
+<p>
+ <a href="http://mirror.ctan.org/macros/latex/required/psnfss.zip">CTAN:macros/latex/required/psnfss.zip</a>
+</p>
+</dd>
+<dt class="hdlist1">
+<strong>babel</strong>
+</dt>
+<dd>
+<p>
+ <a href="http://mirror.ctan.org/macros/latex/required/babel.zip">CTAN:macros/latex/required/babel.zip</a>
+</p>
+</dd>
+<dt class="hdlist1">
+<strong>tds</strong>
+</dt>
+<dd>
+<p>
+ <a href="http://mirror.ctan.org/tds.zip">CTAN:tds.zip</a>
+</p>
+</dd>
+<dt class="hdlist1">
+<strong>knuth</strong>
+</dt>
+<dd>
+<p>
+ <a href="http://mirror.ctan.org/systems/knuth/dist/errata.zip">CTAN:systems/knuth/dist/errata.zip</a><br />
+ <a href="http://mirror.ctan.org/systems/knuth/dist/etc.zip">CTAN:systems/knuth/dist/etc.zip</a><br />
+ <a href="http://mirror.ctan.org/systems/knuth/dist/mfware.zip">CTAN:systems/knuth/dist/mfware.zip</a><br />
+ <a href="http://mirror.ctan.org/systems/knuth/dist/texware.zip">CTAN:systems/knuth/dist/texware.zip</a><br />
+ <a href="http://mirror.ctan.org/systems/knuth/dist/web.zip">CTAN:systems/knuth/dist/web.zip</a><br />
+ <a href="http://mirror.ctan.org/systems/knuth/dist/tex.zip">CTAN:systems/knuth/dist/tex.zip</a><br />
+ <a href="http://mirror.ctan.org/systems/knuth/dist/mf.zip">CTAN:systems/knuth/dist/mf.zip</a>
+</p>
+</dd>
+<dt class="hdlist1">
+<strong>etex</strong>
+</dt>
+<dd>
+<p>
+ <a href="http://mirror.ctan.org/systems/e-tex/v2.1/etex_doc.zip">CTAN:systems/e-tex/v2.1/etex_doc.zip</a>
+</p>
+</dd>
+</dl></div>
+</div>
+<div class="sect2">
+<h3 id="_author">1.5. Author</h3>
+<div class="paragraph"><p>Heiko Oberdiek <heiko.oberdiek at googlemail.com></p></div>
+</div>
+<div class="sect2">
+<h3 id="_home">1.6. Home</h3>
+<div class="paragraph"><p>CTAN home with distribution files:</p></div>
+<div class="quoteblock">
+<div class="content">
+<div class="paragraph"><p><a href="http://mirror.ctan.org/macros/latex/contrib/latex-tds/">CTAN:macros/latex/contrib/latex-tds/</a></p></div>
+</div>
+<div class="attribution">
+</div></div>
+<div class="paragraph"><p>Source repository (without distribution files):</p></div>
+<div class="quoteblock">
+<div class="content">
+<div class="paragraph"><p><a href="https://github.com/oberdiek/latex-tds">https://github.com/oberdiek/latex-tds</a></p></div>
+</div>
+<div class="attribution">
+</div></div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_abbreviations_glossary">2. Abbreviations, Glossary</h2>
+<div class="sectionbody">
+<div class="dlist"><dl>
+<dt class="hdlist1">
+CTAN
+</dt>
+<dd>
+<p>
+ Comprehensive TeX Archive Network.<br />
+ FAQ entry: <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=archives">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=archives</a><br />
+ For example, you can resolve the prefix <tt>CTAN:</tt> by using
+ <tt>http://mirror.ctan.org/</tt>.
+</p>
+</dd>
+<dt class="hdlist1">
+latex-tds
+</dt>
+<dd>
+<p>
+ The name of this project.
+</p>
+</dd>
+<dt class="hdlist1">
+TDS
+</dt>
+<dd>
+<p>
+ TeX Directory Structure.<br />
+ FAQ entry: <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds</a><br />
+ Specification: <a href="http://www.ctan.org/pkg/tds">http://www.ctan.org/pkg/tds</a>
+</p>
+</dd>
+</dl></div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_download">3. Download</h2>
+<div class="sectionbody">
+<div class="paragraph"><p>The home of the project is located at:</p></div>
+<div class="quoteblock">
+<div class="content">
+<div class="paragraph"><p><a href="http://mirror.ctan.org//macros/latex/contrib/latex-tds/">CTAN:macros/latex/contrib/latex-tds/</a></p></div>
+</div>
+<div class="attribution">
+</div></div>
+<div class="paragraph"><p>The following files can be downloaded:</p></div>
+<div class="ulist"><ul>
+<li>
+<p>
+<tt>README</tt>, <tt>README.html</tt>, <tt>README.pdf</tt>:
+ The README file in different formats.
+</p>
+</li>
+<li>
+<p>
+<tt><module>.tds.zip</tt>: The module distribution files,
+ see section ‘<a href="#_module_list">Module list</a>’ above
+ for the available modules.
+</p>
+</li>
+<li>
+<p>
+<tt>source.tds.zip</tt>: The sources, mainly the build script, configuration and
+ driver files, and patches.
+ Some of the used tools are not provided, see section
+ ‘<a href="#_build_hints">Build Hints</a>’.
+</p>
+</li>
+<li>
+<p>
+<tt>latex-tds.tds.zip</tt>: The universe, the contents of all the ZIP files above,
+ merged together.
+</p>
+</li>
+</ul></div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_installation_hints">4. Installation Hints</h2>
+<div class="sectionbody">
+<div class="paragraph"><p>Hopefully the result of this project helps you in the installation
+process. You get a TDS compliant tree just by unpacking.</p></div>
+<div class="paragraph"><p>Example:</p></div>
+<div class="listingblock">
+<div class="content">
+<pre><tt> cd /some/where/texmf
+ unzip latex-tds</tt></pre>
+</div></div>
+<div class="paragraph"><p>or unzip’s option <tt>-d</tt>:</p></div>
+<div class="listingblock">
+<div class="content">
+<pre><tt> unzip latex-tds -d /some/where/texmf</tt></pre>
+</div></div>
+<div class="paragraph"><p>Instead of the universe ZIP file single modules can be selected.</p></div>
+<div class="paragraph"><p>Important to remember, point your unpack process right in
+the root directory of your TDS tree. The directory structure
+in the ZIP files start with the top-level directories:</p></div>
+<div class="listingblock">
+<div class="content">
+<pre><tt> doc/latex/base/...
+ tex/latex/tools/...
+ source/...</tt></pre>
+</div></div>
+<div class="paragraph"><p>Rationale: The root directory of a TDS tree can have different
+names, such as texmf-dist, texmf-local, …</p></div>
+<div class="sect2">
+<h3 id="_hints">4.1. Hints</h3>
+<div class="openblock">
+<div class="content">
+<div class="ulist"><ul>
+<li>
+<p>
+Refresh the file name database.
+</p>
+</li>
+<li>
+<p>
+Be aware that unpacking can insert and update files, but never
+ deletes obsolete ones. Remainders of previous releases can
+ cause trouble.
+</p>
+</li>
+<li>
+<p>
+Depending on the module further installation steps can be
+ necessary, consult the module’s own documentation.
+</p>
+</li>
+</ul></div>
+</div></div>
+<div class="sect3">
+<h4 id="_module_base">4.1.1. Module base</h4>
+<div class="ulist"><ul>
+<li>
+<p>
+The default <tt>texsys.cfg</tt> that LaTeX provides is put
+ into <tt>TDS:tex/latex/base</tt>. It must be removed, if you need
+ a specialized version. Consult your TeX distribution
+ and <tt>TDS:doc/latex/base/source2e.pdf</tt> (module ltdirchk).
+ Usually changes are not required for many TeX distributions
+ such as Unix (web2c), MikTeX, …
+</p>
+</li>
+<li>
+<p>
+Formats need rebuilding (e.g., fmtutil).
+</p>
+</li>
+</ul></div>
+</div>
+<div class="sect3">
+<h4 id="_module_babel">4.1.2. Module babel</h4>
+<div class="ulist"><ul>
+<li>
+<p>
+Most hyphenation patterns are not provided here. Usually you can
+ find them somewhere below <a href="http://mirror.ctan.org/language/hyphenation/">CTAN:language/hyphenation/</a>.
+</p>
+</li>
+<li>
+<p>
+Language configuration (<tt>language.dat</tt>), see the documentation of
+ your TeX distribution.
+</p>
+</li>
+<li>
+<p>
+Formats need rebuilding.
+</p>
+</li>
+</ul></div>
+</div>
+<div class="sect3">
+<h4 id="_module_psnfss">4.1.3. Module psnfss</h4>
+<div class="ulist"><ul>
+<li>
+<p>
+The map files need further configuring (e.g., updmap).
+</p>
+</li>
+</ul></div>
+</div>
+<div class="sect3">
+<h4 id="_module_graphics">4.1.4. Module graphics</h4>
+<div class="ulist"><ul>
+<li>
+<p>
+Module graphics does not provide all driver files, because some are
+ developed independently (<tt>pdftex.def</tt>, …).
+</p>
+</li>
+</ul></div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_copyright_license">5. Copyright, License</h2>
+<div class="sectionbody">
+<div class="paragraph"><p>Copyright © 2006-2013 Heiko Oberdiek.</p></div>
+<div class="paragraph"><p>License is LPPL 1.3c:</p></div>
+<div class="paragraph"><p>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 (at your option) any later version.
+The latest version of this license is in
+ <a href="http://www.latex-project.org/lppl.txt">http://www.latex-project.org/lppl.txt</a>
+and version 1.3c or later is part of all distributions of LaTeX
+version 2005/12/01 or later.</p></div>
+<div class="paragraph"><p>This work has the LPPL maintenance status ‘maintained’.</p></div>
+<div class="paragraph"><p>The Current Maintainer of this work is Heiko Oberdiek.</p></div>
+<div class="paragraph"><p>See the following section ‘<a href="#_manifest">Manifest</a>’ for a list of all files
+belonging to the project ‘latex-tds’.</p></div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_manifest">6. Manifest</h2>
+<div class="sectionbody">
+<div class="paragraph"><p>Included are the projects ‘adjust_checksum’ and ‘ziptimetree’.
+They are projects of their own.</p></div>
+<div class="sect2">
+<h3 id="_documentation">6.1. Documentation</h3>
+<div class="tableblock">
+<table rules="rows"
+width="100%"
+frame="hsides"
+cellspacing="0" cellpadding="4">
+<col width="30%" />
+<col width="70%" />
+<tbody>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>README </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">this file</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_licenses">6.2. Licenses</h3>
+<div class="tableblock">
+<table rules="rows"
+width="100%"
+frame="hsides"
+cellspacing="0" cellpadding="4">
+<col width="30%" />
+<col width="70%" />
+<tbody>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>license/lppl.txt </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">LPPL (The LaTeX Project Public License)
+ for latex-tds and adjust_checksum</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>license/ziptimetree/lgpl.txt </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">LGPL (GNU Lesser General Public License)
+ for ziptimetree</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_scripts">6.3. Scripts</h3>
+<div class="tableblock">
+<table rules="rows"
+width="100%"
+frame="hsides"
+cellspacing="0" cellpadding="4">
+<col width="30%" />
+<col width="70%" />
+<tbody>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>build.pl </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">main script for building the distribution</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>lib/adjust_checksum.pl </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">Perl script that runs a DTX file through
+ LaTeX and corrects its <tt>\Checksum</tt> if necessary</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>lib/ziptimetree.pl </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">Perl script that generates a ZIP file from
+ a directory tree with sorted entries (LGPL)</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_configuration">6.4. Configuration</h3>
+<div class="tableblock">
+<table rules="rows"
+width="100%"
+frame="hsides"
+cellspacing="0" cellpadding="4">
+<col width="30%" />
+<col width="70%" />
+<tbody>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>tex/docstrip.cfg </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">enables TDS feature and creates directories</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>tex/errata.cfg </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">for errata lists of latex/base</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>tex/hyperref.cfg </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">hyperref configuration file</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>tex/ltnews.cfg </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">for LaTeX News of latex/base</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>tex/ltxdoc.cfg </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">setup for class ltxdoc</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>tex/ltxguide.cfg </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">setup for the guide manuals in latex/base
+ and required/psnfss</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>tex/ltugboat.cls </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">setup for class ltugboat</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>tex/lualatex-tds.ini </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">init file for format generation for LuaTeX</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>tex/lualatex-tds2.ini </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">init file for LuaTeX format without LM Math</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>tex/manual.cfg </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">setup for errata list of the LaTeX manual
+ in latex/base</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>tex/pdflatex-tds.ini </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">init file for format generation for pdfTeX</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>tex/tdsguide.cfg </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">setup for class <tt>tdsguide.cls</tt></p></td>
+</tr>
+</tbody>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_documentation_driver">6.5. Documentation driver</h3>
+<div class="tableblock">
+<table rules="rows"
+width="100%"
+frame="hsides"
+cellspacing="0" cellpadding="4">
+<col width="30%" />
+<col width="70%" />
+<tbody>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>tex/ams.drv </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">generic doc driver for files from the
+ amslatex and babel bundle</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>tex/babel.tex </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">doc driver with patches for <tt>babel.drv</tt></p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>tex/doc_lppl.tex </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">doc driver for <tt>base/lppl.tex</tt></p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>tex/errata.all </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">doc driver for <tt>knuth/errata/errata.pdf</tt></p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>tex/errata.drv </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">doc driver for <tt>knuth/errata/errata_*.pdf</tt></p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>tex/errorlog.drv </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">doc driver for <tt>knuth/errata/errorlog.tex</tt></p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>tex/etex_man.drv </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">doc driver for <tt>etex/etex_man.tex</tt></p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>tex/greek-usage.tex </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">doc driver with patches for <tt>babel/usage.tex</tt></p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>tex/knuth.drv </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">doc driver for <tt>knuth/</tt>{<tt>texware</tt>,<tt>mfware</tt>,<tt>etc</tt>}+/*.web+</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>tex/ltnews.tex </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">master file that merges all <tt>base/ltnews*.tex</tt></p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>tex/ltxcheck.drv </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">doc driver with patches for <tt>ltxcheck.tex</tt></p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>tex/psnfss2e.drv </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">doc driver with patches for <tt>psnfss2e.tex</tt></p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>tex/tools-overview.cls </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">class for <tt>tools.tex</tt></p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>tex/tools.tex </tt></pre></div></td>
+<td align="left" valign="top"><p class="table">master file for tools overview, generated
+ by the <tt>build.pl</tt> script from <tt>tools/manifest.txt</tt></p></td>
+</tr>
+</tbody>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_patches">6.6. Patches</h3>
+<div class="tableblock">
+<table rules="rows"
+width="100%"
+frame="hsides"
+cellspacing="0" cellpadding="4">
+<col width="30%" />
+<col width="70%" />
+<thead>
+<tr>
+<th align="left" valign="top">Diff/patch file</th>
+<th align="left" valign="top">Patched file</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>patch/amsclass.dtx.diff </tt></pre></div></td>
+<td align="left" valign="top"><div class="literal"><pre><tt>amslatex/amsclass.dtx</tt></pre></div></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>patch/amsfndoc.def.diff </tt></pre></div></td>
+<td align="left" valign="top"><div class="literal"><pre><tt>amsfonts/amsfndoc.def</tt></pre></div></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>patch/amsfndoc.tex.diff </tt></pre></div></td>
+<td align="left" valign="top"><div class="literal"><pre><tt>amsfonts/amsfndoc.tex</tt></pre></div></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>patch/amsldoc.tex.diff </tt></pre></div></td>
+<td align="left" valign="top"><div class="literal"><pre><tt>amslatex/amsldoc.tex</tt></pre></div></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>patch/changes.tex.diff </tt></pre></div></td>
+<td align="left" valign="top"><div class="literal"><pre><tt>amslatex/amsrefs/changes.tex</tt></pre></div></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>patch/encguide.tex.diff </tt></pre></div></td>
+<td align="left" valign="top"><div class="literal"><pre><tt>base/encguide.tex</tt></pre></div></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>patch/hebrew.fdd.diff </tt></pre></div></td>
+<td align="left" valign="top"><div class="literal"><pre><tt>babel/hebrew.fdd</tt></pre></div></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>patch/logmac.tex.diff </tt></pre></div></td>
+<td align="left" valign="top"><div class="literal"><pre><tt>knuth/errata/logmac.tex</tt></pre></div></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>patch/source2e.tex.diff </tt></pre></div></td>
+<td align="left" valign="top"><div class="literal"><pre><tt>base/source2e.tex</tt></pre></div></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>patch/tlc2.err.diff </tt></pre></div></td>
+<td align="left" valign="top"><div class="literal"><pre><tt>base/tlc2.err</tt></pre></div></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>patch/tripman.tex.diff </tt></pre></div></td>
+<td align="left" valign="top"><div class="literal"><pre><tt>knuth/tex/tripman.tex</tt></pre></div></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>patch/trapman.tex.diff </tt></pre></div></td>
+<td align="left" valign="top"><div class="literal"><pre><tt>knuth/mf/trapman.tex</tt></pre></div></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>patch/utf8ienc.dtx.diff </tt></pre></div></td>
+<td align="left" valign="top"><div class="literal"><pre><tt>base/utf8ienc.dtx</tt></pre></div></td>
+</tr>
+<tr>
+<td align="left" valign="top"><div class="literal"><pre><tt>patch/webman.tex.diff </tt></pre></div></td>
+<td align="left" valign="top"><div class="literal"><pre><tt>knuth/web/webman.tex</tt></pre></div></td>
+</tr>
+</tbody>
+</table>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_design_principles">7. Design Principles</h2>
+<div class="sectionbody">
+<div class="ulist"><ul>
+<li>
+<p>
+Compliance with the latest TDS specification.
+</p>
+</li>
+<li>
+<p>
+No redundancy.
+</p>
+</li>
+<li>
+<p>
+User friendly PDF files with navigational support:
+</p>
+<div class="ulist"><ul>
+<li>
+<p>
+bookmarks
+</p>
+</li>
+<li>
+<p>
+links
+</p>
+</li>
+</ul></div>
+</li>
+<li>
+<p>
+Complete documentation. The documentation generation with
+ enhanced PDF files is the tricky part and should be saved
+ from the user.
+</p>
+</li>
+<li>
+<p>
+Output format of generated documentation is PDF, see above.
+ Other formats such as DVI or PS are not generated and provided.
+</p>
+</li>
+<li>
+<p>
+Documentation bundles are preferred to many partial documentation
+ files (e.g. <tt>source2e.pdf</tt> or <tt>ltnews.pdf</tt>).
+</p>
+</li>
+<li>
+<p>
+If several expansion stages of a documentation are available,
+ then just the most complete expansion stage should be used.
+</p>
+</li>
+<li>
+<p>
+Files that do not fit in a program sub tree of TDS stay below
+ <tt>TDS:source</tt> (e.g. <tt>latexbug.el</tt> from latex/base). Then they do not
+ get lost at least.
+</p>
+</li>
+<li>
+<p>
+Page layout: <tt>a4paper</tt> with reduced vertical margins (exception: ltnews).
+ (This also decreases the page number usually.)
+</p>
+</li>
+<li>
+<p>
+…
+</p>
+</li>
+</ul></div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_remarks">8. Remarks</h2>
+<div class="sectionbody">
+<div class="sect2">
+<h3 id="_base">8.1. Base</h3>
+<div class="ulist"><ul>
+<li>
+<p>
+<tt>source2e.pdf</tt> is used instead of many single <tt>lt*.pdf</tt> files.
+</p>
+</li>
+<li>
+<p>
+<tt>ltnews.pdf</tt> is introduced to avoid cluttering the doc directory
+ with many single sheet <tt>ltnews*.pdf</tt> files.
+</p>
+</li>
+<li>
+<p>
+Patch for <tt>ltfssdcl.dtx</tt>: Checksum fixed.
+</p>
+</li>
+<li>
+<p>
+…
+</p>
+</li>
+</ul></div>
+</div>
+<div class="sect2">
+<h3 id="_tools">8.2. Tools</h3>
+<div class="ulist"><ul>
+<li>
+<p>
+Added: <tt>tools.pdf</tt> as overview/contents/index file with links
+ and short descriptions of the single packages. (It uses
+ the data from <tt>manifest.txt</tt>).
+</p>
+</li>
+<li>
+<p>
+…
+</p>
+</li>
+</ul></div>
+</div>
+<div class="sect2">
+<h3 id="_babel">8.3. Babel</h3>
+<div class="ulist"><ul>
+<li>
+<p>
+Babel’s TeX files consists of three groups of files:
+</p>
+<div class="olist arabic"><ol class="arabic">
+<li>
+<p>
+Hyphenation pattern, see below.
+</p>
+</li>
+<li>
+<p>
+Generic files:
+</p>
+<div class="ulist"><ul>
+<li>
+<p>
+<tt>*.ldf</tt> (language definition files)
+</p>
+</li>
+<li>
+<p>
+<tt>*.sty</tt> (from <tt>bbcompat.dtx</tt>, these are plain TeX files,
+ LaTeX user have the package babel)
+</p>
+</li>
+<li>
+<p>
+<tt>babel.def</tt>, <tt>switch.def</tt>
+</p>
+</li>
+<li>
+<p>
+<tt>plain.def</tt>
+</p>
+</li>
+<li>
+<p>
+<tt>b*plain.tex</tt>
+</p>
+</li>
+<li>
+<p>
+<tt>esbst.tex</tt>
+</p>
+</li>
+</ul></div>
+</li>
+<li>
+<p>
+LaTeX files:
+</p>
+<div class="ulist"><ul>
+<li>
+<p>
+<tt>*.fd</tt>
+</p>
+</li>
+<li>
+<p>
+<tt>*enc.def</tt> (for package fontenc)
+</p>
+</li>
+<li>
+<p>
+<tt>cp*.def</tt>, <tt>8859-8.def</tt>, <tt>si960.def</tt> (for package inputenc)
+</p>
+</li>
+<li>
+<p>
+<tt>babel.sty</tt>
+</p>
+</li>
+<li>
+<p>
+<tt>romanidx.tex</tt>
+</p>
+</li>
+<li>
+<p>
+<tt>athnum.sty</tt>, <tt>grmath.sty</tt>, <tt>grsymb.sty</tt> (<tt>greek.ins</tt>)
+</p>
+</li>
+<li>
+<p>
+<tt>heb*.sty</tt>
+</p>
+</li>
+</ul></div>
+<div class="paragraph"><p>Full TDS compliance would use different format subtrees
+ for the generic and LaTeX files. However practice (TeX Live, teTeX,
+ VTeX, …) put them in <tt>generic</tt>, mainly because of maintenance issues.
+ Also babel’s <tt>*.ins</tt> files specify <tt>\usedir{tex/generic/babel}</tt>.
+ There can be problems, if different TDS trees have different
+ babel versions installed and the same file can be found both
+ in generic and latex. The natural search strategy for TDS compliant
+ trees would be to look first in <tt>tex/latex</tt> across the trees, then
+ in tex/generic. Thus it can happen to use files from the same
+ package, but different versions.
+ Therefore latex-tds put these files in the <tt>generic</tt> subtree.</p></div>
+</li>
+</ol></div>
+</li>
+</ul></div>
+<div class="openblock">
+<div class="content">
+<div class="ulist"><ul>
+<li>
+<p>
+Babel already contains <tt>babel.pdf</tt> as documentation. It is a superset
+ of <tt>user.pdf</tt>. Thus I have dropped the latter one to avoid redundancy.
+ Also the name <tt>babel.pdf</tt> is much more useful (texdoc).
+</p>
+</li>
+<li>
+<p>
+…
+</p>
+</li>
+</ul></div>
+</div></div>
+</div>
+<div class="sect2">
+<h3 id="_knuth">8.4. Knuth</h3>
+<div class="ulist"><ul>
+<li>
+<p>
+Current CTAN → TDS mapping in use:
+ <tt>CTAN:systems/knuth/dist</tt> → <tt>TDS:<toplevel>/knuth</tt>
+</p>
+</li>
+<li>
+<p>
+Unsure where to put trip/trap files. Currently they are
+ put in <tt>TDS:source</tt>, because the documentation files
+ (<tt>tripman.pdf</tt>, <tt>trapman.pdf</tt>) are in <tt>TDS:doc</tt>. They lists the
+ trip/trap files already.
+</p>
+</li>
+<li>
+<p>
+Not covered is
+ <a href="http://mirror.ctan.org/systems/knuth/dist/lib/">CTAN:systems/knuth/dist/lib/</a>
+ In TeX Live 2007/2008 the files are installed at different
+ locations:
+</p>
+<div class="literalblock">
+<div class="content">
+<pre><tt>texmf-dist/fonts/source/public/mflogo/logo10.mf
+texmf-dist/fonts/source/public/mflogo/logo8.mf
+texmf-dist/fonts/source/public/mflogo/logo9.mf
+texmf-dist/fonts/source/public/mflogo/logobf10.mf
+texmf-dist/fonts/source/public/mflogo/logo.mf
+texmf-dist/fonts/source/public/mflogo/logosl10.mf
+texmf-dist/fonts/source/public/misc/grayf.mf
+texmf-dist/fonts/source/public/misc/manfnt.mf
+texmf-dist/fonts/source/public/misc/slant.mf
+texmf-dist/metafont/base/expr.mf
+texmf-dist/metafont/base/io.mf
+texmf-dist/metafont/base/null.mf
+texmf-dist/metafont/base/plain.mf
+texmf-dist/metafont/misc/3test.mf
+texmf-dist/metafont/misc/6test.mf
+texmf-dist/metafont/misc/rtest.mf
+texmf-dist/metafont/misc/test.mf
+texmf-dist/metafont/misc/waits.mf
+texmf-dist/metafont/misc/ztest.mf
+texmf-dist/mft/base/cmbase.mft
+texmf-dist/mft/base/plain.mft
+texmf-dist/tex/generic/misc/null.tex
+texmf-dist/tex/plain/base/manmac.tex
+texmf-dist/tex/plain/base/mftmac.tex
+texmf-dist/tex/plain/base/plain.tex
+texmf-dist/tex/plain/base/story.tex
+texmf-dist/tex/plain/base/testfont.tex
+texmf-dist/tex/plain/base/webmac.tex
+texmf/tex/generic/hyphen/hyphen.tex</tt></pre>
+</div></div>
+</li>
+</ul></div>
+</div>
+<div class="sect2">
+<h3 id="_e_tex">8.5. e-TeX</h3>
+<div class="ulist"><ul>
+<li>
+<p>
+Only the manual ‘etex_man’ is covered by this module.
+</p>
+</li>
+</ul></div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_build_hints">9. Build Hints</h2>
+<div class="sectionbody">
+<div class="paragraph"><p>The most important advice I can give: ‘Forget it’!
+The purpose of the source files are rather to show, what was
+done in which way.
+The <tt>*.zip</tt> with TDS trees are the goal of the project, not the
+build process. Some remarks, if someone wants to build the
+modules himself:</p></div>
+<div class="ulist"><ul>
+<li>
+<p>
+TeX compiler: LuaTeX and pdfTeX (≥ 1.30).
+</p>
+</li>
+<li>
+<p>
+An up-to-date LaTeX installation, at least TeX Live 2012.
+</p>
+</li>
+<li>
+<p>
+Additional packages can be necessary, e.g.
+ <a href="http://mirror.ctan.org/language/armenian/armtex.zip">CTAN:language/armenian/armtex.zip</a>
+ is not part of TeX Live 2012.
+</p>
+</li>
+<li>
+<p>
+Most of the PDF files are generated using lualatex and package
+ ‘fontspec’ that uses the Latin Modern fonts as default. They
+ are available as OpenType fonts. LuaTeX generates with OpenType
+ fonts considerably smaller PDF files. Also PDF object stream
+ compression is used (PDF 1.5). Therefore the further
+ post-processing of PDF files are currently dropped.
+</p>
+</li>
+<li>
+<p>
+(Outdated since 2011-07-01) PDF post-processing, I have used two steps:
+</p>
+<div class="openblock">
+<div class="content">
+<div class="olist arabic"><ol class="arabic">
+<li>
+<p>
+First step:
+</p>
+<div class="olist loweralpha"><ol class="loweralpha">
+<li>
+<p>
+I have written a tool that analyzes page stream contents and
+ optimizes them (removal of unnecessary color settings, minimize
+ translation operations, …)
+ → <tt>pdfbox-rewrite.jar</tt>.
+</p>
+</li>
+<li>
+<p>
+For reading and writing the PDF file I have used PDFBox
+ → <tt>PDFBox-0.7.2.jar</tt> (<a href="http://pdfbox.apache.org/">http://pdfbox.apache.org/</a>).
+</p>
+</li>
+<li>
+<p>
+To get better results I patched some of the classes
+ of PDFBox (especially the write module)
+ → <tt>pdfbox-rewrite.jar</tt>.
+</p>
+</li>
+</ol></div>
+</li>
+<li>
+<p>
+The final conversion step was done by Multivalent, because
+ it makes a very good job in PDF compression:
+ → <tt>Multivalent20060102.jar</tt> (<a href="http://multivalent.sourceforge.net/">http://multivalent.sourceforge.net/</a>)
+</p>
+</li>
+</ol></div>
+<div class="paragraph"><p>Multivalent and PDFBox are available, <tt>pdfbox-rewrite.jar</tt>, however,
+ is just a first prototype, not ripe for a release.
+ Therefore this step of post-processing is optional for the
+ project latex-tds. The build script looks for the library and
+ skips this steps automatically if necessary.
+ If you give the build script the option <tt>--nopostprocess</tt>,
+ then it will skip the postprocess steps (building is faster,
+ the pdf files a little larger).
+ Install the jar files in the directory <tt>lib</tt> where
+ they are expected by the build script.</p></div>
+</div></div>
+</li>
+<li>
+<p>
+Unix, Perl background is expected.
+</p>
+</li>
+<li>
+<p>
+No support or documentation.
+</p>
+</li>
+</ul></div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_history">10. History</h2>
+<div class="sectionbody">
+<div class="dlist"><dl>
+<dt class="hdlist1">
+2006/04/27
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Start of the project (without babel, amslatex, psnfss).
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2006/06/01
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Module amslatex added.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2006/06/03
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Modules psnfss and babel added, now all modules are covered.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2006/06/07
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+The project uploaded to CTAN.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2006/07/31
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Index added to base/classes.dtx.
+</p>
+</li>
+<li>
+<p>
+ZIP files renamed: <tt>*-tds.zip</tt> → <tt>*.zip</tt>
+</p>
+</li>
+<li>
+<p>
+Comment added to ZIP files.
+</p>
+</li>
+<li>
+<p>
+Update of <tt>readme.txt</tt>.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2006/08/26
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Module tds for <a href="http://mirror.ctan.org/tds/">CTAN:tds/</a> added.
+</p>
+</li>
+<li>
+<p>
+Obsolete hyphenation patterns added to babel’s source directory
+ to avoid violation of LPPL.
+</p>
+</li>
+<li>
+<p>
+Script adjust_checksum added and scripts are put below <tt>TDS:scripts</tt>.
+</p>
+</li>
+<li>
+<p>
+<tt>TDS:makeindex/base/</tt> renamed to <tt>TDS:makeindex/latex/</tt>
+</p>
+</li>
+<li>
+<p>
+Exception for <tt>sample2e.tex</tt> and <tt>small2e.tex</tt> that now go into
+ <tt>TDS:tex/latex/base/</tt>.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2006/08/28
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Default <tt>texsys.cfg</tt> is generated.
+</p>
+</li>
+<li>
+<p>
+<tt>adjust_checksum.pl</tt> and <tt>ziptimetree.pl</tt> now moved from the <tt>scripts</tt>
+ branch to <tt>TDS:source/latex/latex-tds/lib/</tt>.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2006/12/27
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Fix of <tt>ltxguide.cfg</tt> that had loaded doc.sty that disturbs the
+ verbatim stuff in <tt>fntguide.tex</tt>.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2007/01/08
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Fix for documentation of longtable.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2007/03/19
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Patch for <tt>babel/latin.dtx</tt> added (babel/3922).
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2007/09/04
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+A minor update on CTAN regarding babel:
+ <tt>iahyphen.tex</tt>, <tt>icehyph.tex</tt>, and <tt>lahyph.tex</tt> are now symbolic links
+ to their location in <a href="http://mirror.ctan.org/language/hyphenation/">CTAN:language/hyphenation/</a>.
+ Therefore also
+ <tt>lahyph.tex</tt> is now installed in <tt>TDS:tex/generic/hyphen/</tt>.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2007/10/18
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Update of module amslatex because of updated package amsrefs.
+</p>
+</li>
+<li>
+<p>
+Fix in <tt>latin.dtx.diff</tt>.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2007/10/24
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Update of babel.
+</p>
+</li>
+<li>
+<p>
+Update of amsrefs (<tt>TDS:tex/latex/amscls</tt> → <tt>TDS:tex/latex/amsrefs</tt>).
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2008/04/01
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Update of babel (2008/03/17).
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2008/04/02
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Fix: <tt>latex/base/*.err</tt> added to <tt>TDS:source/latex/base/</tt>.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2008/04/05
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Using <tt>.tds.zip</tt> instead of .zip to follow <tt>CTAN:install</tt>'s naming
+ conventions.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2008/06/28
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Update of babel (2008/06/01).
+</p>
+</li>
+<li>
+<p>
+Babel documentation: table of contents reformatted.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2008/07/07
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Update of babel (2008/07/06).
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2008/07/10
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Module knuth added.
+</p>
+</li>
+<li>
+<p>
+Update of babel (2008/07/07).
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2008/07/11
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Fixes and additions for module knuth.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2008/07/25
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Module amslatex: <tt>instr-l.tex</tt> vanished from CTAN (but not at AMS side).
+</p>
+</li>
+<li>
+<p>
+Some unwanted spaces in generated PDF files fixed.
+ (Caused by a wrong package file that was found on my system first.)
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2008/08/10
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Module latex3 added.
+</p>
+</li>
+<li>
+<p>
+Module base: CTAN hyperlinks fixed.
+</p>
+</li>
+<li>
+<p>
+Module amslatex: Outdated URL fixed in <tt>amsldoc.tex</tt>.
+</p>
+</li>
+<li>
+<p>
+Module babel: Problem with already defined <tt>\meta</tt> in <tt>tb1604.tex</tt> fixed.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2008/09/06
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Module base:
+</p>
+<div class="ulist"><ul>
+<li>
+<p>
+Using uptodate versions from LaTeX project page for errata lists.
+</p>
+</li>
+<li>
+<p>
+<tt>lgc2.err</tt> added (LaTeX Graphics Companion, 2. ed.).
+</p>
+</li>
+<li>
+<p>
+Various fixes in errata lists.
+</p>
+</li>
+</ul></div>
+</li>
+<li>
+<p>
+Module tools: <tt>array.dtx</tt>: documentation fixed (tools/4044).
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2008/09/10
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Module base: Missing title date for utf8ienc.pdf fixed.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2009/09/05
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Module amslatex: updated.
+</p>
+</li>
+<li>
+<p>
+Module latex3: xpackages updated.
+</p>
+</li>
+<li>
+<p>
+Module latex3: expl3 removed, because nothing to do.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2009/09/25
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Module amslatex: updated.
+</p>
+</li>
+<li>
+<p>
+Module babel: updated.
+</p>
+</li>
+<li>
+<p>
+Update of LaTeX, release 2009/09/24.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2009/12/07
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Module amslatex: Unhappily the <tt>.zip</tt> files are quite a mess,
+ because they contain a mixup of old and new versions.
+ Tried to sort this out and fix the last update.
+</p>
+</li>
+<li>
+<p>
+Module latex3: xpackages removed, because nothing to do.
+</p>
+</li>
+<li>
+<p>
+Module latex3 removed, nothing left to do.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2010/05/04
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Module base: page layout for source2e fixed (changes, index).
+</p>
+</li>
+<li>
+<p>
+Module base: update of <tt>.err</tt> files.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2010/10/27
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Module amslatex: amscls and amsrefs updated.
+</p>
+</li>
+<li>
+<p>
+Module etex added (only for etex_man).
+</p>
+</li>
+<li>
+<p>
+Erratas updated.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2011/03/10
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Module base: patch for latex/4148 (Missing <tt>\label</tt> and <tt>\ref</tt> in <tt>lppl.tex</tt>).
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2011/04/18
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Module amslatex: There is an outdated version of amsthm.sty in
+ <a href="http://mirror.ctan.org/install/macros/latex/required/amslatex/amscls.tds.zip">CTAN:install/macros/latex/required/amslatex/amscls.tds.zip</a>.
+ The package <tt>amsthm.sty</tt> is now generated from the source.
+</p>
+</li>
+<li>
+<p>
+Using TDS tree for missing packages that are not part of TeX Live.
+ Module base: <a href="http://mirror.ctan.org/language/armenian/armtex.zip">CTAN:language/armenian/armtex.zip</a>.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2011/06/24
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Module amslatex: Two downloads from AMS server removed, because
+ the files are not longer available (and they are on CTAN).
+</p>
+</li>
+<li>
+<p>
+Module amslatex: 00readme.txt and amsrefs.dtx taken from
+ <a href="http://mirror.ctan.org/macros/latex/contrib/amsrefs.zip">CTAN:macros/latex/contrib/amsrefs.zip</a> instead of
+ <a href="http://mirror.ctan.org/install/macros/latex/contrib/amsrefs.tds.zip">CTAN:install/macros/latex/contrib/amsrefs.tds.zip</a>
+ because the later archive file is out of sync.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2011/06/30
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Module base:
+</p>
+<div class="ulist"><ul>
+<li>
+<p>
+Update of LaTeX, release 2011/06/27.
+</p>
+</li>
+<li>
+<p>
+Patch <tt>ltpatch.ltx</tt> to match the kernel version.
+</p>
+</li>
+<li>
+<p>
+Patch <tt>lppl.tex.diff</tt> removed (no longer needed).
+</p>
+</li>
+<li>
+<p>
+Patch <tt>ltfssdcl.dtx.diff</tt> added (checksum fixed).
+</p>
+</li>
+</ul></div>
+</li>
+<li>
+<p>
+Module tools: Release 2011/06.
+</p>
+</li>
+<li>
+<p>
+Module babel: Release 2011/06.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2011/07/01
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+PDF generation:
+</p>
+<div class="ulist"><ul>
+<li>
+<p>
+Use of LuaTeX instead of pdfTeX for most of the files.
+</p>
+</li>
+<li>
+<p>
+Use of package ‘fontspec’ with Latin Modern fonts as
+ default in OpenType format (smaller PDF file sizes).
+ The post-processing of PDF files is skipped.
+</p>
+</li>
+<li>
+<p>
+Various patches and fixes for LuaLaTeX and package ‘fontspec’.
+</p>
+</li>
+</ul></div>
+</li>
+<li>
+<p>
+Module base:
+</p>
+<div class="ulist"><ul>
+<li>
+<p>
+Update of LaTeX.
+</p>
+</li>
+<li>
+<p>
+Patches <tt>ltpatch.ltx.diff</tt> and <tt>ltfssdcl.dtx.diff</tt> removed
+ (no longer needed).
+</p>
+</li>
+</ul></div>
+</li>
+<li>
+<p>
+Module tools: Update.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2011/07/03
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+build.pl:
+</p>
+<div class="ulist"><ul>
+<li>
+<p>
+Caching for PDF generation added.
+</p>
+</li>
+<li>
+<p>
+‘FINAL’ markers in the output of <tt>build.pl</tt>
+ for final (Lua|pdf)TeX runs.
+</p>
+</li>
+</ul></div>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2011/07/26
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+PDF generation: Use of package unicode-math with Latin Modern Math
+ where possible.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2011/08/10
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Update of tools.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2011/10/05
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Update of tools (varioref).
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2011/11/16
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Update of babel.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2012/05/12
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Update of amslatex (amsrefs).
+</p>
+</li>
+<li>
+<p>
+Update of <tt>readme.txt</tt> that is renamed to <tt>README</tt> (CTAN convention).
+</p>
+</li>
+<li>
+<p>
+Update of <tt>tlc2.err</tt>.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2013/02/14
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Update of amslatex (amsrefs).
+</p>
+</li>
+<li>
+<p>
+Module amslatex: <tt>cite-x*.tex</tt>, <tt>jb.bib</tt> in <tt>TDS:source/</tt>, because
+ these files are now classified as test files.
+</p>
+</li>
+<li>
+<p>
+Module base: <tt>lb2.err</tt> and <tt>tlc2.err</tt> updated.
+</p>
+</li>
+<li>
+<p>
+Change in version control system from CVS to git with public
+ source repository.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2013/02/15
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Module amsfonts added.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2013/02/25
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+Patch file <tt>lb2.err.diff</tt> removed by call of sed inside <tt>build.pl</tt>.
+</p>
+</li>
+<li>
+<p>
+<tt>README</tt> rewritten in text document format <a href="http://www.methods.co.nz/asciidoc/">AsciiDoc</a>
+ and added as HTML and PDF files.
+</p>
+</li>
+<li>
+<p>
+<tt>README.asciidoc</tt> updated.
+</p>
+</li>
+<li>
+<p>
+<tt>Makefile</tt>: Target ‘check-links’ added.
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+2013/02/26
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+<tt>README</tt> generated from <tt>README.asciidoc</tt> via <tt>README.html</tt>.
+</p>
+</li>
+</ul></div>
+</dd>
+</dl></div>
+</div>
+</div>
+</div>
+<div id="footnotes"><hr /></div>
+<div id="footer">
+<div id="footer-text">
+Last updated 2013-02-26 04:22:43 CET
+</div>
+</div>
+</body>
+</html>
diff --git a/Master/texmf-dist/doc/latex/latex-tds/README.pdf b/Master/texmf-dist/doc/latex/latex-tds/README.pdf Binary files differnew file mode 100644 index 00000000000..2fc764f898d --- /dev/null +++ b/Master/texmf-dist/doc/latex/latex-tds/README.pdf diff --git a/Master/texmf-dist/source/latex/latex-tds/README b/Master/texmf-dist/source/latex/latex-tds/README deleted file mode 100644 index 5dc9d59f03b..00000000000 --- a/Master/texmf-dist/source/latex/latex-tds/README +++ /dev/null @@ -1,617 +0,0 @@ -README for project latex-tds, 2013/02/15 - -TABLE OF CONTENTS -================= -A. Abbreviations, Glossary -B. Project latex-tds -C. Download -D. Installation Hints -E. Copyright, License -F. Manifest -G. Design Principles -H. Remarks -I. Build Hints -J. History - - -A. ABBREVIATIONS, GLOSSARY -========================== -[CTAN] - Comprehensive TeX Archive Network. - FAQ entry: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=archives - For example, you can resolve the prefix `CTAN:' by using - `ftp://ftp.ctan.org/tex-archive/'. -[latex-tds] - The name of this project. -[TDS] - TeX Directory Structure. - FAQ entry: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds - Specification: CTAN:tds.zip - - -B. PROJECT LATEX-TDS -==================== - -How it has started ------------------- -The project started as I wanted to install the new LaTeX release 2005/12/01 -that was announced at 2006/04/27. However the files aren't packed in -TDS format, ready for unpacking in the destination directory. And -the documentation files were not yet generated or the provided -PDF files are lacking of basic features such as bookmarks or link support. -Thus this project has started. I thought it could be finished during -the afternoon at the day of the announcement ... - -Goals of the project --------------------- -* From the sources a TDS compliant tree is constructed and populated. - The zipped result is distributed. -* All the documentation is generated from the sources. The PDF files - are user friendly and provide navigational support with bookmarks - and links. -* The PDF files are post-processed to reduce the file size. - -Scope ------ -I don't have the time to assemble a TeX distribution with -thousands of packages. Therefore I restricted myself to the -LaTeX base distribution and the required bundles. -In the following I will use the term `module' for a package bundle. - -Module list ------------ -* base CTAN:macros/latex/base.zip - CTAN:macros/latex/doc.zip - http://www.latex-project.org/guides/lb2.err - http://www.latex-project.org/guides/lgc2.err - http://www.latex-project.org/guides/manual.err - http://www.latex-project.org/guides/tlc2.err -* tools CTAN:macros/latex/required/tools.zip -* cyrillic CTAN:macros/latex/required/cyrillic.zip -* amslatex CTAN:install/macros/latex/required/amscls.tds.zip - CTAN:macros/latex/contrib/amsrefs.zip - CTAN:macros/latex/required/amslatex.zip - ftp://ftp.ams.org/pub/tex/amslatex.zip - ftp://ftp.ams.org/pub/tex/amsrefs/amsrefs.zip - ftp://ftp.ams.org/pub/tex/amscls.zip - ftp://ftp.ams.org/pub/tex/amsmath.zip -* amsfonts CTAN:install/fonts/amsfonts.tds.zip -* psnfss CTAN:macros/latex/required/psnfss.zip -* babel CTAN:macros/latex/required/babel.zip -* tds CTAN:tds.zip -* knuth CTAN:systems/knuth/dist/errata.zip - CTAN:systems/knuth/dist/etc.zip - CTAN:systems/knuth/dist/mfware.zip - CTAN:systems/knuth/dist/texware.zip - CTAN:systems/knuth/dist/web.zip - CTAN:systems/knuth/dist/tex.zip - CTAN:systems/knuth/dist/mf.zip -* etex CTAN:systems/e-tex/v2.1/etex_doc.zip - -Author ------- -Heiko Oberdiek <heiko.oberdiek at googlemail.com> - -Home ----- -CTAN home with distribution files: - CTAN:macros/latex/contrib/latex-tds/ - -Source repository: - https://github.com/oberdiek/latex-tds - - -C. DOWNLOAD -=========== - -The home of the project is located at: - CTAN:macros/latex/contrib/latex-tds/ - -The following files can be downloaded: -* README (this file) -* The module distribution files, see the module list above - for the available modules, e.g: - base.tds.zip - tools.tds.zip - ... -* The sources, mainly the build script, configuration and - driver files, and patches: - source.tds.zip - Some of the used tools are not provided, see section - `Building Hints'. -* And the universe, the contents of all the ZIP files above, - merged together: - latex-tds.tds.zip - - -C. INSTALLATION HINTS -===================== - -Hopefully the result of this project helps you in the installation -process. You get a TDS compliant tree just by unpacking. - -Example: - cd /some/where/texmf - unzip latex-tds -or unzip's option `-d': - unzip latex-tds -d /some/where/texmf - -Instead of the universe ZIP files single modules can be selected. - -Important to remember, point your unpack process right in -the root directory of your TDS tree. The directory structure -in the ZIP files start with the top-level directories: - doc/latex/base/... - tex/latex/tools/... - source/... -Rationale: The root directory of a TDS tree can have different -names, such as texmf-dist, texmf-local, ... - -Hints ------ -* Refresh the file name database. -* Be aware that unpacking can insert and update files, but never - deletes obsolete ones. Remainders of previous releases can - cause trouble. -* Depending on the module further installation steps can be - necessary, consult the module's own documentation. - -[base] - * The default texsys.cfg that LaTeX provides is put - into tex/latex/base. It must be removed, if you need - a specialized version. Consult your TeX distribution - and doc/latex/base/source2e.pdf (module ltdirchk). - Usually changes are not required for many TeX distributions - such as Unix (web2c), MikTeX, ... - * Formats need rebuilding (e.g., fmtutil). -[babel] - * Most hyphenation patterns aren't provided here. Usually you can - find them somewhere below CTAN:language/hyphenation. - * Language configuration (language.dat), see the documentation of - your TeX distribution. - * Formats need rebuilding. -[psnfss] - * The map files need further configuring (e.g., updmap). -[graphics] - * Module graphics doesn't provide all driver files, because some are - developed independently (pdftex.def, ...). - - -D. COPYRIGHT, LICENSE -===================== - -Copyright 2006-2011 Heiko Oberdiek. - -License is LPPL 1.3c: - -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 (at your option) any later version. -The latest version of this license is in - http://www.latex-project.org/lppl.txt -and version 1.3c or later is part of all distributions of LaTeX -version 2005/12/01 or later. - -This work has the LPPL maintenance status `maintained'. - -The Current Maintainer of this work is Heiko Oberdiek. - -See the following section `Manifest' for a list of all files -belonging to the project `latex-tds'. - - -E. MANIFEST -=========== - -Included are the projects `adjust_checksum' and `ziptimetree'. -They are projects of their own. - -Documentation -------------- - README this file - -Licenses --------- - license/lppl.txt LPPL (The LaTeX Project Public License) - for latex-tds and adjust_checksum - license/ziptimetree/lgpl.txt LGPL (GNU Lesser General Public License) - for ziptimetree - -Scripts -------- - build.pl main script for building the distribution - lib/adjust_checksum.pl Perl script that runs a DTX file through - LaTeX and corrects its \Checksum if necessary - lib/ziptimetree.pl Perl script that generates a ZIP file from - a directory tree with sorted entries (LGPL) - -Configuration -------------- - tex/docstrip.cfg enables TDS feature and creates directories - tex/errata.cfg for errata lists of latex/base - tex/hyperref.cfg hyperref configuration file - tex/ltnews.cfg for LaTeX News of latex/base - tex/ltxdoc.cfg setup for class ltxdoc - tex/ltxguide.cfg setup for the guide manuals in latex/base - and required/psnfss - tex/ltugboat.cls setup for class ltugboat - tex/lualatex-tds.ini init file for format generation for LuaTeX - tex/lualatex-tds2.ini init file for LuaTeX format without LM Math - tex/manual.cfg setup for errata list of the LaTeX manual - in latex/base - tex/pdflatex-tds.ini init file for format generation for pdfTeX - tex/tdsguide.cfg setup for class tdsguide.cls - -Documentation driver --------------------- - tex/ams.drv generic doc driver for files from the - amslatex and babel bundle - tex/babel.tex doc driver with patches for babel.drv - tex/doc_lppl.tex doc driver for base/lppl.tex - tex/errata.all doc driver for knuth/errata/errata.pdf - tex/errata.drv doc driver for knuth/errata/errata_*.pdf - tex/errorlog.drv doc driver for knuth/errata/errorlog.tex - tex/etex_man.drv doc driver for etex/etex_man.tex - tex/greek-usage.tex doc driver with patches for babel/usage.tex - tex/knuth.drv doc driver for knuth/{texware,mfware,etc}/*.web - tex/ltnews.tex master file that merges all base/ltnews*.tex - tex/ltxcheck.drv doc driver with patches for ltxcheck.tex - tex/psnfss2e.drv doc driver with patches for psnfss2e.tex - tex/tools-overview.cls class for tools.tex - tex/tools.tex master file for tools overview, generated - by the build.pl script from tools/manifest.txt - -Patches -------- - patch/amsclass.dtx.diff patch for amslatex/amsclass.dtx - patch/amsfndoc.def.diff patch for amsfonts/amsfndoc.def - patch/amsfndoc.tex.diff patch for amsfonts/amsfndoc.tex - patch/amsldoc.tex.diff patch for amslatex/amsldoc.tex - patch/changes.tex.diff patch for amslatex/amsrefs/changes.tex - patch/encguide.tex.diff patch for base/encguide.tex - patch/hebrew.fdd.diff patch for babel/hebrew.fdd - patch/lb2.err.diff patch for base/lb2.err - patch/logmac.tex.diff patch for knuth/errata/logmac.tex - patch/source2e.tex.diff patch for base/source2e.tex - patch/tlc2.err.diff patch for base/tlc2.err - patch/tripman.tex.diff patch for knuth/tex/tripman.tex - patch/trapman.tex.diff patch for knuth/mf/trapman.tex - patch/utf8ienc.dtx.diff patch for base/utf8ienc.dtx - patch/webman.tex.diff patch for knuth/web/webman.tex - - -F. DESIGN PRINCIPLES -==================== - -* Compliance with the latest TDS specification. -* No redundancy. -* User friendly PDF files with navigational support: - * bookmarks - * links -* Complete documentation. The documentation generation with - enhanced PDF files is the tricky part and should be saved - from the user. -* Output format of generated documentation is PDF, see above. - Other formats such as DVI or PS are not generated and provided. -* Documentation bundles are preferred to many partial documentation - files (e.g. source2e.pdf or ltnews.pdf). -* If several expansion stages of a documentation are available, - then just the most complete expansion stage should be used. -* Files that do not fit in a program sub tree of TDS stay below - TDS:source (e.g. latexbug.el from latex/base). Then they do not - get lost at least. -* Page layout: a4paper with reduced vertical margins (exception: ltnews). - (This also decreases the page number usually.) -* ... - - -G. REMARKS -========== - -Base ----- -* source2e.pdf is used instead of many single lt*.pdf files. -* ltnews.pdf is introduced to avoid cluttering the doc directory - with many single sheet ltnews*.pdf files. -* Patch for ltfssdcl.dtx: Checksum fixed. -* ... - -Tools ------ -* Added: tools.pdf as overview/contents/index file with links - and short descriptions of the single packages. (It uses - the data from manifest.txt). -* ... - -Babel ------ -* Babel's TeX files consists of three groups of files: - 1. Hyphenation pattern, see below - 2. Generic files: - *.ldf (language definition files) - *.sty (from bbcompat.dtx, these are plain-TeX files, - LaTeX user have the package babel) - babel.def, switch.def - plain.def - b*plain.tex - esbst.tex - 3. LaTeX files: - *.fd - *enc.def (for package fontenc) - cp*.def, 8859-8.def, si960.def (for package inputenc) - babel.sty - romanidx.tex - athnum.sty, grmath.sty, grsymb.sty (greek.ins) - heb*.sty - Full TDS compliance would use different format subtrees - for the generic and LaTeX files. However practice (TeX Live, teTeX, - VTeX, ...) put them in `generic', mainly because of maintenance issues. - Also babel's *.ins files specify \usedir{tex/generic/babel}. - There can be problems, if different TDS trees have different - babel versions installed and the same file can be found both - in generic and latex. The natural search strategy for TDS compliant - trees would be to look first in tex/latex across the trees, then - in tex/generic. Thus it can happen to use files from the same - package, but different versions. - --> Therefore latex-tds put theses files in the generic subtree. -* Babel already contains babel.pdf as documentation. It is a superset - of user.pdf. Thus I have dropped the latter one to avoid redundancy. - Also the name `babel.pdf' is much more useful (texdoc). -* ... - -Knuth ------ -* Current used CTAN -> TDS mapping: - CTAN:systems/knuth/dist --> TDS:<toplevel>/knuth -* Unsure where to put trip/trap files. Currently they are - put in TDS:source, because the documentation files - (tripman.pdf, trapman.pdf) are in TDS:doc. They lists the - trip/trap files already. -* Not covered is - CTAN:systems/knuth/dist/lib/ - In TeX Live 2007/2008 the files are installed at different - locations: - texmf-dist/fonts/source/public/mflogo/logo10.mf - texmf-dist/fonts/source/public/mflogo/logo8.mf - texmf-dist/fonts/source/public/mflogo/logo9.mf - texmf-dist/fonts/source/public/mflogo/logobf10.mf - texmf-dist/fonts/source/public/mflogo/logo.mf - texmf-dist/fonts/source/public/mflogo/logosl10.mf - texmf-dist/fonts/source/public/misc/grayf.mf - texmf-dist/fonts/source/public/misc/manfnt.mf - texmf-dist/fonts/source/public/misc/slant.mf - texmf-dist/metafont/base/expr.mf - texmf-dist/metafont/base/io.mf - texmf-dist/metafont/base/null.mf - texmf-dist/metafont/base/plain.mf - texmf-dist/metafont/misc/3test.mf - texmf-dist/metafont/misc/6test.mf - texmf-dist/metafont/misc/rtest.mf - texmf-dist/metafont/misc/test.mf - texmf-dist/metafont/misc/waits.mf - texmf-dist/metafont/misc/ztest.mf - texmf-dist/mft/base/cmbase.mft - texmf-dist/mft/base/plain.mft - texmf-dist/tex/generic/misc/null.tex - texmf-dist/tex/plain/base/manmac.tex - texmf-dist/tex/plain/base/mftmac.tex - texmf-dist/tex/plain/base/plain.tex - texmf-dist/tex/plain/base/story.tex - texmf-dist/tex/plain/base/testfont.tex - texmf-dist/tex/plain/base/webmac.tex - texmf/tex/generic/hyphen/hyphen.tex - -e-TeX ------ -* Only the manual `etex_man' is covered by this module. - - -H. BUILD HINTS -============== - -The most important advice I can give: `forget it'! -The purpose of the source files are rather to show, what was -done in which way. -The *.zip with TDS trees are the goal of the project, not the -build process. Some remarks, if someone wants to build the -modules himself: -* TeX compiler: LuaTeX and pdfTeX (>= 1.30). -* An up-to-date LaTeX installation, at least TeX Live 2012. -* Additional packages can be necessary, e.g. - CTAN:language/armenian/armtex.zip is not in TeX Live 2012. -* Most of the PDF files are generated using lualatex and package - `fontspec' that uses the Latin Modern fonts as default. They - are available as OpenType fonts. LuaTeX generates with OpenType - fonts considerably smaller PDF files. Also PDF object stream - compression is used (PDF 1.5). Therefore the further - post-processing of PDF files are currently dropped. -* (Outdated since 2011-07-01) PDF post-processing, I have used two steps: - 1. a) I have written a tool that analyzes page stream contents and - optimizes them (removal of unnecessary color settings, minimize - translation operations, ...). - --> pdfbox-rewrite.jar - b) For reading and writing the PDF file I have used PDFBox - --> PDFBox-0.7.2.jar (http://www.pdfbox.org/) - c) To get better results I patched some of the classes - of PDFBox (especially the write module). - --> pdfbox-rewrite.jar - 2. The final conversion step was done by Multivalent, because - it makes a very good job in PDF compression: - --> Multivalent20060102.jar (http://multivalent.sourceforge.net/) - Multivalent and PDFBox are available, pdfbox-rewrite.jar, however, - is just a first prototype, not ripe for a release. - Therefore this step of post-processing is optional for the - project latex-tds. The build script looks for the library and - skips this steps automatically if necessary. - If you give the build script the option --nopostprocess, - then it will skip the postprocess steps (building is faster, - the pdf files a little larger). - Install the jar files in the directory 'lib' where - they are expected by the build script. -* Unix, Perl background is expected. -* No support or documentation. - - -I. HISTORY -========== - -2006/04/27 - * Start of the project (without babel, amslatex, psnfss). -2006/06/01 - * Module amslatex added. -2006/06/03 - * Modules psnfss and babel added, now all modules are covered. -2006/06/07 - * The project uploaded to CTAN. -2006/07/31 - * Index added to base/classes.dtx. - * ZIP files renamed: '*-tds.zip' -> '*.zip' - * Comment added to ZIP files. - * Update of readme.txt. -2006/08/26 - * Module tds for CTAN:tds/ added. - * Obsolete hyphenation patterns added to babel's source directory - to avoid violation of LPPL. - * Script adjust_checksum added and scripts are put below TDS:scripts. - * TDS:makeindex/base/ renamed to TDS:makeindex/latex/ - * Exception for sample2e.tex and small2e.tex that now go into - TDS:tex/latex/base/. -2006/08/28 - * Default texsys.cfg is generated. - * adjust_checksum.pl and ziptimetree.pl now moved from the scripts - branch to TDS:source/latex/latex-tds/lib/. -2006/12/27 - * Fix of ltxguide.cfg that had loaded doc.sty that disturbs the - verbatim stuff in fntguide.tex. -2007/01/08 - * Fix for documentation of longtable. -2007/03/19 - * Patch for babel/latin.dtx added (babel/3922). -2007/09/04 - * A minor update on CTAN regarding babel: - iahyphen.tex, icehyph.tex, and lahyph.tex are now symbolic links - to their location in CTAN:language/hyphenation/. Therefore also - lahyph.tex is now installed in TDS:tex/generic/hyphen/. -2007/10/18 - * Update of module amslatex because of updated package amsrefs. - * Fix in latin.dtx.diff. -2007/10/24 - * Update of babel. - * Update of amsrefs (TDS:tex/latex/amscls -> TDS:tex/latex/amsrefs). -2008/04/01 - * Update of babel (2008/03/17). -2008/04/02 - * Fix: latex/base/*.err added to TDS:source/latex/base/. -2008/04/05 - * Using .tds.zip instead of .zip to follow CTAN:install's naming - conventions. -2008/06/28 - * Update of babel (2008/06/01). - * Babel documentation: table of contents reformatted. -2008/07/07 - * Update of babel (2008/07/06). -2008/07/10 - * Module knuth added. - * Update of babel (2008/07/07). -2008/07/11 - * Fixes and additions for module knuth. -2008/07/25 - * Module amslatex: instr-l.tex vanished from CTAN (but not at AMS side). - * Some unwanted spaces in generated PDF files fixed. - (Caused by a wrong package file that was found on my system first.) -2008/08/10 - * Module latex3 added. - * Module base: CTAN hyperlinks fixed. - * Module amslatex: Outdated URL fixed in amsldoc.tex. - * Module babel: Problem with already defined \meta in tb1604.tex fixed. -2008/09/06 - * Module base: - * Using uptodate versions from LaTeX project page for errata lists. - * lgc2.err added (LaTeX Graphics Companion, 2. ed.). - * Various fixes in errata lists. - * Module tools/array.dtx: documentation fixed (tools/4044). -2008/09/10 - * Module base: Missing title date for utf8ienc.pdf fixed. -2009/09/05 - * Module amslatex: updated. - * Module latex3: xpackages updated. - * Module latex3: expl3 removed, because nothing to do. -2009/09/25 - * Module amslatex: updated. - * Module babel: updated. - * Update of LaTeX, release 2009/09/24. -2009/12/07 - * Module amslatex: Unhappily the .zip files are quite a mess, - because they contain a mixup of old and new versions. - Tried to sort this out and fix the last update. - * Module latex3: xpackages removed, because nothing to do. - * Module latex3 removed, nothing left to do. -2010/05/04 - * Module base: page layout for source2e fixed (changes, index). - * Module base: update of .err files. -2010/10/27 - * Module amslatex: amscls and amsrefs updated. - * Module etex added (only for etex_man). - * Erratas updated. -2011/03/10 - * Module base: patch for latex/4148 (Missing \label and \ref in lppl.tex'') -2011/04/18 - * Module amslatex: There is an outdated version of amsthm.sty in - CTAN:install/macros/latex/required/amslatex/amscls.tds.zip. - The package amsthm.sty is now generated from the source. - * Using TDS tree for missing packages that are not part of TeX Live. - Module base: CTAN:language/armenian/armtex.zip -2011/06/24 - * Module amslatex: Two downloads from AMS server removed, because - the files are not longer available (and they are on CTAN). - * Module amslatex: 00readme.txt and amsrefs.dtx taken from - CTAN:macros/latex/contrib/amsrefs.zip instead of - CTAN:install/macros/latex/contrib/amsrefs.tds.zip because - the later archive file is out of sync. -2011/06/30 - * Module base: - * Update of LaTeX, release 2011/06/27. - * Patch ltpatch.ltx to match the kernel version. - * Patch lppl.tex.diff removed (no longer needed). - * Patch ltfssdcl.dtx.diff added (checksum fixed). - * Module tools: Release 2011/06. - * Module babel: Release 2011/06. -2011/07/01 - * PDF generation: - * Use of LuaTeX instead of pdfTeX for most of the files. - * Use of package `fontspec' with Latin Modern fonts as - default in OpenType format (smaller PDF file sizes). - The post-processing of PDF files is skipped. - * Various patches and fixes for LuaLaTeX and package `fontspec'. - * Module base: - * Update of LaTeX. - * Patches ltpatch.ltx.diff and ltfssdcl.dtx.diff removed - (no longer needed). - * Module tools: Update. -2011/07/03 - * build.pl: - * Caching for PDF generation added. - * `FINAL' markers in the output of build.pl - for final (Lua|pdf)TeX runs. -2011/07/26 - * PDF generation: Use of package unicode-math with Latin Modern Math - where possible. -2011/08/10 - * Update of tools. -2011/10/05 - * Update of tools (varioref). -2011/11/16 - * Update of babel. -2012/05/12 - * Update of amslatex (amsrefs). - * Update of readme.txt that is renamed to README (CTAN convention). - * Update of tlc2.err. -2013/02/14 - * Update of amslatex (amsrefs). - * Module amslatex: cite-x*.tex, jb.bib in TDS:source/, because - these files are now classified as test files. - * Module base: lb2.err and tlc2.err updated. - * Change in version control system from CVS to git with public - source repository. -2013/02/15 - * Module amsfonts added. diff --git a/Master/texmf-dist/source/latex/latex-tds/README.asciidoc b/Master/texmf-dist/source/latex/latex-tds/README.asciidoc new file mode 100644 index 00000000000..1c76ff763d9 --- /dev/null +++ b/Master/texmf-dist/source/latex/latex-tds/README.asciidoc @@ -0,0 +1,689 @@ +README for project latex-tds +============================ +:author: Heiko Oberdiek +:revdate: 2013/02/26 +:lang: en +:toc: +:numbered: +:ctan: http://mirror.ctan.org/ + +// This file is formatted in the text document format AsciiDoc. + + +Project latex-tds +----------------- + +Version: {revdate} + +How it has started +~~~~~~~~~~~~~~~~~~ +The project started as I wanted to install the new LaTeX release 2005/12/01 +that was announced at 2006/04/27. However the files are not packed in +TDS format, ready for unpacking in the destination directory. And +the documentation files were not yet generated or the provided +PDF files are lacking of basic features such as bookmarks or link support. +Thus this project has started. I thought it could be finished during +the afternoon at the day of the announcement ... + +Goals of the project +~~~~~~~~~~~~~~~~~~~~ +* From the sources a TDS compliant tree is constructed and populated. + The zipped result is distributed. +* All the documentation is generated from the sources. The PDF files + are user friendly and provide navigational support with bookmarks + and links. +* The PDF files are post-processed to reduce the file size. + +Scope +~~~~~ +I do not have the time to assemble a TeX distribution with +thousands of packages. Therefore I restricted myself to the +LaTeX base distribution and the required bundles. +In the following I will use the term `module' for a package bundle. + +Module list +~~~~~~~~~~~ +*base*:: + {ctan}macros/latex/base.zip[CTAN:macros/latex/base.zip] + + {ctan}macros/latex/doc.zip[CTAN:macros/latex/doc.zip] + + http://www.latex-project.org/guides/lb2.err + + http://www.latex-project.org/guides/lgc2.err + + http://www.latex-project.org/guides/manual.err + + http://www.latex-project.org/guides/tlc2.err + + +*tools*:: + {ctan}macros/latex/required/tools[CTAN:macros/latex/required/tools.zip] + +*cyrillic*:: + {ctan}macros/latex/required/cyrillic.zip[CTAN:macros/latex/required/cyrillic.zip] + +*amslatex*:: + {ctan}install/macros/latex/required/amslatex/amscls.tds.zip[CTAN:install/macros/latex/required/amslatex/amscls.tds.zip] + + {ctan}install/macros/latex/required/amslatex/math.tds.zip[CTAN:install/macros/latex/required/amslatex/math.tds.zip] + + {ctan}macros/latex/contrib/amsrefs.zip[CTAN:macros/latex/contrib/amsrefs.zip] + + {ctan}macros/latex/required/amslatex.zip[CTAN:macros/latex/required/amslatex.zip] + + ftp://ftp.ams.org/pub/tex/amsrefs/amsrefs.zip + + ftp://ftp.ams.org/pub/tex/amscls.zip + + ftp://ftp.ams.org/pub/tex/amsmath.zip +*amsfonts*:: + {ctan}install/fonts/amsfonts.tds.zip[CTAN:install/fonts/amsfonts.tds.zip] +*psnfss*:: + {ctan}macros/latex/required/psnfss.zip[CTAN:macros/latex/required/psnfss.zip] +*babel*:: + {ctan}macros/latex/required/babel.zip[CTAN:macros/latex/required/babel.zip] +*tds*:: + {ctan}tds.zip[CTAN:tds.zip] +*knuth*:: + {ctan}systems/knuth/dist/errata.zip[CTAN:systems/knuth/dist/errata.zip] + + {ctan}systems/knuth/dist/etc.zip[CTAN:systems/knuth/dist/etc.zip] + + {ctan}systems/knuth/dist/mfware.zip[CTAN:systems/knuth/dist/mfware.zip] + + {ctan}systems/knuth/dist/texware.zip[CTAN:systems/knuth/dist/texware.zip] + + {ctan}systems/knuth/dist/web.zip[CTAN:systems/knuth/dist/web.zip] + + {ctan}systems/knuth/dist/tex.zip[CTAN:systems/knuth/dist/tex.zip] + + {ctan}systems/knuth/dist/mf.zip[CTAN:systems/knuth/dist/mf.zip] +*etex*:: + {ctan}systems/e-tex/v2.1/etex_doc.zip[CTAN:systems/e-tex/v2.1/etex_doc.zip] + +Author +~~~~~~ +{author} <heiko.oberdiek at googlemail.com> + +Home +~~~~ +CTAN home with distribution files: +____ +{ctan}macros/latex/contrib/latex-tds/[CTAN:macros/latex/contrib/latex-tds/] +____ + +Source repository (without distribution files): +____ +https://github.com/oberdiek/latex-tds +____ + + +Abbreviations, Glossary +----------------------- +CTAN:: + Comprehensive TeX Archive Network. + + FAQ entry: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=archives + + For example, you can resolve the prefix +CTAN:+ by using + +{ctan}+. +latex-tds:: + The name of this project. +TDS:: + TeX Directory Structure. + + FAQ entry: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds + + Specification: http://www.ctan.org/pkg/tds + + +Download +-------- + +The home of the project is located at: +____ +{ctan}/macros/latex/contrib/latex-tds/[CTAN:macros/latex/contrib/latex-tds/] +____ + +The following files can be downloaded: + +* +README+, +README.html+, +README.pdf+: + The README file in different formats. + +* +<module>.tds.zip+: The module distribution files, + see section `<<_module_list,Module list>>' above + for the available modules. + +* +source.tds.zip+: The sources, mainly the build script, configuration and + driver files, and patches. + Some of the used tools are not provided, see section + `<<_build_hints, Build Hints>>'. + +* +latex-tds.tds.zip+: The universe, the contents of all the ZIP files above, + merged together. + +Installation Hints +------------------ + +Hopefully the result of this project helps you in the installation +process. You get a TDS compliant tree just by unpacking. + +Example: +---- + cd /some/where/texmf + unzip latex-tds +---- +or unzip's option +-d+: +---- + unzip latex-tds -d /some/where/texmf +---- + +Instead of the universe ZIP file single modules can be selected. + +Important to remember, point your unpack process right in +the root directory of your TDS tree. The directory structure +in the ZIP files start with the top-level directories: +---- + doc/latex/base/... + tex/latex/tools/... + source/... +---- +Rationale: The root directory of a TDS tree can have different +names, such as texmf-dist, texmf-local, ... + +Hints +~~~~~ +-- +* Refresh the file name database. +* Be aware that unpacking can insert and update files, but never + deletes obsolete ones. Remainders of previous releases can + cause trouble. +* Depending on the module further installation steps can be + necessary, consult the module's own documentation. +-- + +Module base +^^^^^^^^^^^ + * The default +texsys.cfg+ that LaTeX provides is put + into +TDS:tex/latex/base+. It must be removed, if you need + a specialized version. Consult your TeX distribution + and +TDS:doc/latex/base/source2e.pdf+ (module ltdirchk). + Usually changes are not required for many TeX distributions + such as Unix (web2c), MikTeX, ... + * Formats need rebuilding (e.g., fmtutil). + +Module babel +^^^^^^^^^^^^ + * Most hyphenation patterns are not provided here. Usually you can + find them somewhere below {ctan}language/hyphenation/[CTAN:language/hyphenation/]. + * Language configuration (+language.dat+), see the documentation of + your TeX distribution. + * Formats need rebuilding. + +Module psnfss +^^^^^^^^^^^^^ + * The map files need further configuring (e.g., updmap). + +Module graphics +^^^^^^^^^^^^^^^ + * Module graphics does not provide all driver files, because some are + developed independently (+pdftex.def+, ...). + + +Copyright, License +------------------ + +Copyright (C) 2006-2013 Heiko Oberdiek. + +License is LPPL 1.3c: + +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 (at your option) any later version. +The latest version of this license is in + http://www.latex-project.org/lppl.txt +and version 1.3c or later is part of all distributions of LaTeX +version 2005/12/01 or later. + +This work has the LPPL maintenance status `maintained'. + +The Current Maintainer of this work is Heiko Oberdiek. + +See the following section `<<_manifest, Manifest>>' for a list of all files +belonging to the project `latex-tds'. + + +Manifest +-------- + +Included are the projects `adjust_checksum' and `ziptimetree'. +They are projects of their own. + +Documentation +~~~~~~~~~~~~~ +[cols=".3literal,.7", frame="topbot", grid="rows"] +|=== +|README |this file +|=== + +Licenses +~~~~~~~~ +[cols=".3literal,.7", frame="topbot", grid="rows"] +|=== +|license/lppl.txt |LPPL (The LaTeX Project Public License) + for latex-tds and adjust_checksum +|license/ziptimetree/lgpl.txt |LGPL (GNU Lesser General Public License) + for ziptimetree +|=== + +Scripts +~~~~~~~ +[cols=".3literal,.7", frame="topbot", grid="rows"] +|=== +|build.pl |main script for building the distribution +|lib/adjust_checksum.pl |Perl script that runs a DTX file through + LaTeX and corrects its +\Checksum+ if necessary +|lib/ziptimetree.pl |Perl script that generates a ZIP file from + a directory tree with sorted entries (LGPL) +|=== + +Configuration +~~~~~~~~~~~~~ +[cols=".3literal,.7", frame="topbot", grid="rows"] +|=== +|tex/docstrip.cfg |enables TDS feature and creates directories +|tex/errata.cfg |for errata lists of latex/base +|tex/hyperref.cfg |hyperref configuration file +|tex/ltnews.cfg |for LaTeX News of latex/base +|tex/ltxdoc.cfg |setup for class ltxdoc +|tex/ltxguide.cfg |setup for the guide manuals in latex/base + and required/psnfss +|tex/ltugboat.cls |setup for class ltugboat +|tex/lualatex-tds.ini |init file for format generation for LuaTeX +|tex/lualatex-tds2.ini |init file for LuaTeX format without LM Math +|tex/manual.cfg |setup for errata list of the LaTeX manual + in latex/base +|tex/pdflatex-tds.ini |init file for format generation for pdfTeX +|tex/tdsguide.cfg |setup for class +tdsguide.cls+ +|=== + +Documentation driver +~~~~~~~~~~~~~~~~~~~~ +[cols="1*.3literal,1*.7", frame="topbot", grid="rows"] +|=== +|tex/ams.drv |generic doc driver for files from the + amslatex and babel bundle +|tex/babel.tex |doc driver with patches for +babel.drv+ +|tex/doc_lppl.tex |doc driver for +base/lppl.tex+ +|tex/errata.all |doc driver for +knuth/errata/errata.pdf+ +|tex/errata.drv |doc driver for +knuth/errata/errata_*.pdf+ +|tex/errorlog.drv |doc driver for +knuth/errata/errorlog.tex+ +|tex/etex_man.drv |doc driver for +etex/etex_man.tex+ +|tex/greek-usage.tex |doc driver with patches for +babel/usage.tex+ +|tex/knuth.drv |doc driver for +knuth/+{+texware+,+mfware+,+etc+}+/*.web+ +|tex/ltnews.tex |master file that merges all +base/ltnews*.tex+ +|tex/ltxcheck.drv |doc driver with patches for +ltxcheck.tex+ +|tex/psnfss2e.drv |doc driver with patches for +psnfss2e.tex+ +|tex/tools-overview.cls |class for +tools.tex+ +|tex/tools.tex |master file for tools overview, generated + by the +build.pl+ script from +tools/manifest.txt+ +|=== + +Patches +~~~~~~~ +[cols=".3l,.7l", options="header", frame="topbot", grid="rows"] +|=== +|Diff/patch file|Patched file +|patch/amsclass.dtx.diff |amslatex/amsclass.dtx +|patch/amsfndoc.def.diff |amsfonts/amsfndoc.def +|patch/amsfndoc.tex.diff |amsfonts/amsfndoc.tex +|patch/amsldoc.tex.diff |amslatex/amsldoc.tex +|patch/changes.tex.diff |amslatex/amsrefs/changes.tex +|patch/encguide.tex.diff |base/encguide.tex +|patch/hebrew.fdd.diff |babel/hebrew.fdd +|patch/logmac.tex.diff |knuth/errata/logmac.tex +|patch/source2e.tex.diff |base/source2e.tex +|patch/tlc2.err.diff |base/tlc2.err +|patch/tripman.tex.diff |knuth/tex/tripman.tex +|patch/trapman.tex.diff |knuth/mf/trapman.tex +|patch/utf8ienc.dtx.diff |base/utf8ienc.dtx +|patch/webman.tex.diff |knuth/web/webman.tex +|=== + + +Design Principles +----------------- + +* Compliance with the latest TDS specification. +* No redundancy. +* User friendly PDF files with navigational support: + - bookmarks + - links +* Complete documentation. The documentation generation with + enhanced PDF files is the tricky part and should be saved + from the user. +* Output format of generated documentation is PDF, see above. + Other formats such as DVI or PS are not generated and provided. +* Documentation bundles are preferred to many partial documentation + files (e.g. +source2e.pdf+ or +ltnews.pdf+). +* If several expansion stages of a documentation are available, + then just the most complete expansion stage should be used. +* Files that do not fit in a program sub tree of TDS stay below + +TDS:source+ (e.g. +latexbug.el+ from latex/base). Then they do not + get lost at least. +* Page layout: +a4paper+ with reduced vertical margins (exception: ltnews). + (This also decreases the page number usually.) +* ... + + +Remarks +------- + +Base +~~~~ +* +source2e.pdf+ is used instead of many single +lt*.pdf+ files. +* +ltnews.pdf+ is introduced to avoid cluttering the doc directory + with many single sheet +ltnews*.pdf+ files. +* Patch for +ltfssdcl.dtx+: Checksum fixed. +* ... + +Tools +~~~~~ +* Added: +tools.pdf+ as overview/contents/index file with links + and short descriptions of the single packages. (It uses + the data from +manifest.txt+). +* ... + +Babel +~~~~~ +* Babel's TeX files consists of three groups of files: ++ + 1. Hyphenation pattern, see below. + 2. Generic files: + - +*.ldf+ (language definition files) + - +*.sty+ (from +bbcompat.dtx+, these are plain TeX files, + LaTeX user have the package babel) + - +babel.def+, +switch.def+ + - +plain.def+ + - +b*plain.tex+ + - +esbst.tex+ + 3. LaTeX files: + - +*.fd+ + - +*enc.def+ (for package fontenc) + - +cp*.def+, +8859-8.def+, +si960.def+ (for package inputenc) + - +babel.sty+ + - +romanidx.tex+ + - +athnum.sty+, +grmath.sty+, +grsymb.sty+ (+greek.ins+) + - +heb*.sty+ + ++ +Full TDS compliance would use different format subtrees + for the generic and LaTeX files. However practice (TeX Live, teTeX, + VTeX, ...) put them in +generic+, mainly because of maintenance issues. + Also babel's +*.ins+ files specify +\usedir{tex/generic/babel}+. + There can be problems, if different TDS trees have different + babel versions installed and the same file can be found both + in generic and latex. The natural search strategy for TDS compliant + trees would be to look first in +tex/latex+ across the trees, then + in tex/generic. Thus it can happen to use files from the same + package, but different versions. + Therefore latex-tds put these files in the +generic+ subtree. +-- +* Babel already contains +babel.pdf+ as documentation. It is a superset + of +user.pdf+. Thus I have dropped the latter one to avoid redundancy. + Also the name +babel.pdf+ is much more useful (texdoc). +* ... +-- + +Knuth +~~~~~ +* Current CTAN -> TDS mapping in use: + +CTAN:systems/knuth/dist+ -> +TDS:<toplevel>/knuth+ +* Unsure where to put trip/trap files. Currently they are + put in +TDS:source+, because the documentation files + (+tripman.pdf+, +trapman.pdf+) are in +TDS:doc+. They lists the + trip/trap files already. +* Not covered is + {ctan}systems/knuth/dist/lib/[CTAN:systems/knuth/dist/lib/] + In TeX Live 2007/2008 the files are installed at different + locations: ++ + texmf-dist/fonts/source/public/mflogo/logo10.mf + texmf-dist/fonts/source/public/mflogo/logo8.mf + texmf-dist/fonts/source/public/mflogo/logo9.mf + texmf-dist/fonts/source/public/mflogo/logobf10.mf + texmf-dist/fonts/source/public/mflogo/logo.mf + texmf-dist/fonts/source/public/mflogo/logosl10.mf + texmf-dist/fonts/source/public/misc/grayf.mf + texmf-dist/fonts/source/public/misc/manfnt.mf + texmf-dist/fonts/source/public/misc/slant.mf + texmf-dist/metafont/base/expr.mf + texmf-dist/metafont/base/io.mf + texmf-dist/metafont/base/null.mf + texmf-dist/metafont/base/plain.mf + texmf-dist/metafont/misc/3test.mf + texmf-dist/metafont/misc/6test.mf + texmf-dist/metafont/misc/rtest.mf + texmf-dist/metafont/misc/test.mf + texmf-dist/metafont/misc/waits.mf + texmf-dist/metafont/misc/ztest.mf + texmf-dist/mft/base/cmbase.mft + texmf-dist/mft/base/plain.mft + texmf-dist/tex/generic/misc/null.tex + texmf-dist/tex/plain/base/manmac.tex + texmf-dist/tex/plain/base/mftmac.tex + texmf-dist/tex/plain/base/plain.tex + texmf-dist/tex/plain/base/story.tex + texmf-dist/tex/plain/base/testfont.tex + texmf-dist/tex/plain/base/webmac.tex + texmf/tex/generic/hyphen/hyphen.tex + +e-TeX +~~~~~ +* Only the manual `etex_man' is covered by this module. + + +Build Hints +----------- + +The most important advice I can give: `Forget it'! +The purpose of the source files are rather to show, what was +done in which way. +The +*.zip+ with TDS trees are the goal of the project, not the +build process. Some remarks, if someone wants to build the +modules himself: + +* TeX compiler: LuaTeX and pdfTeX (≥ 1.30). +* An up-to-date LaTeX installation, at least TeX Live 2012. +* Additional packages can be necessary, e.g. + {ctan}language/armenian/armtex.zip[CTAN:language/armenian/armtex.zip] + is not part of TeX Live 2012. +* Most of the PDF files are generated using lualatex and package + `fontspec' that uses the Latin Modern fonts as default. They + are available as OpenType fonts. LuaTeX generates with OpenType + fonts considerably smaller PDF files. Also PDF object stream + compression is used (PDF 1.5). Therefore the further + post-processing of PDF files are currently dropped. +* (Outdated since 2011-07-01) PDF post-processing, I have used two steps: ++ +-- + 1. First step: + a. I have written a tool that analyzes page stream contents and + optimizes them (removal of unnecessary color settings, minimize + translation operations, ...) + -> +pdfbox-rewrite.jar+. + b. For reading and writing the PDF file I have used PDFBox + -> +PDFBox-0.7.2.jar+ (http://pdfbox.apache.org/). + c. To get better results I patched some of the classes + of PDFBox (especially the write module) + -> +pdfbox-rewrite.jar+. + 2. The final conversion step was done by Multivalent, because + it makes a very good job in PDF compression: + -> +Multivalent20060102.jar+ (http://multivalent.sourceforge.net/) + +Multivalent and PDFBox are available, +pdfbox-rewrite.jar+, however, + is just a first prototype, not ripe for a release. + Therefore this step of post-processing is optional for the + project latex-tds. The build script looks for the library and + skips this steps automatically if necessary. + If you give the build script the option +--nopostprocess+, + then it will skip the postprocess steps (building is faster, + the pdf files a little larger). + Install the jar files in the directory +lib+ where + they are expected by the build script. +-- +* Unix, Perl background is expected. +* No support or documentation. + + +History +------- + +2006/04/27:: + * Start of the project (without babel, amslatex, psnfss). +2006/06/01:: + * Module amslatex added. +2006/06/03:: + * Modules psnfss and babel added, now all modules are covered. +2006/06/07:: + * The project uploaded to CTAN. +2006/07/31:: + * Index added to base/classes.dtx. + * ZIP files renamed: +\*-tds.zip+ -> +*.zip+ + * Comment added to ZIP files. + * Update of +readme.txt+. +2006/08/26:: + * Module tds for {ctan}tds/[CTAN:tds/] added. + * Obsolete hyphenation patterns added to babel's source directory + to avoid violation of LPPL. + * Script adjust_checksum added and scripts are put below +TDS:scripts+. + * +TDS:makeindex/base/+ renamed to +TDS:makeindex/latex/+ + * Exception for +sample2e.tex+ and +small2e.tex+ that now go into + +TDS:tex/latex/base/+. +2006/08/28:: + * Default +texsys.cfg+ is generated. + * +adjust_checksum.pl+ and +ziptimetree.pl+ now moved from the +scripts+ + branch to +TDS:source/latex/latex-tds/lib/+. +2006/12/27:: + * Fix of +ltxguide.cfg+ that had loaded doc.sty that disturbs the + verbatim stuff in +fntguide.tex+. +2007/01/08:: + * Fix for documentation of longtable. +2007/03/19:: + * Patch for +babel/latin.dtx+ added (babel/3922). +2007/09/04:: + * A minor update on CTAN regarding babel: + +iahyphen.tex+, +icehyph.tex+, and +lahyph.tex+ are now symbolic links + to their location in {ctan}language/hyphenation/[CTAN:language/hyphenation/]. + Therefore also + +lahyph.tex+ is now installed in +TDS:tex/generic/hyphen/+. +2007/10/18:: + * Update of module amslatex because of updated package amsrefs. + * Fix in +latin.dtx.diff+. +2007/10/24:: + * Update of babel. + * Update of amsrefs (+TDS:tex/latex/amscls+ -> +TDS:tex/latex/amsrefs+). +2008/04/01:: + * Update of babel (2008/03/17). +2008/04/02:: + * Fix: +latex/base/*.err+ added to +TDS:source/latex/base/+. +2008/04/05:: + * Using +.tds.zip+ instead of .zip to follow +CTAN:install+'s naming + conventions. +2008/06/28:: + * Update of babel (2008/06/01). + * Babel documentation: table of contents reformatted. +2008/07/07:: + * Update of babel (2008/07/06). +2008/07/10:: + * Module knuth added. + * Update of babel (2008/07/07). +2008/07/11:: + * Fixes and additions for module knuth. +2008/07/25:: + * Module amslatex: +instr-l.tex+ vanished from CTAN (but not at AMS side). + * Some unwanted spaces in generated PDF files fixed. + (Caused by a wrong package file that was found on my system first.) +2008/08/10:: + * Module latex3 added. + * Module base: CTAN hyperlinks fixed. + * Module amslatex: Outdated URL fixed in +amsldoc.tex+. + * Module babel: Problem with already defined +\meta+ in +tb1604.tex+ fixed. +2008/09/06:: + * Module base: + - Using uptodate versions from LaTeX project page for errata lists. + - +lgc2.err+ added (LaTeX Graphics Companion, 2. ed.). + - Various fixes in errata lists. + * Module tools: +array.dtx+: documentation fixed (tools/4044). +2008/09/10:: + * Module base: Missing title date for utf8ienc.pdf fixed. +2009/09/05:: + * Module amslatex: updated. + * Module latex3: xpackages updated. + * Module latex3: expl3 removed, because nothing to do. +2009/09/25:: + * Module amslatex: updated. + * Module babel: updated. + * Update of LaTeX, release 2009/09/24. +2009/12/07:: + * Module amslatex: Unhappily the +.zip+ files are quite a mess, + because they contain a mixup of old and new versions. + Tried to sort this out and fix the last update. + * Module latex3: xpackages removed, because nothing to do. + * Module latex3 removed, nothing left to do. +2010/05/04:: + * Module base: page layout for source2e fixed (changes, index). + * Module base: update of +.err+ files. +2010/10/27:: + * Module amslatex: amscls and amsrefs updated. + * Module etex added (only for etex_man). + * Erratas updated. +2011/03/10:: + * Module base: patch for latex/4148 (Missing +\label+ and +\ref+ in +lppl.tex+). +2011/04/18:: + * Module amslatex: There is an outdated version of amsthm.sty in + {ctan}install/macros/latex/required/amslatex/amscls.tds.zip[CTAN:install/macros/latex/required/amslatex/amscls.tds.zip]. + The package +amsthm.sty+ is now generated from the source. + * Using TDS tree for missing packages that are not part of TeX Live. + Module base: {ctan}language/armenian/armtex.zip[CTAN:language/armenian/armtex.zip]. +2011/06/24:: + * Module amslatex: Two downloads from AMS server removed, because + the files are not longer available (and they are on CTAN). + * Module amslatex: 00readme.txt and amsrefs.dtx taken from + {ctan}macros/latex/contrib/amsrefs.zip[CTAN:macros/latex/contrib/amsrefs.zip] instead of + {ctan}install/macros/latex/contrib/amsrefs.tds.zip[CTAN:install/macros/latex/contrib/amsrefs.tds.zip] + because the later archive file is out of sync. +2011/06/30:: + * Module base: + - Update of LaTeX, release 2011/06/27. + - Patch +ltpatch.ltx+ to match the kernel version. + - Patch +lppl.tex.diff+ removed (no longer needed). + - Patch +ltfssdcl.dtx.diff+ added (checksum fixed). + * Module tools: Release 2011/06. + * Module babel: Release 2011/06. +2011/07/01:: + * PDF generation: + - Use of LuaTeX instead of pdfTeX for most of the files. + - Use of package `fontspec' with Latin Modern fonts as + default in OpenType format (smaller PDF file sizes). + The post-processing of PDF files is skipped. + - Various patches and fixes for LuaLaTeX and package `fontspec'. + * Module base: + - Update of LaTeX. + - Patches +ltpatch.ltx.diff+ and +ltfssdcl.dtx.diff+ removed + (no longer needed). + * Module tools: Update. +2011/07/03:: + * build.pl: + - Caching for PDF generation added. + - `FINAL' markers in the output of +build.pl+ + for final (Lua|pdf)TeX runs. +2011/07/26:: + * PDF generation: Use of package unicode-math with Latin Modern Math + where possible. +2011/08/10:: + * Update of tools. +2011/10/05:: + * Update of tools (varioref). +2011/11/16:: + * Update of babel. +2012/05/12:: + * Update of amslatex (amsrefs). + * Update of +readme.txt+ that is renamed to +README+ (CTAN convention). + * Update of +tlc2.err+. +2013/02/14:: + * Update of amslatex (amsrefs). + * Module amslatex: +cite-x*.tex+, +jb.bib+ in +TDS:source/+, because + these files are now classified as test files. + * Module base: +lb2.err+ and +tlc2.err+ updated. + * Change in version control system from CVS to git with public + source repository. +2013/02/15:: + * Module amsfonts added. +2013/02/25:: + * Patch file +lb2.err.diff+ removed by call of sed inside +build.pl+. + * +README+ rewritten in text document format http://www.methods.co.nz/asciidoc/[AsciiDoc] + and added as HTML and PDF files. + * +README.asciidoc+ updated. + * +Makefile+: Target `check-links' added. +2013/02/26:: + * +README+ generated from +README.asciidoc+ via +README.html+. diff --git a/Master/texmf-dist/source/latex/latex-tds/build.pl b/Master/texmf-dist/source/latex/latex-tds/build.pl index d1ff6b4bae7..3f18b34a211 100755 --- a/Master/texmf-dist/source/latex/latex-tds/build.pl +++ b/Master/texmf-dist/source/latex/latex-tds/build.pl @@ -4,8 +4,8 @@ $^W=1; my $prj = 'latex-tds'; my $file = 'build.pl'; -my $version = '1.175'; -my $date = '2014-02-15'; +my $version = '1.178'; +my $date = '2013-02-26'; my $author = 'Heiko Oberdiek'; my $copyright = "Copyright 2006-2013 $author"; chomp(my $license = <<"END_LICENSE"); @@ -56,10 +56,10 @@ my @pkg_list = ( ); my $zip_comment = <<'END_ZIP_COMMENT'; -************************************************* -* This file is part of project 'latex-tds', see * -* CTAN:macros/latex/contrib/latex-tds/README * -************************************************* +*************************************************** +* This file is part of project 'latex-tds', see * +* CTAN:macros/latex/contrib/latex-tds/README.html * +*************************************************** END_ZIP_COMMENT my $error = "!!! Error:"; @@ -89,9 +89,10 @@ my $file_ctan_distrib = "$cwd/$prj.zip"; my $file_ziptimetree = get_perl_script('ziptimetree'); my $file_adjust_checksum = get_perl_script('adjust_checksum'); +my $prg_asciidoc = 'asciidoc'; +my $prg_bibtex = 'bibtex'; my $prg_checksum = $file_adjust_checksum; -my $prg_bibtex = "bibtex"; -my $prg_chmod = "chmod"; +my $prg_chmod = 'chmod'; my $prg_cp = 'cp -p'; my $prg_curl = 'curl'; my $prg_docstrip = 'tex -shell-escape'; @@ -105,7 +106,8 @@ my $prg_ls = "ls"; my $prg_makeindex = 'makeindex'; my $prg_mkdir = 'mkdir'; my $prg_mv = 'mv'; -my $prg_patch = "patch"; +my $prg_patch = 'patch'; +my $prg_lowriter = 'lowriter'; my $prg_lualatex = 'lualatex'; my $prg_lualatextds = "lualatex -fmt=$cwd/$dir_build/lualatex-tds"; my $prg_lualatextds2 = "lualatex -fmt=$cwd/$dir_build/lualatex-tds2"; @@ -119,6 +121,7 @@ my $prg_sed = "sed"; my $prg_sort = "sort"; my $prg_texhash = "texhash"; my $prg_unzip = 'unzip'; +my $prg_w3m = 'w3m'; my $prg_weave = 'weave'; my $prg_wget = 'wget'; my $prg_zip = 'zip'; @@ -632,10 +635,16 @@ section('Patches after source install'); chdir $cwd; patch('base/encguide.tex'); - patch('base/lb2.err'); patch('base/source2e.tex'); patch('base/tlc2.err'); patch('base/utf8ienc.dtx'); + # lb2.err contains <CR><LF> line endings, a patch file + # created by diff in Linux would create mixed line endings + # causing trouble for subversion (Karl Berry). + # Therefore the percent character is inserted by sed. + run("$prg_sed -i -e '" + . 's/\\\\usepackage\[latin1]{inputenc}/%\\\\usepackage[latin1]{inputenc}/' + . "' $dir_build/base/lb2.err"); run("$prg_recode latin1..utf8 $dir_build/base/lb2.err"); } @@ -1793,13 +1802,86 @@ if ($modules{'etex'}) { if ($modules{'source'}) { section('Module source'); - my $dir_dest = "$dir_build/source/texmf/source/latex/latex-tds"; + my $dir_build_source = "$dir_build/source"; + my $dir_dest = "$dir_build_source/texmf/source/latex/latex-tds"; + my $dir_doc = "$dir_build_source/texmf/doc/latex/latex-tds"; my $dir_scripts = "$dir_build/source/texmf/scripts"; + my $file_readme = 'README'; + my $file_readme_html = 'README.html'; + my $file_readme_pdf = 'README.pdf'; + my $file_readme_notoc_html = "$dir_build_source/README-notoc.html"; + my $file_readme_w3m_txt = "$dir_build_source/README-w3m.txt"; + + ensure_directory($dir_build_source); + + # generate README.html + run("$prg_asciidoc --backend=xhtml11 README.asciidoc"); + + # generate README.pdf + run("$prg_asciidoc --out-file=$file_readme_notoc_html" + . " --backend=xhtml11" + . " -a disable-javascript" + . " -a toc!" + . " README.asciidoc" + ); + run("$prg_lowriter --invisible --convert-to odt " + . "--outdir $dir_build_source $file_readme_notoc_html"); + run("$prg_lowriter --invisible --convert-to pdf " + . "--outdir $dir_build_source $dir_build_source/README-notoc.odt"); + run("$prg_cp -p $dir_build_source/README-notoc.pdf $file_readme_pdf"); + + # run("$prg_cp -p README.asciidoc $dir_build_source/README"); + run("$prg_w3m -dump README.html>$file_readme_w3m_txt"); + my @lines_pre; + my @lines_toc; + my @lines_post; + my $state = 'pre'; + open(IN, '<', $file_readme_w3m_txt) + or die "$error Cannot open `$file_readme_w3m_txt'!\n"; + while (<IN>) { + if (/^README for project/) { + push @lines_pre, '=' x (length($_) - 1) . "\n"; + push @lines_pre, $_; + push @lines_pre, '=' x (length($_) - 1) . "\n"; + next; + } + if (/^Table of Contents/i) { + push @lines_pre, "\n"; + push @lines_pre, "\n"; + push @lines_pre, $_; + push @lines_pre, '=' x (length($_)-1) . "\n"; + next; + } + if (/^(\d+)\.(\d+\.)? /) { + push @lines_post, "\n" unless $2; + push @lines_post, $_; + push @lines_post, ($2 ? '-' : '=') x length($_) . "\n"; + my $prefix = ' ' x (3 * ($2 ? 2 : 1)); + s/^(\d+)\.(\d+\.)? /($1<10 ? ' ' : '') . "$1.$2 "/e; + push @lines_toc, "$prefix$_"; + next; + } + if (/^JavaScript must be enabled/) { + $state = 'post'; + next; + } + if ($state eq 'pre') { + push @lines_pre, $_; + } + else { + push @lines_post, $_; + } + } + close(IN); + open(OUT, '>', $file_readme) or die "$error Cannot write `$file_readme'!\n"; + print OUT @lines_pre, @lines_toc, @lines_post; + close(OUT); install $dir_dest, qw[ build.pl - README + README.asciidoc ]; + install "$dir_dest/tex", glob("$dir_tex/*.*"); install "$dir_dest/patch", glob("$dir_patch/*.*"); install "$dir_dest/lib", $file_ziptimetree; @@ -1807,7 +1889,12 @@ if ($modules{'source'}) { install "$dir_dest/license/latex-tds", "$dir_license/latex-tds/lppl.txt"; install "$dir_dest/license/adjust_checksum", "$dir_license/adjust_checksum/lppl.txt"; install "$dir_dest/license/ziptimetree", "$dir_license/ziptimetree/lgpl.txt"; - install $dir_distrib, 'README'; + install $dir_distrib, $file_readme; + install $dir_distrib, $file_readme_html; + install $dir_distrib, $file_readme_pdf; + install $dir_doc, $file_readme; + install $dir_doc, $file_readme_html; + install $dir_doc, $file_readme_pdf; } ### Module latex-tds @@ -1856,7 +1943,7 @@ section('Distrib'); if ($opt_all) { chdir $dir_distrib; - my $cmd = "$prg_zip -0 $file_ctan_distrib README"; + my $cmd = "$prg_zip -0 $file_ctan_distrib README README.html README.pdf"; for my $pkg (sort @pkg_list) { $cmd .= " $pkg.tds.zip"; } diff --git a/Master/texmf-dist/source/latex/latex-tds/patch/lb2.err.diff b/Master/texmf-dist/source/latex/latex-tds/patch/lb2.err.diff deleted file mode 100644 index c7cca91913f..00000000000 --- a/Master/texmf-dist/source/latex/latex-tds/patch/lb2.err.diff +++ /dev/null @@ -1,19 +0,0 @@ -*** lb2.err.org 2012-05-15 21:04:02.000000000 +0200 ---- lb2.err 2013-02-14 00:05:27.359730667 +0100 -*************** -*** 327,333 **** - \usepackage{url} - - \usepackage[ngerman]{babel} -! \usepackage[latin1]{inputenc} - - \begin{document} - ---- 327,333 ---- - \usepackage{url} - - \usepackage[ngerman]{babel} -! % \usepackage[latin1]{inputenc} - - \begin{document} - |