summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2016-04-06 21:43:13 +0000
committerKarl Berry <karl@freefriends.org>2016-04-06 21:43:13 +0000
commitc534836c5cf31728afb592a36ab345f786e06e39 (patch)
tree0ab23c1a08aac90df04c7e472d529af19f395d2c /Master/texmf-dist/doc
parent5c59ebfc8bb1cabb783923ac8f627f6982216385 (diff)
tex-ini-files (27feb16)
git-svn-id: svn://tug.org/texlive/trunk@40270 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/generic/tex-ini-files/README.md55
-rw-r--r--Master/texmf-dist/doc/generic/tex-ini-files/pdftexconfig.dat18
2 files changed, 73 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/generic/tex-ini-files/README.md b/Master/texmf-dist/doc/generic/tex-ini-files/README.md
new file mode 100644
index 00000000000..2807e9b07ee
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/tex-ini-files/README.md
@@ -0,0 +1,55 @@
+# Model TeX format creation files
+
+This bundle provides a collection of model `.ini` files for
+creating TeX formats. These files are commonly used to introduced
+distribution-dependent variations in formats. They are also used
+to allow existing format source files to be used with newer
+engines, for example to adapt the plain e-TeX source file to
+work with XeTeX and LuaTeX.
+
+## Shared configuration
+
+The file `pdftexconfig.dat` contains common settings for pdfTeX
+and LuaTeX, most of which are concerned with direct PDF output.
+These settings are given in a key-value format and are named
+based on the pdfTeX 1.40 primitives. The values for the settings
+themselves is taken from the standard values in TeX Live 2010
+with the paper size set as A4.
+
+Loading this data in pdfTeX is achieved by `pdftexconfig.tex`,
+whereas for LuaTeX the file `luatexconfig.tex` is needed. Both
+of these files will load the shared data file and assign the
+appropriate primitives.
+
+The loaders recognise the marker control sequence `\dvimode`.
+If this is defined, the loaders will set the format to produce
+DVI file, and otherwise will select direct PDF output. The loader
+will then undefine `\dvimode`.
+
+## History
+
+The use of `.ini` files for building formats has developed over
+some time. The initial versions of the files collected here were
+taken from TeX Live 2015, and thus carry forward long-standing
+behaviours from this system. Initial modifications were made
+to allow for significant changes in LuaTeX primitive support
+between TeX Live 2015 and TeX Live 2016.
+
+The files provided here are designed to work with other support
+files and engines available from late 2015 onward, in particular:
+- pdfTeX v1.40+
+- LuaTeX v0.80+
+- XeTeX v0.99992+
+- LaTeX2e 2015-01-01 onward
+- unicode-data v1.0+
+
+Major changes:
+- 2016-02-27 First version of bundle
+
+A full history of this bundle is available from
+https://github.com/josephwright/tex-ini-files
+
+## Legal
+
+The files provided here were originally written by various
+authors and are all marked as public domain.
diff --git a/Master/texmf-dist/doc/generic/tex-ini-files/pdftexconfig.dat b/Master/texmf-dist/doc/generic/tex-ini-files/pdftexconfig.dat
new file mode 100644
index 00000000000..482b32ae4b6
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/tex-ini-files/pdftexconfig.dat
@@ -0,0 +1,18 @@
+% tex-ini-files 2016-02-27: pdftexconfig.dat
+
+% Shared configuration for pdfTeX/LuaTeX low-level settings
+
+% Paper size: dimensions given in absolute terms
+pageheight = 297 true mm
+pagewidth = 210 true mm
+
+% Enable PDF 1.5 output and thus more compression
+minorversion = 5
+objcompresslevel = 2
+
+% Low-level settings unlikely ever to need to change
+compresslevel = 9
+decimaldigits = 3
+pkresolution = 600
+horigin = 1 true in
+vorigin = 1 true in