summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/info
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf/doc/info')
-rw-r--r--Master/texmf/doc/info/asymptote.info2063
-rw-r--r--Master/texmf/doc/info/dir1
-rw-r--r--Master/texmf/doc/info/dvipng.info55
-rw-r--r--Master/texmf/doc/info/dvips.info631
-rw-r--r--Master/texmf/doc/info/fontname.info1219
-rw-r--r--Master/texmf/doc/info/kpathsea.info786
-rw-r--r--Master/texmf/doc/info/web2c.info809
7 files changed, 2836 insertions, 2728 deletions
diff --git a/Master/texmf/doc/info/asymptote.info b/Master/texmf/doc/info/asymptote.info
index 0df4062ecf3..108efc52ce3 100644
--- a/Master/texmf/doc/info/asymptote.info
+++ b/Master/texmf/doc/info/asymptote.info
@@ -1,7 +1,7 @@
This is asymptote.info, produced by makeinfo version 4.13 from
../asymptote.texi.
-This file documents `Asymptote', version 1.77.
+This file documents `Asymptote', version 1.88.
`http://asymptote.sourceforge.net'
@@ -23,7 +23,7 @@ File: asymptote.info, Node: Top, Next: Description, Up: (dir)
Asymptote
*********
-This file documents `Asymptote', version 1.77.
+This file documents `Asymptote', version 1.88.
`http://asymptote.sourceforge.net'
@@ -40,6 +40,7 @@ This file documents `Asymptote', version 1.77.
* Installation:: Downloading and installing
* Tutorial:: Getting started
* Drawing commands:: Four primitive graphics commands
+* Bezier curves:: Path connectors and direction specifiers
* Programming:: The `Asymptote' vector graphics language
* LaTeX usage:: Embedding `Asymptote' commands within `LaTeX'
* Base modules:: Base modules shipped with `Asymptote'
@@ -153,8 +154,8 @@ Base modules
Graphical User Interface
-* GUI Installation:: Installing `xasy'
-* GUI Usage::
+* GUI installation:: Installing `xasy'
+* GUI usage::

File: asymptote.info, Node: Description, Next: Installation, Prev: Top, Up: Top
@@ -195,6 +196,9 @@ weaker syntax and capabilities) called `MetaPost'.
* `LaTeX' typesetting of labels, for overall document consistency;
+ * the ability to generate and embed 3D vector PRC graphics within
+ PDF files;
+
* a natural coordinate-based framework for technical drawings,
inspired by `MetaPost', with a much cleaner, powerful C++-like
programming syntax;
@@ -260,7 +264,7 @@ We recommend subscribing to new release announcements at
`http://freshmeat.net/projects/asy'
Users may also wish to monitor the `Asymptote' forum:
- `http://sourceforge.net/forum/monitor.php?forum_id=409349'
+ `http://sourceforge.net/projects/asymptote/forums/forum/409349'

File: asymptote.info, Node: UNIX binary distributions, Next: MacOS X binary distributions, Up: Installation
@@ -308,10 +312,9 @@ source:
`http://sourceforge.net/project/showfiles.php?group_id=120000'
-Note that many `MacOS X' (and FreeBSD) systems inexplicably ship with
-an extremely old GNU `readline' version (4.1, dated 21 March 2000). For
-full interactive functionality, `readline' version 4.2 or later (16
-April 2001) is required.
+Note that many `MacOS X' (and FreeBSD) systems lack the GNU `readline'
+library. For full interactive functionality, GNU `readline' version 4.3
+or later must be installed.

File: asymptote.info, Node: Microsoft Windows, Next: Configuring, Prev: MacOS X binary distributions, Up: Installation
@@ -326,9 +329,19 @@ where `x.xx' denotes the latest version.
A working TeX implementation (such as the one available at
`http://www.miktex.org') will be required to typeset labels. You will
also need to install `GPL Ghostscript' from
-`http://sourceforge.net/projects/ghostscript/'. To view the default
-`PostScript' output, you can install the program `gsview' available from
-`http://www.cs.wisc.edu/~ghost/gsview/'.
+`http://sourceforge.net/projects/ghostscript/'.
+
+ To view the default `PostScript' output, you can install the program
+`gsview' available from `http://www.cs.wisc.edu/~ghost/gsview/'. A
+better (and free) `PostScript' viewer available at
+`http://psview.sourceforge.net/' (which in particular works properly in
+interactive mode) unfortunately currently requires some manual
+configuration. Specifically, if version `x.xx' of `psview' is extracted
+to the directory `c:\Program Files' one needs to put
+import settings;
+psviewer="c:\Program Files\psview-x.xx\psv.exe";
+ in the optional `Asymptote' configuration file; *note configuration
+file::).
The `ImageMagick' package from
@@ -362,24 +375,26 @@ interactive mode to work properly. Users of `ggv' will need to enable
`Watch file' under `Edit/Postscript Viewer Preferences'. Users of
`gsview' will need to enable `Options/Auto Redisplay' (however, under
`MSDOS' it is still necessary to click on the `gsview' window; under
-`UNIX' one must manually redisplay by pressing the `r' key).
+`UNIX' one must manually redisplay by pressing the `r' key). A better
+(and free) multiplatform alternative to `gsview' is `psview' (*note
+psview::).
Configuration variables are most easily set as `Asymptote' variables
-in an optional configuration file (by default, `.asy/config.asy' in the
-user's home directory or `%USERPROFILE%\.asy\config.asy' under
-`MSDOS'); *note configuration file::. Here are the default values of
-several important configuration variables under `UNIX':
+in an optional configuration file `config.asy' *note configuration
+file::). Here are the default values of several important configuration
+variables under `UNIX':
import settings;
psviewer="gv";
pdfviewer="acroread";
gs="gs";
-python="";
-The (installation-dependent) default values of these configuration
-variables under `MSDOS' are determined automatically from the
-`Microsoft Windows' registry.
+Under `MSDOS', the (installation-dependent) default values of these
+configuration variables are determined automatically from the
+`Microsoft Windows' registry. Viewer settings (such as `psviewer' and
+`pdfviewer') can be set to the string `cmd' to request the application
+normally associated with the corresponding file type.
For PDF format output, the `gs' setting specifies the location of
the `PostScript'-to-PDF processor `Ghostscript', available from
@@ -399,9 +414,6 @@ pdfreloadOptions="-tempFile";
useful under `MSDOS' since the document cannot be updated anyway on
that operating system until it is first closed by `Adobe Reader'.
- The graphical user interface may also require setting the variable
-`python' if `Python' is installed in a nonstandard location.
-
The configuration variable `dir' can be used to adjust the search
path (*note Search paths::).
@@ -415,15 +427,17 @@ variables `paperwidth' and `paperheight'.
adjustment:
texpath
texcommand
-texdvicommand
dvips
+dvisvg
convert
display
animate
-xasy
- The `texdvicommand' is used for `3D' label typesetting, which requires
-`dvips' output. An empty string indicates the default setting of
-`latex'/`tex', depending on the setting of `texengine'.
+ Warnings (such as "writeoverloaded") may be enabled or disabled with
+the functions
+warn(string s);
+nowarn(string s);
+ or by directly modifying the string array `settings.suppress', which
+lists all disabled warnings.
Configuration variables may also be set or overwritten with a
command-line option:
@@ -459,8 +473,10 @@ following paths, in the order listed:
2. A list of one or more directories specified by the configuration
variable `dir' (separated by `:' under UNIX and `;' under `MSDOS');
- 3. The directory `.asy' in the user's home directory
- (`%USERPROFILE%\.asy' under `MSDOS');
+ 3. The directory specified by the environment variable
+ `ASYMPTOTE_HOME'; if this variable is not set, the directory
+ `.asy' in the user's home directory (`%USERPROFILE%\.asy' under
+ `MSDOS') is used;
4. The `Asymptote' system directory (by default,
`/usr/local/share/asymptote' under `UNIX' and `C:\Program
@@ -482,17 +498,16 @@ used; if it is old we recommend first putting
`http://www.hpl.hp.com/personal/Hans_Boehm/gc/gc_source/gc-7.1.tar.gz'
in the `Asymptote' source directory.
-If your graphics card supports multisampling, we recommend using SVN
-revision 761 (or later) of `freeglut' to support antialiasing in
+If your graphics card supports multisampling, we recommend using version
+`2.6.0-rc1' (or later) of `freeglut' to support antialiasing in
`Asymptote''s adaptive `OpenGL' 3D renderer (`MacOS X' users can skip
this step since `Asymptote' is configured to use the native glut
library on that platform). Download
- `http://freeglut.svn.sourceforge.net/viewvc/freeglut/trunk/freeglut/freeglut.tar.gz'
+ `http://prdownloads.sourceforge.net/freeglut/freeglut-2.6.0-rc1.tar.gz'
and type (as the root user):
-tar -zxf freeglut.tar.gz
-cd freeglut
-sh autogen.sh
+tar -zxf freeglut-2.6.0-rc1.tar.gz
+cd freeglut-2.6.0
./configure --prefix=/usr
make install
cd ..
@@ -520,7 +535,7 @@ for header files and libraries in nonstandard locations:
If you are compiling `Asymptote' with `gcc', you will need a
relatively recent version (e.g. 3.4.4 or later). For full interactive
-functionality, you will need version 4.2 or later of the GNU `readline'
+functionality, you will need version 4.3 or later of the GNU `readline'
library. The file `gcc3.3.2curses.patch' in the `patches' directory can
be used to patch the broken curses.h header file (or a local copy
thereof in the current directory) on some `AIX' and `IRIX' systems.
@@ -584,6 +599,11 @@ add to `~/.vim/ftplugin/asy.vim':
setlocal makeprg=asy\ %
setlocal errorformat=%f:\ %l.%c:\ %m
+ Syntax highlighting support for the KDE editor `Kate' can be enabled
+by running `asy-kate.sh' in the `/usr/local/share/asymptote' directory
+and putting the generated `asymptote.xml' file in
+`~/.kde/share/apps/katepart/syntax/'.
+

File: asymptote.info, Node: Subversion, Next: Uninstall, Prev: Editing modes, Up: Installation
@@ -591,7 +611,7 @@ File: asymptote.info, Node: Subversion, Next: Uninstall, Prev: Editing modes,
====================
The following commands are needed to install the latest development
-version of `Asymptote' using Subversion:
+version of `Asymptote' using `Subversion':
svn co http://asymptote.svn.sourceforge.net/svnroot/asymptote/trunk/asymptote
cd asymptote
./autogen.sh
@@ -621,86 +641,96 @@ File: asymptote.info, Node: Tutorial, Next: Drawing commands, Prev: Installat
3 Tutorial
**********
-_An excellent user-written `Asymptote' tutorial is also available from_
+3.1 Drawing in batch mode
+=========================
- `http://www.artofproblemsolving.com/Wiki/index.php/Asymptote:_Basics'
+To draw a line from coordinate (0,0) to coordinate (100,100), create a
+text file `test.asy' containing
-To draw a line from coordinate (0,0) to coordinate (100,100) using
-`Asymptote''s interactive mode, type at the command prompt:
-asy
draw((0,0)--(100,100));
+ Then execute the command
+asy -V test
+ Alternatively, `MSDOS' users can drag and drop `test.asy' onto the
+Desktop `asy' icon (or make `Asymptote' the default application for the
+extension `asy').
+This method, known as _batch mode_, outputs a `PostScript' file
+`test.eps'. The `-V' option opens up a `PostScript' viewer window so
+you can immediately view the result:
-The units here are `PostScript' "big points" (1 `bp' = 1/72 `inch');
-`--' means join with a linear segment. In `Asymptote' coordinates like
-`(0,0)' and `(1000,100)' are called _pairs_.
-
- At this point you can type in further draw commands, which will be
-added to the displayed figure, or type `quit' to exit interactive mode.
-You can use the arrow keys in interactive mode to edit previous lines
-(assuming that you have support for the GNU `readline' library
-enabled). The tab key will automatically complete unambiguous words;
-otherwise, hitting tab again will show the possible choices. Further
-commands specific to interactive mode are described in *note
-Interactive mode::.
+The `--' connector joins the two points `(0,0)' and `(100,100)' with a
+line segment.
- In batch mode, `Asymptote' reads commands directly from a file. To
-try this out, type
+3.2 Drawing in interactive mode
+===============================
+Another method is _interactive mode_, where `Asymptote' reads
+individual commands as they are entered by the user. To try this out,
+enter `Asymptote''s interactive mode by clicking on the `Asymptote'
+icon or typing the command `asy'. Then type
draw((0,0)--(100,100));
- into a file, say test.asy. Then execute this file with the `MSDOS' or
-`UNIX' command
-asy -V test
- `MSDOS' users can drag and drop the file onto the Desktop `asy' icon
-or make `Asymptote' the default application for files with the
-extension `asy'.
+ followed by `Enter', to obtain the above image. At this point you can
+type further `draw' commands, which will be added to the displayed
+figure, `erase' to clear the canvas,
+input test;
+ to execute all of the commands contained in the file `test.asy', or
+`quit' to exit interactive mode. You can use the arrow keys in
+interactive mode to edit previous lines. The tab key will
+automatically complete unambiguous words; otherwise, hitting tab again
+will show the possible choices. Further commands specific to
+interactive mode are described in *note Interactive mode::.
+
+3.3 Figure size
+===============
-The `-V' option opens up a `PostScript' viewer window so you can
-immediately view the encapsulated `PostScript' output. By default the
-output will be written to the file `test.eps'; the prefix of the output
-file may be changed with the `-o' command-line option.
+In `Asymptote', coordinates like `(0,0)' and `(100,100)', called
+_pairs_, are expressed in `PostScript' "big points" (1 `bp' = 1/72
+`inch') and the default line width is `0.5bp'. However, it is often
+inconvenient to work directly in `PostScript' coordinates. The next
+example produces identical output to the previous example, by scaling
+the line `(0,0)--(1,1)' to fit a rectangle of width `100.5 bp' and
+height `100.5 bp' (the extra `0.5bp' accounts for the line width):
+size(100.5,100.5);
+draw((0,0)--(1,1));
- One can draw a line with more than two points and create a cyclic
-path like this square:
-draw((0,0)--(100,0)--(100,100)--(0,100)--cycle);
+One can also specify the size in `pt' (1 `pt' = 1/72.27 `inch'), `cm',
+`mm', or `inches'. Two nonzero size arguments (or a single size
+argument) restrict the size in both directions, preserving the aspect
+ratio. If 0 is given as a size argument, no restriction is made in
+that direction; the overall scaling will be determined by the other
+direction (*note size::):
+size(0,100.5);
+draw((0,0)--(2,1),Arrow);
-It is often inconvenient to work directly with `PostScript' coordinates.
-The next example draws a unit square scaled to width 101 bp and height
-101 bp. The output is identical to that of the previous example.
-size(101,101);
-draw((0,0)--(1,0)--(1,1)--(0,1)--cycle);
- For convenience, the path `(0,0)--(1,0)--(1,1)--(0,1)--cycle' may be
-replaced with the predefined variable `unitsquare', or equivalently,
-`box((0,0),(1,1))'.
- One can also specify the size in `pt' (1 `pt' = 1/72.27 `inch'),
-`cm', `mm', or `inches'. If 0 is given as a size argument, no
-restriction is made in that direction; the overall scaling will be
-determined by the other direction (*note size::):
+To connect several points and create a cyclic path, use the `cycle'
+keyword:
-size(0,3cm);
-draw(unitsquare);
+size(100,100);
+draw((0,0)--(1,0)--(1,1)--(0,1)--cycle);
+For convenience, the path `(0,0)--(1,0)--(1,1)--(0,1)--cycle' may be
+replaced with the predefined variable `unitsquare', or equivalently,
+`box((0,0),(1,1))'.
-To make the user coordinates represent multiples of exactly `1cm':
+ To make the user coordinates represent multiples of exactly `1cm':
unitsize(1cm);
draw(unitsquare);
- One can also specify different x and y unit sizes:
-unitsize(1cm,2cm);
-draw(unitsquare);
+3.4 Labels
+==========
- Adding labels is easy in `Asymptote'; one specifies the label as a
+Adding labels is easy in `Asymptote'; one specifies the label as a
double-quoted `LaTeX' string, a coordinate, and an optional alignment
direction:
-size(0,3cm);
+size(3cm);
draw(unitsquare);
label("$A$",(0,0),SW);
label("$B$",(1,0),SE);
@@ -712,107 +742,32 @@ label("$D$",(0,1),NW);
`Asymptote' uses the standard compass directions `E=(1,0)', `N=(0,1)',
`NE=unit(N+E)', and `ENE=unit(E+NE)', etc., which along with the
directions `up', `down', `right', and `left' are defined as pairs in
-the `Asymptote' base module `plain'. A user who has a local variable
+the `Asymptote' base module `plain' (a user who has a local variable
named `E' may access the compass direction `E' by prefixing it with the
-name of the module where it is defined: `plain.E'.
+name of the module where it is defined: `plain.E').
- This example draws a path that approximates a quarter circle:
+3.5 Paths
+=========
+
+This example draws a path that approximates a quarter circle,
+terminated with an arrowhead:
size(100,0);
-draw((1,0){up}..{left}(0,1));
+draw((1,0){up}..{left}(0,1),Arrow);
+Here the directions `up' and `left' in braces specify the incoming and
+outgoing directions at the points `(1,0)' and `(0,1)', respectively.
-In general, a path is specified as a list of pairs (or other paths)
+ In general, a path is specified as a list of points (or other paths)
interconnected with `--', which denotes a straight line segment, or
-`..', which denotes a cubic spline. Specifying a final node `cycle'
-creates a cyclic path that connects smoothly back to the initial node,
-as in this approximation (accurate to within 0.06%) of a unit circle:
+`..', which denotes a cubic spline (*note Bezier curves::). Specifying
+a final `..cycle' creates a cyclic path that connects smoothly back to
+the initial node, as in this approximation (accurate to within 0.06%)
+of a unit circle:
path unitcircle=E..N..W..S..cycle;
- Each interior node of a cubic spline may be given a direction prefix
-or suffix `{dir}': the direction of the pair `dir' specifies the
-direction of the incoming or outgoing tangent, respectively, to the
-curve at that node. Exterior nodes may be given direction specifiers
-only on their interior side.
-
- A cubic spline between the node z_0, with postcontrol point c_0, and
-the node z_1, with precontrol point c_1, is computed as the Bezier curve
-
-
-
-As illustrated in the diagram below, the third-order midpoint (m_5)
-constructed from two endpoints z_0 and z_1 and two control points c_0
-and c_1, is the point corresponding to t=1/2 on the Bezier curve formed
-by the quadruple (z_0, c_0, c_1, z_1). This allows one to recursively
-construct the desired curve, by using the newly extracted third-order
-midpoint as an endpoint and the respective second- and first-order
-midpoints as control points:
-
-
-
-Here m_0, m_1 and m_2 are the first-order midpoints, m_3 and m_4 are
-the second-order midpoints, and m_5 is the third-order midpoint. The
-curve is then constructed by recursively applying the algorithm to
-(z_0, m_0, m_3, m_5) and (m_5, m_4, m_2, z_1).
-
- In fact, an analogous property holds for points located at any
-fraction t in [0,1] of each segment, not just for midpoints (t=1/2).
-
- The Bezier curve constructed in this manner has the following
-properties:
- * It is entirely contained in the convex hull of the given four
- points.
-
- * It starts heading from the first endpoint to the first control
- point and finishes heading from the second control point to the
- second endpoint.
-
-
- The user can specify explicit control points between two nodes like
-this:
-draw((0,0)..controls (0,100) and (100,100)..(100,0));
-
- However, it is usually more convenient to just use the `..'
-operator, which tells `Asymptote' to choose its own control points
-using the algorithms described in Donald Knuth's monograph, The
-MetaFontbook, Chapter 14. The user can still customize the guide (or
-path) by specifying direction, tension, and curl values.
-
- The higher the tension, the straighter the curve is, and the more it
-approximates a straight line. One can change the spline tension from
-its default value of 1 to any real value greater than or equal to 0.75
-(cf. John D. Hobby, Discrete and Computational Geometry 1, 1986):
-draw((100,0)..tension 2 ..(100,100)..(0,100));
-draw((100,0)..tension 2 and 1 ..(100,100)..(0,100));
-draw((100,0)..tension atleast 1 ..(100,100)..(0,100));
-
- The curl parameter specifies the curvature at the endpoints of a path
-(0 means straight; the default value of 1 means approximately circular):
-draw((100,0){curl 0}..(100,100)..{curl 0}(0,100));
-
- The `MetaPost ...' path connector, which requests, when possible, an
-inflection-free curve confined to a triangle defined by the endpoints
-and directions, is implemented in `Asymptote' as the convenient
-abbreviation `::' for `..tension atleast 1 ..' (the ellipsis `...' is
-used in `Asymptote' to indicate a variable number of arguments; *note
-Rest arguments::). For example, compare
-
-draw((0,0){up}..(100,25){right}..(200,0){down});
-
-
-with
-
-draw((0,0){up}::(100,25){right}::(200,0){down});
-
-
-
-The `---' connector is an abbreviation for `..tension atleast
-infinity..' and the `&' connector concatenates two paths, after first
-stripping off the last node of the first path (which normally should
-coincide with the first node of the second path).
-
- An `Asymptote' path, being connected, is equivalent to a `Postscript
+An `Asymptote' path, being connected, is equivalent to a `Postscript
subpath'. The `^^' binary operator, which requests that the pen be
moved (without drawing or affecting endpoint curvatures) from the final
point of the left-hand path to the initial point of the right-hand
@@ -834,8 +789,8 @@ orientation of the paths:
filldraw(unitcircle^^reverse(g),yellow,black);
The `^^' operator is used by the `box(triple, triple)' function in
-`three.asy' to construct the edges of a cube `unitbox' without
-retracing steps:
+the module `three.asy' to construct the edges of a cube `unitbox'
+without retracing steps (*note three::):
import three;
dotgranularity=0; // Render dots as spheres.
@@ -858,12 +813,14 @@ label("(0,0,1)",(0,0,1),Z);
See section *note graph:: (or the online `Asymptote' gallery and
external links posted at `http://asymptote.sourceforge.net') for
-further examples, including two and three-dimensional scientific
-graphs. Additional examples have been posted by Philippe Ivaldi at
-`http://piprim.tuxfamily.org/asymptote/'.
+further examples, including two-dimensional and interactive
+three-dimensional scientific graphs. Additional examples have been
+posted by Philippe Ivaldi at `http://www.piprime.fr/asymptote'. A
+user-written `Asymptote' tutorial is available at
+http://www.artofproblemsolving.com/Wiki/index.php/Asymptote:_Basics

-File: asymptote.info, Node: Drawing commands, Next: Programming, Prev: Tutorial, Up: Top
+File: asymptote.info, Node: Drawing commands, Next: Bezier curves, Prev: Tutorial, Up: Top
4 Drawing commands
******************
@@ -935,12 +892,12 @@ arrowhead styles `DefaultHead', `SimpleHead', `HookHead', `TeXHead'),
real `size' (arrowhead size in `PostScript' coordinates), real `angle'
(arrowhead angle in degrees), filltype `filltype' (one of `FillDraw',
`Fill', `NoFill', `UnFill', `Draw') and (except for `MidArrow' and
-`Arrows') a relative real `position' along the path (an `arctime') where
-the tip of the arrow should be placed. The default arrowhead size when
-drawn with a pen `p' is `arrowsize(p)'. There are also arrow versions
-with slightly modified default values of `size' and `angle' suitable for
-curved arrows: `BeginArcArrow', `EndArcArrow' (or equivalently
-`ArcArrow'), `MidArcArrow', and `ArcArrows'.
+`Arrows') a real `position' (in the sense of `point(path p, real t)')
+along the path where the tip of the arrow should be placed. The default
+arrowhead size when drawn with a pen `p' is `arrowsize(p)'. There are
+also arrow versions with slightly modified default values of `size' and
+`angle' suitable for curved arrows: `BeginArcArrow', `EndArcArrow' (or
+equivalently `ArcArrow'), `MidArcArrow', and `ArcArrows'.
Margins can be used to shrink the visible portion of a path by
`labelmargin(p)' to avoid overlap with other drawn objects. Typical
@@ -1195,11 +1152,11 @@ Label should transform with the embedding picture:
void label(picture pic=currentpicture, Label L, path g, align align=NoAlign,
pen p=nullpen, filltype filltype=NoFill);
By default the label will be positioned at the midpoint of the path.
-An alternative label location (an `arctime' value between 0 and
-`length(g)' *note arctime::) may be specified as real value for
-`position' in constructing the Label. The position `Relative(real)'
-specifies a location relative to the total arclength of the path. These
-convenient abbreviations are predefined:
+An alternative label position (in the sense of `point(path p, real t)')
+may be specified as a real value for `position' in constructing the
+Label. The position `Relative(real)' specifies a location relative to
+the total arclength of the path. These convenient abbreviations are
+predefined:
position BeginPoint=Relative(0);
position MidPoint=Relative(0.5);
position EndPoint=Relative(1);
@@ -1282,9 +1239,97 @@ label(graphic("logo."+nativeformat(),"height=7cm"),(0,-0.22));
clip(unitcircle^^(scale(2/11.7)*unitcircle),evenodd);

-File: asymptote.info, Node: Programming, Next: LaTeX usage, Prev: Drawing commands, Up: Top
+File: asymptote.info, Node: Bezier curves, Next: Programming, Prev: Drawing commands, Up: Top
+
+5 Bezier curves
+***************
+
+Each interior node of a cubic spline may be given a direction prefix or
+suffix `{dir}': the direction of the pair `dir' specifies the direction
+of the incoming or outgoing tangent, respectively, to the curve at that
+node. Exterior nodes may be given direction specifiers only on their
+interior side.
+
+ A cubic spline between the node z_0, with postcontrol point c_0, and
+the node z_1, with precontrol point c_1, is computed as the Bezier curve
+
+
+
+As illustrated in the diagram below, the third-order midpoint (m_5)
+constructed from two endpoints z_0 and z_1 and two control points c_0
+and c_1, is the point corresponding to t=1/2 on the Bezier curve formed
+by the quadruple (z_0, c_0, c_1, z_1). This allows one to recursively
+construct the desired curve, by using the newly extracted third-order
+midpoint as an endpoint and the respective second- and first-order
+midpoints as control points:
+
+
+
+Here m_0, m_1 and m_2 are the first-order midpoints, m_3 and m_4 are
+the second-order midpoints, and m_5 is the third-order midpoint. The
+curve is then constructed by recursively applying the algorithm to
+(z_0, m_0, m_3, m_5) and (m_5, m_4, m_2, z_1).
+
+ In fact, an analogous property holds for points located at any
+fraction t in [0,1] of each segment, not just for midpoints (t=1/2).
+
+ The Bezier curve constructed in this manner has the following
+properties:
+ * It is entirely contained in the convex hull of the given four
+ points.
+
+ * It starts heading from the first endpoint to the first control
+ point and finishes heading from the second control point to the
+ second endpoint.
+
+
+ The user can specify explicit control points between two nodes like
+this:
+draw((0,0)..controls (0,100) and (100,100)..(100,0));
+
+ However, it is usually more convenient to just use the `..'
+operator, which tells `Asymptote' to choose its own control points
+using the algorithms described in Donald Knuth's monograph, The
+MetaFontbook, Chapter 14. The user can still customize the guide (or
+path) by specifying direction, tension, and curl values.
+
+ The higher the tension, the straighter the curve is, and the more it
+approximates a straight line. One can change the spline tension from
+its default value of 1 to any real value greater than or equal to 0.75
+(cf. John D. Hobby, Discrete and Computational Geometry 1, 1986):
+draw((100,0)..tension 2 ..(100,100)..(0,100));
+draw((100,0)..tension 2 and 1 ..(100,100)..(0,100));
+draw((100,0)..tension atleast 1 ..(100,100)..(0,100));
+
+ The curl parameter specifies the curvature at the endpoints of a path
+(0 means straight; the default value of 1 means approximately circular):
+draw((100,0){curl 0}..(100,100)..{curl 0}(0,100));
+
+ The `MetaPost ...' path connector, which requests, when possible, an
+inflection-free curve confined to a triangle defined by the endpoints
+and directions, is implemented in `Asymptote' as the convenient
+abbreviation `::' for `..tension atleast 1 ..' (the ellipsis `...' is
+used in `Asymptote' to indicate a variable number of arguments; *note
+Rest arguments::). For example, compare
+
+draw((0,0){up}..(100,25){right}..(200,0){down});
+
+
+with
+
+draw((0,0){up}::(100,25){right}::(200,0){down});
+
+
+
+The `---' connector is an abbreviation for `..tension atleast
+infinity..' and the `&' connector concatenates two paths, after first
+stripping off the last node of the first path (which normally should
+coincide with the first node of the second path).
+
+
+File: asymptote.info, Node: Programming, Next: LaTeX usage, Prev: Bezier curves, Up: Top
-5 Programming
+6 Programming
*************
Here is a short introductory example to the `Asymptote' programming
@@ -1343,7 +1388,7 @@ languages.

File: asymptote.info, Node: Data types, Next: Paths and guides, Up: Programming
-5.1 Data types
+6.1 Data types
==============
`Asymptote' supports the following data types (in addition to
@@ -1601,7 +1646,7 @@ user-defined types):
string pairs {`before',`after'} to the corresponding string
`after';
- `string[] split(string s, string delimiter)'
+ `string[] split(string s, string delimiter=" ")'
returns an array of strings obtained by splitting `s' into
substrings delimited by `delimiter';
@@ -1686,7 +1731,7 @@ user-defined types):

File: asymptote.info, Node: Paths and guides, Next: Pens, Prev: Data types, Up: Programming
-5.2 Paths and guides
+6.2 Paths and guides
====================
`path'
@@ -1722,14 +1767,13 @@ File: asymptote.info, Node: Paths and guides, Next: Pens, Prev: Data types,
path Arc(pair c, explicit pair z1, explicit pair z2,
bool direction=CCW, int n=nCircle);
- An ellipse can be drawn with the routine @cindex @code{ellipse}
- path ellipse(pair c, real a, real b)
+ An ellipse can be drawn with the routine path ellipse(pair c, real a, real b)
{
return shift(c)*scale(a,b)*unitcircle;
}
This example illustrates the use of all five guide connectors
- discussed in *note Tutorial::: size(300,0);
+ discussed in *note Tutorial:: and *note Bezier curves::: size(300,0);
pair[] z=new pair[10];
z[0]=(0,100); z[1]=(50,0); z[2]=(180,0);
@@ -1777,8 +1821,8 @@ File: asymptote.info, Node: Paths and guides, Next: Pens, Prev: Data types,
`pair point(path p, real t);'
This returns the coordinates of the point between node
`floor(t)' and `floor(t)+1' corresponding to the cubic spline
- parameter `t-floor(t)' (*note Bezier::). If `t' lies outside
- the range [0,`length(p)'], it is first reduced modulo
+ parameter `t-floor(t)' (*note Bezier curves::). If `t' lies
+ outside the range [0,`length(p)'], it is first reduced modulo
`length(p)' in the case where `p' is cyclic or else converted
to the corresponding endpoint of `p'.
@@ -1791,7 +1835,7 @@ File: asymptote.info, Node: Paths and guides, Next: Pens, Prev: Data types,
`pair dir(path p, real t, bool normalize=true);'
returns the direction of the tangent to path `p' at the point
between node `floor(t)' and `floor(t)+1' corresponding to the
- cubic spline parameter `t-floor(t)' (*note Bezier::).
+ cubic spline parameter `t-floor(t)' (*note Bezier curves::).
`pair accel(path p, int t, int sign=0);'
If `sign < 0', return the acceleration of the incoming path
@@ -1802,7 +1846,7 @@ File: asymptote.info, Node: Paths and guides, Next: Pens, Prev: Data types,
`pair accel(path p, real t);'
returns the acceleration of the path `p' at the point `t'.
- `pair radius(path p, real t);'
+ `real radius(path p, real t);'
returns the radius of curvature of the path `p' at the point
`t'.
@@ -2088,7 +2132,7 @@ File: asymptote.info, Node: Paths and guides, Next: Pens, Prev: Data types,

File: asymptote.info, Node: Pens, Next: Transforms, Prev: Paths and guides, Up: Programming
-5.3 Pens
+6.3 Pens
========
In `Asymptote', pens provide a context for the four basic drawing
@@ -2197,8 +2241,9 @@ number, until it saturates with one or more color components equal to 1.
The default line type is `solid'; this may be changed with
- `defaultpen(pen)'. The line type of a pen is returned by `int
- linetype(pen p=currentpen)'.
+ `defaultpen(pen)'. The line type of a pen can be determined with
+ the functions `string linetype(pen p=currentpen)', `real
+ offset(pen p)', `bool scale(pen p)', and `bool adjust(pen p)'.
* The pen line width is specified in `PostScript' units with `pen
linewidth(real)'. The default line width is 0.5 bp; this value may
@@ -2441,7 +2486,7 @@ default attributes to their initial values.

File: asymptote.info, Node: Transforms, Next: Frames and pictures, Prev: Pens, Up: Programming
-5.4 Transforms
+6.4 Transforms
==============
`Asymptote' makes extensive use of affine transforms. A pair `(x,y)' is
@@ -2499,7 +2544,7 @@ respectively.

File: asymptote.info, Node: Frames and pictures, Next: Files, Prev: Transforms, Up: Programming
-5.5 Frames and pictures
+6.5 Frames and pictures
=======================
`frame'
@@ -2583,7 +2628,7 @@ File: asymptote.info, Node: Frames and pictures, Next: Files, Prev: Transform
orientation orientation=orientation,
string format="", bool wait=false, bool view=true,
string options="", string script="",
- projection P=currentprojection);
+ light light=currentlight, projection P=currentprojection)
The default output format, `PostScript', may be changed with the
`-f' or `-tex' command-line options. The `options', `script', and
`projection' parameters are only relevant for 3D pictures. If
@@ -2662,16 +2707,16 @@ File: asymptote.info, Node: Frames and pictures, Next: Files, Prev: Transform
For example, to draw a bounding box around a picture with a 0.25 cm
margin and output the resulting frame, use the command: shipout(bbox(0.25cm));
- A `picture' may be fit to a frame with the background color of
- pen `p' with the function `bbox(p,Fill)'.
+ A `picture' may be fit to a frame with the background color pen
+ `p', using the function `bbox(p,Fill)'.
The functions pair min(picture pic, user=false);
pair max(picture pic, user=false);
pair size(picture pic, user=false);
- calculate the `PostScript' bounds that picture `pic' would have
- if it were currently fit to a frame using its default size
- specification. If `user' is `false' the returned value is in
- `PostScript' coordinates, otherwise it is in user coordinates.
+ calculate the bounds that picture `pic' would have if it were
+ currently fit to a frame using its default size specification. If
+ `user' is `false' the returned value is in `PostScript'
+ coordinates, otherwise it is in user coordinates.
The function pair point(picture pic=currentpicture, pair dir, bool user=true);
is a convenient way of determining the point on the bounding box
@@ -2791,7 +2836,7 @@ File: asymptote.info, Node: Frames and pictures, Next: Files, Prev: Transform

File: asymptote.info, Node: Files, Next: Variable initializers, Prev: Frames and pictures, Up: Programming
-5.6 Files
+6.6 Files
=========
`Asymptote' can read and write text files (including comma-separated
@@ -2860,19 +2905,22 @@ write(fout,1); // Writes "1"
write(fout); // Writes a new line
write(fout,"List: ",1,2,3); // Writes "List: 1 2 3"
A file may also be opened with `xinput' or `xoutput', instead of
-`input' or `output', to read or write double precision (64-bit) real
-values and single precision (32-bit) integer values in Sun
-Microsystem's XDR (External Data Representation) portable binary format
-(available on all `UNIX' platforms). A file may also be opened with
-`binput' or `boutput' to read or write double precision values in the
-native (nonportable) machine binary format. The function `file
-single(file,0.0)' may be used to set a file to read single precision
-real XDR or binary values; calling `file single(file,0.0,false)' sets
-it back to read doubles again. The functions `file single(file,0)' and
-`file single(file,0,false)' can be used to change the default integer
-precision (single). The functions `file single(file)' and `file
-single(file,false)' may be used to set the precision for both real and
-integer values.
+`input' or `output', to read or write double precision (64-bit) reals
+and single precision (32-bit) integers in Sun Microsystem's XDR
+(External Data Representation) portable binary format (available on all
+`UNIX' platforms). Alternatively, a file may also be opened with
+`binput' or `boutput' to read or write double precision reals and single
+precision integers in the native (nonportable) machine binary format.
+The virtual member functions `file singlereal(bool b=false)' and `file
+singleint(bool b=true)' be used to change the precision of real and
+integer I/O operations, respectively, for an XDR or binary file `f'.
+Similarly, the function `file signedint(bool b=true)' can be used to
+modify the signedness of integer reads and writes for an XDR or binary
+file `f'.
+
+ The virtual members `name', `mode', `singlereal', `singleint', and
+`signedint' may be used to query the respective parameters for a given
+file.
One can test a file for end-of-file with the boolean function
`eof(file)', end-of-line with `eol(file)', and for I/O errors with
@@ -2942,13 +2990,13 @@ int animate(string args="", string file="", string format="");
call the `ImageMagick' commands `convert' and `animate', respectively,
with the arguments `args' and the file name constructed from the
strings `file' and `format'. If the setting `safe' is false, then the
-function `int system(string s)' can be used to call the arbitrary system
-command `s'.
+functions `int system(string s)' and `int system(string[] s)' can be
+used to call the arbitrary system command `s'.

File: asymptote.info, Node: Variable initializers, Next: Structures, Prev: Files, Up: Programming
-5.7 Variable initializers
+6.7 Variable initializers
=========================
A variable can be assigned a value when it is declared, as in `int
@@ -3013,7 +3061,7 @@ sensible defaults for user-defined types.

File: asymptote.info, Node: Structures, Next: Operators, Prev: Variable initializers, Up: Programming
-5.8 Structures
+6.8 Structures
==============
Users may also define their own data types as structures, along with
@@ -3202,8 +3250,9 @@ and the total system cputime followed by "S".
Much like in C++, casting (*note Casts::) provides for an elegant
implementation of structure inheritance, including virtual functions:
struct parent {
- real x=1;
- void virtual(int) {write (0);}
+ real x;
+ void operator init(int x) {this.x=x;}
+ void virtual(int) {write(0);}
void f() {virtual(1);}
}
@@ -3211,24 +3260,25 @@ void write(parent p) {write(p.x);}
struct child {
parent parent;
- real y=2;
- void virtual(int x) {write (x);}
+ real y=3;
+ void operator init(int x) {parent.operator init(x);}
+ void virtual(int x) {write(x);}
parent.virtual=virtual;
void f()=parent.f;
}
parent operator cast(child child) {return child.parent;}
-parent p;
-child c;
+parent p=parent(1);
+child c=child(2);
-write(c); // Outputs 1;
+write(c); // Outputs 2;
p.f(); // Outputs 0;
c.f(); // Outputs 1;
-write(c.parent.x); // Outputs 1;
-write(c.y); // Outputs 2;
+write(c.parent.x); // Outputs 2;
+write(c.y); // Outputs 3;
For further examples of structures, see `Legend' and `picture' in
the `Asymptote' base module `plain'.
@@ -3236,7 +3286,7 @@ the `Asymptote' base module `plain'.

File: asymptote.info, Node: Operators, Next: Implicit scaling, Prev: Structures, Up: Programming
-5.9 Operators
+6.9 Operators
=============
* Menu:
@@ -3248,7 +3298,7 @@ File: asymptote.info, Node: Operators, Next: Implicit scaling, Prev: Structur

File: asymptote.info, Node: Arithmetic & logical, Next: Self & prefix operators, Up: Operators
-5.9.1 Arithmetic & logical operators
+6.9.1 Arithmetic & logical operators
------------------------------------
`Asymptote' uses the standard binary arithmetic operators. However,
@@ -3331,7 +3381,7 @@ OR(int,int)', `int XOR(int,int)', and `int NOT(int)'.

File: asymptote.info, Node: Self & prefix operators, Next: User-defined operators, Prev: Arithmetic & logical, Up: Operators
-5.9.2 Self & prefix operators
+6.9.2 Self & prefix operators
-----------------------------
As in C, each of the arithmetic operators `+', `-', `*', `/', `%', and
@@ -3356,7 +3406,7 @@ really needed, one can substitute the expressions `(++i-1)' and

File: asymptote.info, Node: User-defined operators, Prev: Self & prefix operators, Up: Operators
-5.9.3 User-defined operators
+6.9.3 User-defined operators
----------------------------
The following symbols may be used with `operator' to define or redefine
@@ -3390,7 +3440,7 @@ write("g=",g);

File: asymptote.info, Node: Implicit scaling, Next: Functions, Prev: Operators, Up: Programming
-5.10 Implicit scaling
+6.10 Implicit scaling
=====================
If a numeric literal is in front of certain types of expressions, then
@@ -3427,7 +3477,7 @@ write(10cm);

File: asymptote.info, Node: Functions, Next: Arrays, Prev: Implicit scaling, Up: Programming
-5.11 Functions
+6.11 Functions
==============
`Asymptote' functions are treated as variables with a signature
@@ -3527,7 +3577,7 @@ segmentation fault, unless a fully working version of the GNU library

File: asymptote.info, Node: Default arguments, Next: Named arguments, Up: Functions
-5.11.1 Default arguments
+6.11.1 Default arguments
------------------------
`Asymptote' supports a more flexible mechanism for default function
@@ -3546,7 +3596,7 @@ defined.

File: asymptote.info, Node: Named arguments, Next: Rest arguments, Prev: Default arguments, Up: Functions
-5.11.2 Named arguments
+6.11.2 Named arguments
----------------------
It is sometimes difficult to remember the order in which arguments
@@ -3601,7 +3651,7 @@ would be allowed.

File: asymptote.info, Node: Rest arguments, Next: Mathematical functions, Prev: Named arguments, Up: Functions
-5.11.3 Rest arguments
+6.11.3 Rest arguments
---------------------
Rest arguments allow one to write functions that take a variable number
@@ -3681,7 +3731,7 @@ i(3,4); // ambiguous; the first candidate is better for the first argument,

File: asymptote.info, Node: Mathematical functions, Prev: Rest arguments, Up: Functions
-5.11.4 Mathematical functions
+6.11.4 Mathematical functions
-----------------------------
`Asymptote' has built-in versions of the standard `libm' mathematical
@@ -3767,7 +3817,7 @@ write(Si(1.0));

File: asymptote.info, Node: Arrays, Next: Casts, Prev: Functions, Up: Programming
-5.12 Arrays
+6.12 Arrays
===========
* Menu:
@@ -3806,9 +3856,7 @@ The `copy' function listed below provides a deep copy of an array.
Every array `A' of type `T[]' has the virtual members
* `int length',
- * `void cyclic(bool b)',
-
- * `bool cyclicflag',
+ * `int cyclic',
* `int[] keys',
@@ -3827,10 +3875,9 @@ The `copy' function listed below provides a deep copy of an array.
* `bool initialized(int n)'.
The member `A.length' evaluates to the length of the array. Setting
-`A.cyclic(true)' signifies that array indices should be reduced modulo
+`A.cyclic=true' signifies that array indices should be reduced modulo
the current array length. Reading from or writing to a nonempty cyclic
-array never leads to out-of-bounds errors or array resizing. The member
-`A.cyclicflag' returns the current setting of the `cyclic' flag.
+array never leads to out-of-bounds errors or array resizing.
The member `A.keys' evaluates to an array of integers containing the
indices of initialized entries in the array in ascending order. Hence,
@@ -3847,9 +3894,9 @@ range [`i',`j'], shifting the position of all higher-indexed elements
down. If no arguments are given, `A.delete()' provides a convenient way
of deleting all elements of `A'. The routine `A.initialized(int n)' can
be used to examine whether the element at index `n' is initialized.
-Like all `Asymptote' functions, `cyclic', `push', `append', `pop',
-`insert', `delete', and `initialized' can be "pulled off" of the array
-and used on their own. For example,
+Like all `Asymptote' functions, `push', `append', `pop', `insert',
+`delete', and `initialized' can be "pulled off" of the array and used
+on their own. For example,
int[] A={1};
A.push(2); // A now contains {1,2}.
A.append(A); // A now contains {1,2,1,2}.
@@ -4111,28 +4158,29 @@ file fin=input("test.txt");
real[] A=fin;
reads real values into `A' until the end-of-file is reached (or an I/O
-error occurs). If line mode is set with `line(file)', then reading will
-stop once the end of the line is reached instead (line mode may be
-cleared with `line(file,false)'):
+error occurs).
+
+ The virtual members `dimension', `line', `csv', `word', and `read'
+of a file are useful for reading arrays. For example, if line mode is
+set with `file line(bool b=true)', then reading will stop once the end
+of the line is reached instead
file fin=input("test.txt");
-real[] A=line(fin);
+real[] A=fin.line();
Since string reads by default read up to the end of line anyway,
line mode normally has no effect on string array reads. However, there
-is a white-space delimiter mode for reading strings, set with
-`word(file)' and cleared with `word(file,false)', which causes string
-reads to respect white-space delimiters, instead of the default
-end-of-line delimiter:
-file fin=word(line(input("test.txt")));
+is a white-space delimiter mode for reading strings, `file word(bool
+b=true)', which causes string reads to respect white-space delimiters,
+instead of the default end-of-line delimiter:
+file fin=input("test.txt").line().word();
real[] A=fin;
- Another useful mode is comma-separated-value mode, set with
-`csv(file)' and cleared with `csv(file,false)', which causes reads to
-respect comma delimiters:
+ Another useful mode is comma-separated-value mode, `file csv(bool
+b=true)', which causes reads to respect comma delimiters:
file fin=csv(input("test.txt"));
real[] A=fin;
- To restrict the number of values read, use the `dimension(file,int)'
+ To restrict the number of values read, use the `file dimension(int)'
function:
file fin=input("test.txt");
real[] A=dimension(fin,10);
@@ -4146,17 +4194,18 @@ end-of-file (or end-of-line in line mode) is encountered.
Two- and three-dimensional arrays of the basic data types can be read
in like this:
file fin=input("test.txt");
-real[][] A=dimension(fin,2,3);
-real[][][] B=dimension(fin,2,3,4);
+real[][] A=fin.dimension(2,3);
+real[][][] B=fin.dimension(2,3,4);
Again, an integer limit of zero means no restriction.
Sometimes the array dimensions are stored with the data as integer
-fields at the beginning of an array. Such arrays can be read in with the
-functions `read1', `read2', and `read3', respectively:
+fields at the beginning of an array. Such 1, 2, or 3 dimensional arrays
+can be read in with the virtual member functions `read(1)', `read(2)',
+or `read(3)', respectively:
file fin=input("test.txt");
-real[] A=read1(fin);
-real[][] B=read2(fin);
-real[][][] C=read3(fin);
+real[] A=fin.read(1);
+real[][] B=fin.read(2);
+real[][][] C=fin.read(3);
One, two, and three-dimensional arrays of the basic data types can be
output with the functions `write(file,T[])', `write(file,T[][])',
@@ -4165,7 +4214,7 @@ output with the functions `write(file,T[])', `write(file,T[][])',

File: asymptote.info, Node: Slices, Up: Arrays
-5.12.1 Slices
+6.12.1 Slices
-------------
Asymptote allows a section of an array to be addressed as a slice using
@@ -4197,7 +4246,7 @@ beyond the length of the array are allowed. The indices simply wrap
around. For example:
int[] x={0,1,2,3,4,5,6,7,8,9};
-x.cyclic(true);
+x.cyclic=true;
int[] y=x[8:15]; // y={8,9,0,1,2,3,4}.
int[] z=x[-5:5]; // z={5,6,7,8,9,0,1,2,3,4}
int[] w=x[-3:17]; // w={7,8,9,0,1,2,3,4,5,6,7,8,9,0,1,2,3,4,5,6}
@@ -4253,7 +4302,7 @@ any of the cells.

File: asymptote.info, Node: Casts, Next: Import, Prev: Arrays, Up: Programming
-5.13 Casts
+6.13 Casts
==========
`Asymptote' implicitly casts `int' to `real', `int' to `pair', `real'
@@ -4313,7 +4362,7 @@ real operator cast(int x)=convert;

File: asymptote.info, Node: Import, Next: Static, Prev: Casts, Up: Programming
-5.14 Import
+6.14 Import
===========
While `Asymptote' provides many features by default, some applications
@@ -4455,7 +4504,7 @@ is `true'.

File: asymptote.info, Node: Static, Prev: Import, Up: Programming
-5.15 Static
+6.15 Static
===========
Static qualifiers allocate the memory address of a variable in a higher
@@ -4568,7 +4617,7 @@ the variable actually possesses.

File: asymptote.info, Node: LaTeX usage, Next: Base modules, Prev: Programming, Up: Top
-6 `LaTeX' usage
+7 `LaTeX' usage
***************
`Asymptote' comes with a convenient `LaTeX' style file `asymptote.sty'
@@ -4599,7 +4648,7 @@ remove the files `latexusage-*', `latexusage_.pre', and
One can specify `width', `height', `viewportwidth',
`viewportheight', and `attach' `keyval'-style options to the `asy'
-environment. The current version (1.07) of `asymptote.sty' supports the
+environment. The current version (1.10) of `asymptote.sty' supports the
embedding of 3D PRC files, either inline or, using the `attach' option
with the `attachfile2' (or older `attachfile') `LaTeX' package, as
annotated (but printable) attachments. For many applications, the
@@ -4711,7 +4760,7 @@ the \verb+{attach=true}+ option:
import three;
currentprojection=orthographic(5,4,2);
draw(unitcube,blue);
-label("$V-E+F=2$",(0,1,0.5),3Y,blue+fontsize(17));
+label("$V-E+F=2$",(0,1,0.5),3Y,blue+fontsize(17pt));
\end{asy}
\end{center}
@@ -4728,7 +4777,7 @@ dot(z1,red+0.15cm);
dot(z2,darkgreen+0.3cm);
label("$m$",z1,1.2N,red);
label("$M$",z2,1.5N,darkgreen);
-label("$\hat{\ }$",zf,0.2*S,fontsize(24)+blue);
+label("$\hat{\ }$",zf,0.2*S,fontsize(24pt)+blue);
pair s=-0.2*I;
draw("$x$",z0+s--z1+s,N,red,Arrows,Bars,PenMargins);
@@ -4743,7 +4792,7 @@ draw("$X$",z0+s--z2+s,darkgreen,Arrows,Bars,PenMargins);

File: asymptote.info, Node: Base modules, Next: Options, Prev: LaTeX usage, Up: Top
-7 Base modules
+8 Base modules
**************
`Asymptote' currently ships with the following base modules:
@@ -4793,7 +4842,7 @@ File: asymptote.info, Node: Base modules, Next: Options, Prev: LaTeX usage,

File: asymptote.info, Node: plain, Next: simplex, Up: Base modules
-7.1 `plain'
+8.1 `plain'
===========
This is the default `Asymptote' base file, which defines key parts of
@@ -4810,7 +4859,7 @@ this feature.

File: asymptote.info, Node: simplex, Next: math, Prev: plain, Up: Base modules
-7.2 `simplex'
+8.2 `simplex'
=============
This package solves the two-variable linear programming problem using
@@ -4820,11 +4869,11 @@ sizing of pictures.

File: asymptote.info, Node: math, Next: interpolate, Prev: simplex, Up: Base modules
-7.3 `math'
+8.3 `math'
==========
This package extends `Asymptote''s mathematical capabilities with
-intersection algorithms and matrix arithmetic:
+matrix arithmetic and intersection algorithms:
`void drawline(picture pic=currentpicture, pair P, pair Q, pen p=currentpen);'
draw the visible portion of the (infinite) line going through `P'
@@ -4847,7 +4896,7 @@ intersection algorithms and matrix arithmetic:

File: asymptote.info, Node: interpolate, Next: geometry, Prev: math, Up: Base modules
-7.4 `interpolate'
+8.4 `interpolate'
=================
This module implements Lagrange, Hermite, and standard cubic spline
@@ -4857,7 +4906,7 @@ interpolation in `Asymptote', as illustrated in the example

File: asymptote.info, Node: geometry, Next: trembling, Prev: interpolate, Up: Base modules
-7.5 `geometry'
+8.5 `geometry'
==============
This module, written by Philippe Ivaldi, provides an extensive set of
@@ -4865,26 +4914,25 @@ geometry routines, including `perpendicular' symbols and a `triangle'
structure. Link to the documentation for the `geometry' module are
posted here: `http://asymptote.sourceforge.net/links.html', including
an extensive set of examples,
-`http://piprim.tuxfamily.org/asymptote/geometry/index.html', and an
-index:
+`http://www.piprime.fr/files/asymptote/geometry/', and an index:
- `http://piprim.tuxfamily.org/asymptote/geometry/modules/geometry.asy.index.type.html'
+ `http://www.piprime.fr/files/asymptote/geometry/modules/geometry.asy.index.type.html'

File: asymptote.info, Node: trembling, Next: stats, Prev: geometry, Up: Base modules
-7.6 `trembling'
+8.6 `trembling'
===============
This module, written by Philippe Ivaldi and illustrated in the example
`floatingdisk.asy', allows one to draw wavy lines, as if drawn by hand.
Further examples are posted at
-`http://piprim.tuxfamily.org/asymptote/trembling/index.html'
+`http://www.piprime.fr/files/asymptote/trembling/'

File: asymptote.info, Node: stats, Next: patterns, Prev: trembling, Up: Base modules
-7.7 `stats'
+8.7 `stats'
===========
This package implements a Gaussian random number generator and a
@@ -4894,7 +4942,7 @@ collection of statistics routines, including `histogram' and

File: asymptote.info, Node: patterns, Next: markers, Prev: stats, Up: Base modules
-7.8 `patterns'
+8.8 `patterns'
==============
This package implements `Postscript' tiling patterns and includes
@@ -4903,7 +4951,7 @@ several convenient pattern generation routines.

File: asymptote.info, Node: markers, Next: tree, Prev: patterns, Up: Base modules
-7.9 `markers'
+8.9 `markers'
=============
This package implements specialized routines for marking paths and
@@ -4952,7 +5000,7 @@ void markangle(picture pic=currentpicture, Label L="",

File: asymptote.info, Node: tree, Next: binarytree, Prev: markers, Up: Base modules
-7.10 `tree'
+8.10 `tree'
===========
This package implements an example of a dynamic binary search tree.
@@ -4960,7 +5008,7 @@ This package implements an example of a dynamic binary search tree.

File: asymptote.info, Node: binarytree, Next: drawtree, Prev: tree, Up: Base modules
-7.11 `binarytree'
+8.11 `binarytree'
=================
This module can be used to draw an arbitrary binary tree and includes an
@@ -4985,7 +5033,7 @@ add(pic2.fit(),(0,0),10S);

File: asymptote.info, Node: drawtree, Next: syzygy, Prev: binarytree, Up: Base modules
-7.12 `drawtree'
+8.12 `drawtree'
===============
This is a simple tree drawing module used by the example `treetest.asy'.
@@ -4993,7 +5041,7 @@ This is a simple tree drawing module used by the example `treetest.asy'.

File: asymptote.info, Node: syzygy, Next: feynman, Prev: drawtree, Up: Base modules
-7.13 `syzygy'
+8.13 `syzygy'
=============
This module automates the drawing of braids, relations, and syzygies,
@@ -5003,7 +5051,7 @@ along with the corresponding equations, as illustrated in the example

File: asymptote.info, Node: feynman, Next: roundedpath, Prev: syzygy, Up: Base modules
-7.14 `feynman'
+8.14 `feynman'
==============
This package, contributed by Martin Wiebusch, is useful for drawing
@@ -5013,7 +5061,7 @@ Feynman diagrams, as illustrated by the examples `eetomumu.asy' and

File: asymptote.info, Node: roundedpath, Next: animation, Prev: feynman, Up: Base modules
-7.15 `roundedpath'
+8.15 `roundedpath'
==================
This package, contributed by Stefan Knorr, is useful for rounding the
@@ -5023,14 +5071,14 @@ sharp corners of paths, as illustrated in the example file

File: asymptote.info, Node: animation, Next: embed, Prev: roundedpath, Up: Base modules
-7.16 `animation'
+8.16 `animation'
================
This module allows one to generate animations, as illustrated by the
files `wheel.asy', `wavelet.asy', and `cube.asy' in the `animations'
subdirectory of the examples directory. These animations use the
-`ImageMagick' `convert' program to `merge' multiple images into a GIF
-or MPEG movie.
+`ImageMagick' `convert' program to merge multiple images into a GIF or
+MPEG movie.
The related `animate' module, derived from the `animation' module,
generates higher-quality portable clickable PDF movies, with optional
@@ -5057,7 +5105,7 @@ as described here:

File: asymptote.info, Node: embed, Next: slide, Prev: animation, Up: Base modules
-7.17 `embed'
+8.17 `embed'
============
This module provides an interface to the `LaTeX' package (included with
@@ -5100,7 +5148,7 @@ animation (*note animate::).

File: asymptote.info, Node: slide, Next: MetaPost, Prev: embed, Up: Base modules
-7.18 `slide'
+8.18 `slide'
============
This package provides a simple yet high-quality facility for making
@@ -5111,7 +5159,7 @@ the file `slidemovies.asy'). A simple example is provided in the file

File: asymptote.info, Node: MetaPost, Next: unicode, Prev: slide, Up: Base modules
-7.19 `MetaPost'
+8.19 `MetaPost'
===============
This package provides some useful routines to help `MetaPost' users
@@ -5129,7 +5177,7 @@ equation solver `solve' instead.

File: asymptote.info, Node: unicode, Next: latin1, Prev: MetaPost, Up: Base modules
-7.20 `unicode'
+8.20 `unicode'
==============
Import this package at the beginning of the file to instruct `LaTeX' to
@@ -5152,7 +5200,7 @@ texpreamble("\usepackage{CJK}

File: asymptote.info, Node: latin1, Next: babel, Prev: unicode, Up: Base modules
-7.21 `latin1'
+8.21 `latin1'
=============
If you don't have `LaTeX' support for `unicode' installed, you can
@@ -5163,7 +5211,7 @@ providing support for other ISO 8859 alphabets.

File: asymptote.info, Node: babel, Next: labelpath, Prev: latin1, Up: Base modules
-7.22 `babel'
+8.22 `babel'
============
This module implements the `LaTeX' `babel' package in `Asymptote'. For
@@ -5174,7 +5222,7 @@ babel("german");

File: asymptote.info, Node: labelpath, Next: labelpath3, Prev: babel, Up: Base modules
-7.23 `labelpath'
+8.23 `labelpath'
================
This module uses the `PSTricks' `pstextpath' macro to fit labels along
@@ -5193,7 +5241,7 @@ macro.

File: asymptote.info, Node: labelpath3, Next: annotate, Prev: labelpath, Up: Base modules
-7.24 `labelpath3'
+8.24 `labelpath3'
=================
This module, contributed by Jens Schwaiger, implements a 3D version of
@@ -5203,7 +5251,7 @@ is provided in `curvedlabel3.asy'.

File: asymptote.info, Node: annotate, Next: CAD, Prev: labelpath3, Up: Base modules
-7.25 `annotate'
+8.25 `annotate'
===============
This module supports PDF annotations for viewing with `Adobe Reader',
@@ -5217,7 +5265,7 @@ and `tex' TeX engines.

File: asymptote.info, Node: CAD, Next: graph, Prev: annotate, Up: Base modules
-7.26 `CAD'
+8.26 `CAD'
==========
This package, contributed by Mark Henning, provides basic pen
@@ -5227,7 +5275,7 @@ according to DIN 15. It is documented separately, in the file `CAD.pdf'.

File: asymptote.info, Node: graph, Next: palette, Prev: CAD, Up: Base modules
-7.27 `graph'
+8.27 `graph'
============
This package implements two-dimensional linear and logarithmic graphs,
@@ -5253,7 +5301,7 @@ following routines:
* `default', the point is added to a new guide;
* `false', the point is omitted and a new guide is begun.
- Th points are connected using the interpolation specified by
+ The points are connected using the interpolation specified by
`join':
* `operator --' (linear interpolation; the abbreviation
`Straight' is also accepted);
@@ -5339,9 +5387,9 @@ following routines:
corresponding axis limit will be automatically determined from the
picture limits. The optional `arrow' argument takes the same
values as in the `draw' command (*note arrows::). The axis is
- drawn before any existing objects in the current picture unless
- `above=true'. The axis placement is determined by one of the
- following `axis' types:
+ drawn before any existing objects in `pic' unless `above=true'.
+ The axis placement is determined by one of the following `axis'
+ types:
`YZero(bool extend=true)'
Request an x axis at y=0 (or y=1 on a logarithmic axis)
@@ -5485,9 +5533,9 @@ following routines:
corresponding axis limit will be automatically determined from the
picture limits. The optional `arrow' argument takes the same
values as in the `draw' command (*note arrows::). The axis is
- drawn before any existing objects in the current picture unless
- `above=true'. The tick type is specified by `ticks' and the axis
- placement is determined by one of the following `axis' types:
+ drawn before any existing objects in `pic' unless `above=true'.
+ The tick type is specified by `ticks' and the axis placement is
+ determined by one of the following `axis' types:
`XZero(bool extend=true)'
Request a y axis at x=0 (or x=1 on a logarithmic axis)
@@ -5527,7 +5575,7 @@ following routines:
This convenience routine draws both x and y axes on picture `pic'
from `min' to `max', with optional labels `xlabel' and `ylabel'
and any arrows specified by `arrow'. The axes are drawn on top of
- existing objects in the current picture only if `above=true'.
+ existing objects in `pic' only if `above=true'.
* void axis(picture pic=currentpicture, Label L="", path g,
pen p=currentpen, ticks ticks, ticklocate locate,
@@ -5542,8 +5590,8 @@ following routines:
uncrowded tick labels. A `true' value for the flag `opposite'
identifies an unlabelled secondary axis (typically drawn opposite
a primary axis). The axis is drawn before any existing objects in
- the current picture unless `above=true'. The tick locator
- `ticklocate' is constructed by the routine ticklocate ticklocate(real a, real b, autoscaleT S=defaultS,
+ `pic' unless `above=true'. The tick locator `ticklocate' is
+ constructed by the routine ticklocate ticklocate(real a, real b, autoscaleT S=defaultS,
real tickmin=-infinity, real tickmax=infinity,
real time(real)=null, pair dir(real)=zero);
where `a' and `b' specify the respective tick values at
@@ -5676,7 +5724,7 @@ following routines:
xaxis("$x$",BottomTop,LeftTicks);
yaxis("$y$",LeftRight,
- RightTicks(Label(fontsize(8)),new real[]{0,4,9}));
+ RightTicks(Label(fontsize(8pt)),new real[]{0,4,9}));
@@ -5684,8 +5732,8 @@ following routines:
size(200,150,IgnoreAspect);
- file in=line(input("filegraph.dat"));
- real[][] a=dimension(in,0,0);
+ file in=input("filegraph.dat").line();
+ real[][] a=in.dimension(0,0);
a=transpose(a);
real[] x=a[0];
@@ -5938,8 +5986,8 @@ following routines:
draw(graph(f,0.1,10));
- //xlimits(1,10);
- //ylimits(0.1,1);
+ //xlimits(1,10,Crop);
+ //ylimits(0.1,1,Crop);
dot(Label("(3,5)",align=S),Scale((3,5)));
@@ -6065,12 +6113,12 @@ following routines:
size(9cm,6cm,IgnoreAspect);
string data="secondaryaxis.csv";
- file in=line(csv(input(data)));
+ file in=input(data).line().csv();
string[] titlelabel=in;
string[] columnlabel=in;
- real[][] a=dimension(in,0,0);
+ real[][] a=in.dimension(0,0);
a=transpose(a);
real[] t=a[0], susceptible=a[1], infectious=a[2], dead=a[3], larvae=a[4];
real[] susceptibleM=a[5], exposed=a[6],infectiousM=a[7];
@@ -6121,9 +6169,9 @@ following routines:
import graph;
import stats;
- file fin=line(input("leastsquares.dat"));
+ file fin=input("leastsquares.dat").line();
- real[][] a=dimension(fin,0,0);
+ real[][] a=fin.dimension(0,0);
a=transpose(a);
real[] t=a[0], rho=a[1];
@@ -6251,7 +6299,7 @@ following routines:

File: asymptote.info, Node: palette, Next: three, Prev: graph, Up: Base modules
-7.28 `palette'
+8.28 `palette'
==============
`Asymptote' can also generate color density images and palettes. The
@@ -6423,7 +6471,7 @@ pen[][] palette(real[][] f, pen[] palette);

File: asymptote.info, Node: three, Next: obj, Prev: palette, Up: Base modules
-7.29 `three'
+8.29 `three'
============
This module fully extends the notion of guides and paths in `Asymptote'
@@ -6473,16 +6521,17 @@ containing an array of Bezier patches. Surfaces may drawn with one of
the routines
void draw(picture pic=currentpicture, surface s, int nu=1, int nv=1,
material surfacepen=currentpen, pen meshpen=nullpen,
- light light=currentlight, light meshlight=light);
+ light light=currentlight, light meshlight=light, string name="");
void draw(picture pic=currentpicture, surface s, int nu=1, int nv=1,
material[] surfacepen, pen meshpen,
- light light=currentlight, light meshlight=light);
+ light light=currentlight, light meshlight=light, string name="");
void draw(picture pic=currentpicture, surface s, int nu=1, int nv=1,
material[] surfacepen, pen[] meshpen=nullpens,
- light light=currentlight, light meshlight=light);
+ light light=currentlight, light meshlight=light, string name="");
The parameters `nu' and `nv' specify the number of subdivisions for
-drawing optional mesh lines for each Bezier patch. Here material is a
-structure defined in `three_light.asy':
+drawing optional mesh lines for each Bezier patch. The optional `name'
+parameter is used as a prefix for naming the surface patches in the PRC
+model tree. Here material is a structure defined in `three_light.asy':
struct material {
pen[] p; // diffusepen,ambientpen,emissivepen,specularpen
real opacity;
@@ -6526,13 +6575,15 @@ length `4' or less.
Arbitrary thick three-dimensional curves and line caps (which the
`OpenGL' standard does not require implementations to provide) are
-constructed with the routine
-surface tube(path3 g, real width);
- which returns a tube of diameter `width' centered on `g'. This can
-make files slow to render, especially with the `Adobe Reader' renderer.
-The setting `thick=false' can be used to disable this feature and force
-all lines to be drawn with `linewidth(0)' (one pixel wide, regardless
-of the resolution). By default mesh and contour lines in
+constructed with
+tube tube(path3 p, real width, real granularity=tubegranularity);
+ this returns a tube structure representing a tube of diameter `width'
+centered approximately on `g'. The tube structure consists of a surface
+`s' and the actual tube center, path3 `center'. Drawing thick lines as
+tubes can be slow to render, especially with the `Adobe Reader'
+renderer. The setting `thick=false' can be used to disable this feature
+and force all lines to be drawn with `linewidth(0)' (one pixel wide,
+regardless of the resolution). By default, mesh and contour lines in
three-dimensions are always drawn thin, unless an explicit line width
is given in the pen parameter or the setting `thin' is set to `false'.
The pens `thin()' and `thick()' defined in plain_pens.asy can also be
@@ -6549,26 +6600,38 @@ There are four choices for viewing 3D `Asymptote' output:
sample width can be controlled with the setting `multisample'. An
initial screen position can be specified with the pair setting
`position', where negative values are interpreted as relative to
- the corresponding maximum screen dimension. The mouse bindings are:
+ the corresponding maximum screen dimension. The default settings import settings;
+ leftbutton=new string[] {"rotate","zoom","shift","pan"};
+ middlebutton=new string[] {"menu"};
+ rightbutton=new string[] {"zoom/menu","rotateX","rotateY","rotateZ"};
+ wheelup=new string[] {"zoomin"};
+ wheeldown=new string[] {"zoomout"};
+ bind the mouse buttons as follows:
* Left: rotate
- * shift Left: zoom
+ * Shift Left: zoom
+
+ * Ctrl Left: shift viewport
- * ctrl Left: shift
+ * Alt Left: pan
- * Middle: menu
+ * Middle: menu (must be unmodified; ignores Shift, Ctrl, and
+ Alt)
- * Wheel: zoom
+ * Wheel Up: zoom in
- * Right: zoom
+ * Wheel Down: zoom out
+
+ * Right: zoom/menu (must be unmodified)
* Right double click: menu
- * shift Right: rotate about the X axis
+ * Shift Right: rotate about the X axis
+
+ * Ctrl Right: rotate about the Y axis
- * ctrl Right: rotate about the Y axis
+ * Alt Right: rotate about the Z axis
- * alt Right: rotate about the Z axis
The keyboard shortcuts are:
* h: home
@@ -6588,14 +6651,24 @@ There are four choices for viewing 3D `Asymptote' output:
* c: show camera parameters
+ * p: play animation
+
+ * r: reverse animation
+
+ * : step animation
+
* +: expand
* =: expand
+ * >: expand
+
* -: shrink
* _: shrink
+ * <: shrink
+
* q: exit
* Ctrl-q: exit
@@ -6614,8 +6687,9 @@ There are four choices for viewing 3D `Asymptote' output:
restricts the maximum width and height of the viewport. On `UNIX'
systems some graphics drivers support batch mode (`-noV')
rendering in an iconified window; this can be enabled with the
- setting `iconify=true'. Other `UNIX' graphics drivers may require
- the command line setting `-glOptions=-indirect'.
+ setting `iconify=true'. Some (broken) `UNIX' graphics drivers may
+ require the command line setting `-glOptions=-indirect', which
+ requests (slower) indirect rendering.
3. Embed the 3D PRC format in a PDF file and view the resulting PDF
file with version `8.0' or later of `Adobe Reader'. In addition
@@ -6700,7 +6774,7 @@ surfaces `unitdisk', `unitplane', `unitcube', `unitcylinder',
These projections to two dimensions are predefined:
`oblique'
-`oblique(real angle);'
+`oblique(real angle)'
The point `(x,y,z)' is projected to `(x-0.5z,y-0.5z)'. If an
optional real argument is given, the negative z axis is drawn at
this angle in degrees. The projection `obliqueZ' is a synonym for
@@ -6721,7 +6795,8 @@ These projections to two dimensions are predefined:
this angle in degrees.
`orthographic(triple camera, triple up=Z, triple target=O,
- bool showtarget=true, bool center=false)'
+ real zoom=1, pair viewportshift=0, bool showtarget=true,
+ bool center=false)'
This projects from three to two dimensions using the view as seen
at a point infinitely far away in the direction `unit(camera)',
orienting the camera so that, if possible, the vector `up' points
@@ -6731,11 +6806,12 @@ These projections to two dimensions are predefined:
to the center of the bounding volume.
`orthographic(real x, real y, real z, triple up=Z, triple target=O,
- bool showtarget=true, bool center=false)'
- This is equivalent to
- `orthographic((x,y,z),up,target,showtarget,center)'.
+ real zoom=1, pair viewportshift=0, bool showtarget=true,
+ bool center=false)'
+ This is equivalent to orthographic((x,y,z),up,target,zoom,viewportshift,showtarget,center)
`perspective(triple camera, triple up=Z, triple target=O,
+ real zoom=1, real angle=0, pair viewportshift=0,
bool showtarget=true, bool autoadjust=true,
bool center=autoadjust)'
This projects from three to two dimensions, taking account of
@@ -6752,10 +6828,11 @@ These projections to two dimensions are predefined:
bounding volume.
`perspective(real x, real y, real z, triple up=Z, triple target=O,
+ real zoom=1, real angle=0, pair viewportshift=0,
bool showtarget=true, bool autoadjust=true,
bool center=autoadjust)'
- This is equivalent to `perspective((x,y,z),up,target,showtarget,
- autoadjust,center)'.
+ This is equivalent to perspective((x,y,z),up,target,zoom,angle,viewportshift,showtarget,
+ autoadjust,center)
The default projection, `currentprojection', is initially set to
`perspective(5,4,2)'.
@@ -6973,7 +7050,7 @@ add(faces);

File: asymptote.info, Node: obj, Next: graph3, Prev: three, Up: Base modules
-7.30 `obj'
+8.30 `obj'
==========
This module allows one to construct surfaces from simple obj files, as
@@ -6982,7 +7059,7 @@ illustrated in the example files `galleon.asy' and `triceratops.asy'.

File: asymptote.info, Node: graph3, Next: grid3, Prev: obj, Up: Base modules
-7.31 `graph3'
+8.31 `graph3'
=============
This module implements three-dimensional versions of the functions in
@@ -7038,9 +7115,9 @@ draw(p,Arrow3);
scale(true);
-xaxis3(XZ()*"$x$",Bounds(),red,InTicks(Label,2,2));
-yaxis3(YZ()*"$y$",Bounds(),red,InTicks(beginlabel=false,Label,2,2));
-zaxis3(XZ()*"$z$",Bounds(),red,InTicks);
+xaxis3(XZ()*"$x$",Bounds,red,InTicks(Label,2,2));
+yaxis3(YZ()*"$y$",Bounds,red,InTicks(beginlabel=false,Label,2,2));
+zaxis3(XZ()*"$z$",Bounds,red,InTicks);
@@ -7093,6 +7170,9 @@ surface surface(real f(pair z), pair a, pair b, int nx=nmesh, int ny=nx,
surface surface(real f(pair z), pair a, pair b, int nx=nmesh, int ny=nx,
splinetype xsplinetype, splinetype ysplinetype=xsplinetype,
bool cond(pair z)=null);
+surface surface(triple f(pair z), real[] u, real[] v,
+ splinetype[] usplinetype, splinetype[] vsplinetype=Spline,
+ bool cond(pair z)=null);
surface surface(triple f(pair z), pair a, pair b, int nu=nmesh, int nv=nu,
bool cond(pair z)=null);
surface surface(triple f(pair z), pair a, pair b, int nu=nmesh, int nv=nu,
@@ -7147,12 +7227,12 @@ picture vectorfield(path3 vector(pair v), triple f(pair z), pair a, pair b,

File: asymptote.info, Node: grid3, Next: solids, Prev: graph3, Up: Base modules
-7.32 `grid3'
+8.32 `grid3'
============
This module, contributed by Philippe Ivaldi, can be used for drawing 3D
grids. Here is an example (further examples can be found in `grid3.asy'
-and at `http://piprim.tuxfamily.org/asymptote/grid3/'):
+and at `http://www.piprime.fr/files/asymptote/grid3/'):
import grid3;
@@ -7176,7 +7256,7 @@ zaxis3(Label("$z$",position=EndPoint,align=(-1,0.5)),Bounds(Min,Min),

File: asymptote.info, Node: solids, Next: tube, Prev: grid3, Up: Base modules
-7.33 `solids'
+8.33 `solids'
=============
This solid geometry package defines a structure `revolution' that can
@@ -7212,12 +7292,12 @@ struct skeleton {

File: asymptote.info, Node: tube, Next: flowchart, Prev: solids, Up: Base modules
-7.34 `tube'
+8.34 `tube'
===========
-This package extends the routine `tube' defined in `three_arrows.asy'
-to arbitrary cross sections, colors, and spine transformations. The
-routine
+This package extends the `tube' surfaces constructed in
+`three_arrows.asy' to arbitrary cross sections, colors, and spine
+transformations. The routine
surface tube(path3 g, coloredpath section,
transform T(real)=new transform(real t) {return identity();},
real corner=1, real relstep=0);
@@ -7258,12 +7338,12 @@ default shading behavior for a surface.
An example of `tube' is provided in the file `trefoilknot.asy'.
Further examples can be found at
-`http://piprim.tuxfamily.org/asymptote/tube/'.
+`http://www.piprime.fr/files/asymptote/tube/'.

File: asymptote.info, Node: flowchart, Next: contour, Prev: tube, Up: Base modules
-7.35 `flowchart'
+8.35 `flowchart'
================
This package provides routines for drawing flowcharts. The primary
@@ -7378,7 +7458,7 @@ add(new void(picture pic, transform t) {

File: asymptote.info, Node: contour, Next: contour3, Prev: flowchart, Up: Base modules
-7.36 `contour'
+8.36 `contour'
==============
This package draws contour lines. To construct contours corresponding
@@ -7441,7 +7521,7 @@ real[] c=new real[n];
for(int i=0; i < n; ++i) c[i]=(i-n/2)/n;
pen[] p=sequence(new pen(int i) {
- return (c[i] >= 0 ? solid : dashed)+fontsize(6);
+ return (c[i] >= 0 ? solid : dashed)+fontsize(6pt);
},c.length);
Label[] Labels=sequence(new Label(int i) {
@@ -7561,7 +7641,7 @@ Shewchuk.

File: asymptote.info, Node: contour3, Next: slopefield, Prev: contour, Up: Base modules
-7.37 `contour3'
+8.37 `contour3'
===============
This package draws surfaces described as the null space of real-valued
@@ -7571,7 +7651,7 @@ in the example file `magnetic.asy'.

File: asymptote.info, Node: slopefield, Next: ode, Prev: contour3, Up: Base modules
-7.38 `slopefield'
+8.38 `slopefield'
=================
To draw a slope field for the differential equation dy/dx=f(x,y) (or
@@ -7611,7 +7691,7 @@ draw(curve((0,0),func,(-3,-3),(3,3)),red);

File: asymptote.info, Node: ode, Prev: slopefield, Up: Base modules
-7.39 `ode'
+8.39 `ode'
==========
The `ode' module, illustrated in the example `odetest.asy', implements
@@ -7621,8 +7701,8 @@ differential equations.

File: asymptote.info, Node: Options, Next: Interactive mode, Prev: Base modules, Up: Top
-8 Options
-*********
+9 Command-line options
+**********************
Type `asy -h' to see the full list of command-line options supported by
`Asymptote':
@@ -7632,11 +7712,14 @@ Usage: ../asy [options] [file ...]
Options (negate by replacing - with -no):
-V,-View View output; command-line only
--a,-align C|B|T|Z Center, Bottom, Top, or Zero page alignment [Center]
+-a,-align C|B|T|Z Center, Bottom, Top, or Zero page alignment [C]
-antialias n Antialiasing width for rasterized output [2]
+-arcballradius pixels Arcball radius [750]
-auto3D Automatically activate 3D scene [true]
+-autobillboard 3D labels always face viewer by default [true]
-autoimport string Module to automatically import
-autoplain Enable automatic importing of plain [true]
+-autoplay Autoplay 3D animations [false]
-autorotate Enable automatic PDF page rotation [false]
-batchMask Mask fpu exceptions in batch mode [false]
-batchView View output in batch mode [false]
@@ -7647,13 +7730,16 @@ Options (negate by replacing - with -no):
-compact Conserve memory at the expense of speed [false]
-d,-debug Enable debugging messages [false]
-divisor n Garbage collect using purge(divisor=n) [2]
+-doubleclick ms Emulated double-click timeout [200]
-embed Embed rendered preview image [true]
-exitonEOF Exit interactive mode on EOF [true]
-fitscreen Fit rendered image to screen [true]
+-framerate frames/sec Animation speed [30]
-globalwrite Allow write to other directory [false]
-gray Convert all colors to grayscale [false]
-h,-help Show summary of options; command-line only
-historylines n Retain n lines of history [1000]
+-hyperrefOptions str LaTeX hyperref package options [setpagesize=false,unicode]
-iconify Iconify rendering window [false]
-inlineimage Generate inline embedded image [false]
-inlinetex Generate inline TeX code [false]
@@ -7665,6 +7751,7 @@ Options (negate by replacing - with -no):
-level n Postscript level [3]
-l,-listvariables List available global functions and variables [false]
-localhistory Use a local interactive history file [false]
+-loop Loop 3D animations [false]
-m,-mask Mask fpu exceptions; command-line only
-maxtile pair Maximum rendering tile size [(0,0)]
-maxviewport pair Maximum viewport size [(2048,2048)]
@@ -7683,9 +7770,12 @@ Options (negate by replacing - with -no):
-prompt2 string Continuation prompt for multiline input [..]
-q,-quiet Suppress welcome message [false]
-render n Render 3D graphics using n pixels per bp (-1=auto) [-1]
+-resizestep step Resize step [1.2]
+-reverse reverse 3D animations [false]
-rgb Convert cmyk colors to rgb [false]
-safe Disable system call [true]
-scroll n Scroll standard output n lines at a time [0]
+-spinstep deg/sec Spin speed [60]
-tabcompletion Interactive prompt auto-completion [true]
-tex engine latex|pdflatex|xelatex|tex|pdftex|context|none [latex]
-thick Render thick 3D lines [true]
@@ -7699,8 +7789,10 @@ Options (negate by replacing - with -no):
-v,-verbose Increase verbosity level (can specify multiple times) [0]
-version Show version; command-line only
-wait Wait for child processes to finish before exiting [false]
+-warn string Enable warning; command-line only
-where Show where listed variables are declared [false]
--xformat format GUI deconstruction format [png]
+-zoomfactor factor Zoom step factor [1.05]
+-zoomstep step Mouse motion zoom step [0.1]
All boolean options can be negated by prepending `no' to the option
name.
@@ -7722,11 +7814,11 @@ automatically imported for each run as the final step in loading module
Default option values may be entered as `Asymptote' code in a
configuration file named `config.asy' (or the file specified by the
environment variable `ASYMPTOTE_CONFIG' or `-config' option).
-`Asymptote' will look for this file in its usual search path.
-Typically the configuration file is placed in the `.asy' directory in
-the user's home directory (`%USERPROFILE%\.asy' under `MSDOS').
-Configuration variables are accessed using the long form of the option
-names:
+`Asymptote' will look for this file in its usual search path (*note
+Search paths::). Typically the configuration file is placed in the
+`.asy' directory in the user's home directory (`%USERPROFILE%\.asy'
+under `MSDOS'). Configuration variables are accessed using the long
+form of the option names:
import settings;
outformat="pdf";
batchView=false;
@@ -7763,8 +7855,9 @@ pixel per `bp':
asy -o - venn | convert -alpha Off -density 144x144 -geometry 50%x eps:- venn.tiff
If the option `-nosafe' is given, `Asymptote' runs in unsafe mode.
-This enables the `int system(string s)' call, allowing one to execute
-arbitrary shell commands. The default mode, `-safe', disables this call.
+This enables the `int system(string s)' and `int system(string[] s)'
+calls, allowing one to execute arbitrary shell commands. The default
+mode, `-safe', disables this call.
A `PostScript' offset may be specified as a pair (in `bp' units)
with the `-O' option:
@@ -7816,8 +7909,8 @@ option:

File: asymptote.info, Node: Interactive mode, Next: GUI, Prev: Options, Up: Top
-9 Interactive mode
-******************
+10 Interactive mode
+*******************
Interactive mode is entered by executing the command `asy' with no file
arguments. When the `-multiline' option is disabled (the default), each
@@ -7841,6 +7934,9 @@ and must be entered immediately after the prompt:
`help'
view the manual;
+`erase'
+ erase `currentpicture';
+
`reset'
reset the `Asymptote' environment to its initial state, except for
changes to the settings module (*note settings::), the current
@@ -7887,7 +7983,7 @@ g.label("\"$O$\", (0,0), SW")

File: asymptote.info, Node: GUI, Next: PostScript to Asymptote, Prev: Interactive mode, Up: Top
-10 Graphical User Interface
+11 Graphical User Interface
***************************
In the event that adjustments to the final figure are required, the
@@ -7897,13 +7993,13 @@ The modified figure can then be saved as a normal `Asymptote' file.
* Menu:
-* GUI Installation:: Installing `xasy'
-* GUI Usage::
+* GUI installation:: Installing `xasy'
+* GUI usage::

-File: asymptote.info, Node: GUI Installation, Next: GUI Usage, Up: GUI
+File: asymptote.info, Node: GUI installation, Next: GUI usage, Up: GUI
-10.1 GUI Installation
+11.1 GUI installation
=====================
As `xasy' is written in the interactive scripting language `Python/TK',
@@ -7919,31 +8015,22 @@ packages.
Pictures are deconstructed into the PNG image format, which supports
full alpha channel transparency. Under `Microsoft Windows', this
-requires `Python 2.5 (or 2.5.1)' and the `Python Imaging Library':
+requires `Python 2.6.2' and the `Python Imaging Library':
- `http://www.python.org/ftp/python/2.5.1/python-2.5.1.msi'
+ `http://www.python.org/ftp/python/2.6.2/python-2.6.2.msi'
- `http://effbot.org/downloads/PIL-1.1.6.win32-py2.5.exe'.
+ `http://effbot.org/downloads/PIL-1.1.7b1.win32-py2.6.exe'.
On `UNIX' systems, place
-`http://effbot.org/downloads/Imaging-1.1.6.tar.gz' in the `Asymptote'
+`http://effbot.org/downloads/Imaging-1.1.7b1.tar.gz' in the `Asymptote'
source directory, and type (as the root user):
-tar -zxf Imaging-1.1.6.tar.gz
-cd Imaging-1.1.6
-patch -p1 < ../patches/TkAlpha-Imaging-1.1.6.patch
+tar -zxf Imaging-1.1.7b1.tar.gz
+cd Imaging-1.1.7b1
python setup.py install
- Alternatively, `xasy' can deconstruct pictures into the GIF image
-format (not recommended as this is very slow), using white as the
-transparent color. This requires the lines
-import settings;
-xformat="gif";
- in the `Asymptote' configuration file (*note configuration file::),
-along with the `ImageMagick' (*note convert::) program.
-

-File: asymptote.info, Node: GUI Usage, Prev: GUI Installation, Up: GUI
+File: asymptote.info, Node: GUI usage, Prev: GUI installation, Up: GUI
-10.2 GUI Usage
+11.2 GUI usage
==============
A wheel mouse is convenient for raising and lowering objects within
@@ -7964,32 +8051,15 @@ elements will be individually deconstructed (*note add::).

File: asymptote.info, Node: PostScript to Asymptote, Next: Help, Prev: GUI, Up: Top
-11 `PostScript' to `Asymptote'
+12 `PostScript' to `Asymptote'
******************************
-The excellent `PostScript' editor `pstoedit' (version 3.45 or later;
-available from `http://pstoedit.net') includes an `Asymptote' backend.
-Unlike virtually all other `pstoedit' backends, this driver includes
-native clipping, even-odd fill rule, `PostScript' subpath, and full
-image support.
-
- For full functionality, the patch `pstoedit-3.45asy.patch' in the
-`patches' directory should be applied. On `UNIX' systems, as the root
-user, place
-
- `http://prdownloads.sourceforge.net/pstoedit/pstoedit-3.45.tar.gz'
- in the `Asymptote' source directory, and type:
-
-tar -zxf pstoedit-3.45.tar.gz
-cd pstoedit-3.45
-patch -p1 < ../patches/pstoedit-3.45asy.patch
-autoconf
-./configure --prefix=/usr
-make install
-
-Then try:
-
-`asy -V /usr/local/share/doc/asymptote/examples/venn.asy'
+The excellent `PostScript' editor `pstoedit' (version 3.50 or later;
+available from `http://sourceforge.net/projects/pstoedit/') includes an
+`Asymptote' backend. Unlike virtually all other `pstoedit' backends,
+this driver includes native clipping, even-odd fill rule, `PostScript'
+subpath, and full image support. Here is an example: `asy -V
+/usr/local/share/doc/asymptote/examples/venn.asy'
pstoedit -f asy venn.eps test.asy
asy -V test
@@ -8000,7 +8070,7 @@ If the line widths aren't quite correct, try giving `pstoedit' the

File: asymptote.info, Node: Help, Next: Debugger, Prev: PostScript to Asymptote, Up: Top
-12 Help
+13 Help
*******
A list of frequently asked questions (FAQ) is maintained at
@@ -8009,7 +8079,7 @@ A list of frequently asked questions (FAQ) is maintained at
Questions on installing and using `Asymptote' that are not addressed
in the FAQ should be sent to the `Asymptote' forum:
- `http://sourceforge.net/forum/forum.php?forum_id=409349'
+ `http://sourceforge.net/projects/asymptote/forums/forum/409349'
Including an example that illustrates what you are trying to do will
help you get useful feedback. `LaTeX' problems can often be diagnosed
with the `-vv' or `-vvv' command-line options. Contributions in the
@@ -8021,7 +8091,7 @@ form of patches or `Asymptote' modules can be posted here:
`http://freshmeat.net/projects/asy'
If you find a bug in `Asymptote', please check (if possible) whether
-the bug is still present in the latest Subversion developmental code
+the bug is still present in the latest `Subversion' developmental code
(*note Subversion::) before submitting a bug report. New bugs can be
submitted using the Bug Tracking System at
@@ -8040,7 +8110,7 @@ generates such segmentation faults along with your bug report).

File: asymptote.info, Node: Debugger, Next: Credits, Prev: Help, Up: Top
-13 Debugger
+14 Debugger
***********
Asymptote now includes a line-based (as opposed to code-based) debugger
@@ -8108,7 +8178,7 @@ void breakpoint(code s=quote{});

File: asymptote.info, Node: Credits, Next: Index, Prev: Debugger, Up: Top
-14 Acknowledgments
+15 Acknowledgments
******************
Financial support for the development of `Asymptote' was generously
@@ -8147,7 +8217,7 @@ Index
(line 6)
* & <1>: Arithmetic & logical.
(line 56)
-* &: Tutorial. (line 192)
+* &: Bezier curves. (line 83)
* &&: Arithmetic & logical.
(line 53)
* * <1>: Arithmetic & logical.
@@ -8168,16 +8238,16 @@ Index
(line 14)
* -- <1>: Self & prefix operators.
(line 6)
-* --: Tutorial. (line 109)
-* ---: Tutorial. (line 192)
+* --: Tutorial. (line 125)
+* ---: Bezier curves. (line 83)
* -=: Self & prefix operators.
(line 6)
-* -c: Options. (line 154)
-* -l: Options. (line 173)
-* -u: Options. (line 164)
-* -V <1>: Tutorial. (line 41)
+* -c: Options. (line 167)
+* -l: Options. (line 186)
+* -u: Options. (line 177)
+* -V <1>: Tutorial. (line 19)
* -V: Configuring. (line 6)
-* ..: Tutorial. (line 109)
+* ..: Tutorial. (line 125)
* .asy: Search paths. (line 13)
* /: Arithmetic & logical.
(line 20)
@@ -8186,11 +8256,12 @@ Index
* 2D graphs: graph. (line 6)
* 3D graphs: graph3. (line 6)
* 3D grids: grid3. (line 6)
+* 3D PostScript: three. (line 532)
* 3D rendering: Compiling from UNIX source.
(line 16)
* :: Arithmetic & logical.
(line 73)
-* ::: Tutorial. (line 176)
+* ::: Bezier curves. (line 67)
* <: Arithmetic & logical.
(line 41)
* <=: Arithmetic & logical.
@@ -8208,14 +8279,14 @@ Index
(line 28)
* ^=: Self & prefix operators.
(line 6)
-* ^^: Tutorial. (line 197)
-* a4: Configuring. (line 62)
+* ^^: Tutorial. (line 132)
+* a4: Configuring. (line 61)
* abort: Data types. (line 321)
* abs <1>: Mathematical functions.
(line 35)
* abs: Data types. (line 60)
-* accel <1>: three. (line 433)
-* accel: Paths and guides. (line 110)
+* accel <1>: three. (line 462)
+* accel: Paths and guides. (line 109)
* access: Import. (line 6)
* acknowledgments: Credits. (line 6)
* aCos: Mathematical functions.
@@ -8225,57 +8296,59 @@ Index
* acosh: Mathematical functions.
(line 6)
* add: Frames and pictures. (line 192)
+* adjust: Pens. (line 112)
* Ai: Mathematical functions.
(line 48)
* Ai_deriv: Mathematical functions.
(line 48)
* Airy: Mathematical functions.
(line 48)
-* alias <1>: Arrays. (line 187)
+* alias <1>: Arrays. (line 184)
* alias: Structures. (line 54)
-* align: Options. (line 148)
+* align: Options. (line 161)
* Align: label. (line 12)
-* all: Arrays. (line 331)
-* Allow: Pens. (line 323)
+* all: Arrays. (line 328)
+* Allow: Pens. (line 324)
* AND: Arithmetic & logical.
(line 80)
-* and: Tutorial. (line 165)
+* and: Bezier curves. (line 56)
* angle: Data types. (line 68)
* animate <1>: animation. (line 12)
-* animate <2>: Files. (line 148)
-* animate: Configuring. (line 68)
+* animate <2>: Files. (line 151)
+* animate: Configuring. (line 67)
* animation: animation. (line 6)
* annotate: annotate. (line 6)
-* antialias <1>: Options. (line 128)
-* antialias: three. (line 180)
+* antialias <1>: Options. (line 140)
+* antialias: three. (line 205)
* antialiasing: Compiling from UNIX source.
(line 16)
* append <1>: Arrays. (line 39)
* append: Files. (line 36)
-* arc: three. (line 245)
+* arc: three. (line 271)
* Arc: Paths and guides. (line 32)
* arc: Paths and guides. (line 22)
* ArcArrow: draw. (line 26)
-* ArcArrow3: three. (line 476)
+* ArcArrow3: three. (line 505)
* ArcArrows: draw. (line 26)
-* ArcArrows3: three. (line 476)
-* arclength <1>: three. (line 433)
-* arclength: Paths and guides. (line 137)
-* arctime <1>: three. (line 433)
-* arctime: Paths and guides. (line 141)
+* ArcArrows3: three. (line 505)
+* arclength <1>: three. (line 462)
+* arclength: Paths and guides. (line 136)
+* arctime <1>: three. (line 462)
+* arctime: Paths and guides. (line 140)
* arguments: Default arguments. (line 6)
* arithmetic operators: Arithmetic & logical.
(line 6)
-* array: Arrays. (line 125)
+* array: Arrays. (line 122)
* array iteration: Programming. (line 33)
* arrays: Arrays. (line 6)
* arrow: label. (line 72)
* Arrow: draw. (line 26)
* arrow: Drawing commands. (line 31)
-* arrow keys: Tutorial. (line 21)
-* Arrow3: three. (line 476)
+* arrow keys: Tutorial. (line 35)
+* Arrow3: three. (line 505)
* Arrows: draw. (line 26)
-* Arrows3: three. (line 476)
+* arrows: draw. (line 26)
+* Arrows3: three. (line 505)
* as: Import. (line 70)
* aSin: Mathematical functions.
(line 20)
@@ -8289,7 +8362,8 @@ Index
* asy-mode: Editing modes. (line 6)
* asy.vim: Editing modes. (line 33)
* asymptote.sty: LaTeX usage. (line 6)
-* ASYMPTOTE_CONFIG: Options. (line 101)
+* asymptote.xml: Editing modes. (line 49)
+* ASYMPTOTE_CONFIG: Options. (line 113)
* aTan: Mathematical functions.
(line 20)
* atan: Mathematical functions.
@@ -8298,11 +8372,11 @@ Index
(line 6)
* atanh: Mathematical functions.
(line 6)
-* atleast: Tutorial. (line 165)
+* atleast: Bezier curves. (line 56)
* attach <1>: graph. (line 405)
* attach: LaTeX usage. (line 32)
-* autoadjust: three. (line 315)
-* autoimport: Options. (line 97)
+* autoadjust: three. (line 342)
+* autoimport: Options. (line 109)
* automatic scaling: graph. (line 672)
* axialshade: fill. (line 43)
* axis <1>: graph3. (line 66)
@@ -8310,36 +8384,37 @@ Index
* azimuth: Data types. (line 124)
* babel: babel. (line 6)
* background color: Frames and pictures. (line 164)
-* BackView: three. (line 340)
+* BackView: three. (line 369)
* Bar: draw. (line 19)
-* Bar3: three. (line 476)
+* Bar3: three. (line 505)
* Bars: draw. (line 19)
-* Bars3: three. (line 476)
+* Bars3: three. (line 505)
* barsize: draw. (line 19)
* base modules: Base modules. (line 6)
-* basealign: Pens. (line 164)
+* basealign: Pens. (line 165)
* baseline: label. (line 92)
-* batch mode: Tutorial. (line 30)
+* batch mode: Tutorial. (line 6)
* beep: Data types. (line 335)
* BeginArcArrow: draw. (line 26)
-* BeginArcArrow3: three. (line 476)
+* BeginArcArrow3: three. (line 505)
* BeginArrow: draw. (line 26)
-* BeginArrow3: three. (line 476)
+* BeginArrow3: three. (line 505)
* BeginBar: draw. (line 19)
-* BeginBar3: three. (line 476)
+* BeginBar3: three. (line 505)
* BeginDotMargin: draw. (line 42)
-* BeginDotMargin3: three. (line 492)
+* BeginDotMargin3: three. (line 521)
* BeginMargin: draw. (line 42)
-* BeginMargin3: three. (line 492)
+* BeginMargin3: three. (line 521)
* BeginPenMargin: draw. (line 42)
-* BeginPenMargin2: three. (line 492)
-* BeginPenMargin3: three. (line 492)
+* BeginPenMargin2: three. (line 521)
+* BeginPenMargin3: three. (line 521)
* BeginPoint: label. (line 57)
* Bessel: Mathematical functions.
(line 48)
* bevel: flowchart. (line 68)
-* beveljoin: Pens. (line 134)
-* bezulate: three. (line 98)
+* beveljoin: Pens. (line 135)
+* Bezier curves: Bezier curves. (line 6)
+* bezulate: three. (line 99)
* Bi: Mathematical functions.
(line 48)
* Bi_deriv: Mathematical functions.
@@ -8367,19 +8442,19 @@ Index
(line 6)
* Bottom: graph. (line 128)
* BottomTop: graph. (line 134)
-* BottomView: three. (line 340)
+* BottomView: three. (line 369)
* bounding box: Frames and pictures. (line 164)
* Bounds: graph3. (line 20)
* boutput: Files. (line 71)
-* box <1>: three. (line 267)
+* box <1>: three. (line 293)
* box: Frames and pictures. (line 22)
-* bp: Tutorial. (line 17)
+* bp: Tutorial. (line 24)
* break: Programming. (line 29)
* breakpoints: Debugger. (line 21)
-* brick: Pens. (line 247)
+* brick: Pens. (line 248)
* broken axis: graph. (line 773)
* bug reports: Help. (line 23)
-* buildcycle: Paths and guides. (line 251)
+* buildcycle: Paths and guides. (line 250)
* Button-1: GUI. (line 6)
* Button-2: GUI. (line 6)
* BWRainbow: palette. (line 15)
@@ -8393,24 +8468,25 @@ Index
* cd: Files. (line 24)
* ceil: Mathematical functions.
(line 26)
-* center: three. (line 300)
+* center: three. (line 326)
* Center: label. (line 62)
-* checker: Pens. (line 247)
+* checker: Pens. (line 248)
* Chinese: unicode. (line 12)
* choose: Mathematical functions.
(line 39)
* Ci: Mathematical functions.
(line 48)
* circle <1>: flowchart. (line 57)
-* circle: three. (line 241)
+* circle: three. (line 267)
* Circle: Paths and guides. (line 17)
* circle: Paths and guides. (line 10)
* circlebarframe: markers. (line 18)
* CJK: unicode. (line 12)
* clear <1>: Debugger. (line 23)
-* clear: Files. (line 86)
+* clear: Files. (line 89)
* clip: fill. (line 110)
-* cm: Tutorial. (line 63)
+* cm: Tutorial. (line 61)
+* cmd: Configuring. (line 34)
* cmyk: Pens. (line 34)
* colatitude: Data types. (line 129)
* color: Pens. (line 23)
@@ -8420,38 +8496,39 @@ Index
* colorless: Pens. (line 54)
* colors: Pens. (line 51)
* comma: Files. (line 59)
-* comma-separated-value mode: Arrays. (line 362)
+* comma-separated-value mode: Arrays. (line 361)
* command-line options <1>: Options. (line 6)
-* command-line options: Configuring. (line 82)
+* command-line options: Configuring. (line 83)
* comment character: Files. (line 15)
-* compass directions: Tutorial. (line 94)
+* compass directions: Tutorial. (line 104)
* Compiling from UNIX source: Compiling from UNIX source.
(line 6)
-* complement: Arrays. (line 153)
-* concat: Arrays. (line 183)
+* complement: Arrays. (line 150)
+* concat: Arrays. (line 180)
* conditional <1>: Arithmetic & logical.
(line 73)
* conditional: Programming. (line 8)
-* config: Options. (line 101)
-* configuration file: Configuring. (line 21)
+* config: Options. (line 113)
+* configuration file <1>: Options. (line 113)
+* configuration file: Configuring. (line 23)
* configuring: Configuring. (line 6)
* conj: Data types. (line 57)
* constructors: Structures. (line 95)
-* context: Options. (line 128)
+* context: Options. (line 140)
* continue <1>: Debugger. (line 31)
* continue: Programming. (line 29)
* contour: contour. (line 9)
* contour3: contour3. (line 6)
* controls <1>: three. (line 6)
-* controls: Tutorial. (line 154)
-* controlSpecifier: Paths and guides. (line 375)
-* convert <1>: Options. (line 128)
+* controls: Bezier curves. (line 45)
+* controlSpecifier: Paths and guides. (line 374)
+* convert <1>: Options. (line 140)
* convert <2>: animation. (line 6)
-* convert <3>: Files. (line 148)
-* convert: Configuring. (line 68)
-* convertOptions: Options. (line 116)
+* convert <3>: Files. (line 151)
+* convert: Configuring. (line 67)
+* convertOptions: Options. (line 128)
* Coons shading: fill. (line 74)
-* copy: Arrays. (line 174)
+* copy: Arrays. (line 171)
* Cos: Mathematical functions.
(line 20)
* cos: Mathematical functions.
@@ -8464,25 +8541,24 @@ Index
* cross <1>: graph. (line 474)
* cross: Data types. (line 167)
* crossframe: markers. (line 23)
-* crosshatch: Pens. (line 263)
-* csv: Arrays. (line 362)
-* cubicroots: Arrays. (line 320)
+* crosshatch: Pens. (line 264)
+* csv: Arrays. (line 361)
+* cubicroots: Arrays. (line 317)
* curl <1>: three. (line 6)
-* curl: Tutorial. (line 172)
-* curlSpecifier: Paths and guides. (line 387)
+* curl: Bezier curves. (line 63)
+* curlSpecifier: Paths and guides. (line 386)
* currentpen: Pens. (line 6)
-* currentprojection: three. (line 337)
+* currentprojection: three. (line 366)
* curve: slopefield. (line 20)
* custom axis types: graph. (line 138)
* custom mark routine: graph. (line 566)
* custom tick locations: graph. (line 241)
-* cut: Paths and guides. (line 233)
+* cut: Paths and guides. (line 232)
* cycle <1>: three. (line 6)
-* cycle: Tutorial. (line 46)
-* cyclic <1>: three. (line 433)
+* cycle: Tutorial. (line 73)
+* cyclic <1>: three. (line 462)
* cyclic <2>: Arrays. (line 39)
-* cyclic: Paths and guides. (line 75)
-* cyclicflag: Arrays. (line 39)
+* cyclic: Paths and guides. (line 74)
* Cyrillic: unicode. (line 7)
* dashdotted: Pens. (line 92)
* dashed: Pens. (line 92)
@@ -8492,11 +8568,11 @@ Index
(line 19)
* debugger: Debugger. (line 6)
* declaration: Programming. (line 8)
-* deconstruct: GUI Usage. (line 6)
+* deconstruct: GUI usage. (line 6)
* default arguments: Default arguments. (line 6)
* defaultformat: graph. (line 169)
* DefaultHead: draw. (line 26)
-* DefaultHead3: three. (line 476)
+* DefaultHead3: three. (line 505)
* defaultpen: Pens. (line 46)
* deferred drawing: simplex. (line 6)
* Degrees: Mathematical functions.
@@ -8505,30 +8581,30 @@ Index
(line 17)
* degrees: Data types. (line 73)
* delete <1>: Arrays. (line 39)
-* delete: Files. (line 143)
+* delete: Files. (line 146)
* description: Description. (line 6)
-* diagonal: Arrays. (line 305)
+* diagonal: Arrays. (line 302)
* diamond: flowchart. (line 50)
-* dimension: Arrays. (line 368)
-* dir <1>: three. (line 433)
-* dir <2>: Paths and guides. (line 99)
+* dimension: Arrays. (line 366)
+* dir <1>: three. (line 462)
+* dir <2>: Paths and guides. (line 98)
* dir <3>: Data types. (line 85)
* dir: Search paths. (line 10)
-* direction specifier: Tutorial. (line 115)
+* direction specifier: Bezier curves. (line 6)
* directory: Files. (line 24)
-* dirSpecifier: Paths and guides. (line 369)
-* dirtime: Paths and guides. (line 147)
-* display: Configuring. (line 68)
+* dirSpecifier: Paths and guides. (line 368)
+* dirtime: Paths and guides. (line 146)
+* display: Configuring. (line 67)
* do: Programming. (line 29)
* dot <1>: Data types. (line 98)
* dot: draw. (line 83)
* DotMargin: draw. (line 42)
-* DotMargin3: three. (line 492)
+* DotMargin3: three. (line 521)
* DotMargins: draw. (line 42)
-* DotMargins3: three. (line 492)
+* DotMargins3: three. (line 521)
* dotted: Pens. (line 92)
-* double: Files. (line 71)
-* double deferred drawing: three. (line 222)
+* double deferred drawing: three. (line 248)
+* double precision: Files. (line 71)
* Draw: Frames and pictures. (line 147)
* draw: draw. (line 110)
* Draw: draw. (line 26)
@@ -8536,15 +8612,17 @@ Index
* drawing commands: Drawing commands. (line 6)
* drawline: math. (line 9)
* drawtree: drawtree. (line 9)
-* dvips: Configuring. (line 68)
-* dvipsOptions: Options. (line 116)
+* dvips: Configuring. (line 67)
+* dvipsOptions: Options. (line 128)
+* dvisvg: Configuring. (line 67)
* E <1>: Mathematical functions.
(line 48)
-* E: Tutorial. (line 94)
+* E: Tutorial. (line 104)
* Editing modes: Editing modes. (line 6)
* Ei: Mathematical functions.
(line 48)
-* ellipse: Frames and pictures. (line 22)
+* ellipse <1>: Frames and pictures. (line 22)
+* ellipse: Paths and guides. (line 39)
* elliptic functions: Mathematical functions.
(line 48)
* else: Programming. (line 8)
@@ -8552,40 +8630,42 @@ Index
* embed: embed. (line 6)
* empty: Frames and pictures. (line 7)
* EndArcArrow: draw. (line 26)
-* EndArcArrow3: three. (line 476)
+* EndArcArrow3: three. (line 505)
* EndArrow: draw. (line 26)
-* EndArrow3: three. (line 476)
+* EndArrow3: three. (line 505)
* EndBar: draw. (line 19)
-* EndBar3: three. (line 476)
+* EndBar3: three. (line 505)
* EndDotMargin: draw. (line 42)
-* EndDotMargin3: three. (line 492)
+* EndDotMargin3: three. (line 521)
* endl: Files. (line 59)
* EndMargin: draw. (line 42)
-* EndMargin3: three. (line 492)
+* EndMargin3: three. (line 521)
* EndPenMargin: draw. (line 42)
-* EndPenMargin2: three. (line 492)
-* EndPenMargin3: three. (line 492)
+* EndPenMargin2: three. (line 521)
+* EndPenMargin3: three. (line 521)
* EndPoint: label. (line 57)
* envelope: Frames and pictures. (line 22)
-* environment variables: Configuring. (line 86)
-* eof <1>: Arrays. (line 346)
-* eof: Files. (line 86)
-* eol <1>: Arrays. (line 346)
-* eol: Files. (line 86)
+* environment variables: Configuring. (line 87)
+* eof <1>: Arrays. (line 343)
+* eof: Files. (line 89)
+* eol <1>: Arrays. (line 343)
+* eol: Files. (line 89)
* EPS: label. (line 80)
* erase <1>: Frames and pictures. (line 7)
-* erase: Data types. (line 239)
+* erase <2>: Data types. (line 239)
+* erase: Tutorial. (line 35)
* erf: Mathematical functions.
(line 6)
* erfc: Mathematical functions.
(line 6)
* error: Files. (line 15)
+* error bars: graph. (line 522)
* errorbars: graph. (line 474)
* eval: Import. (line 101)
-* evenodd <1>: Pens. (line 148)
-* evenodd: Tutorial. (line 211)
+* evenodd <1>: Pens. (line 149)
+* evenodd: Tutorial. (line 146)
* exit <1>: Debugger. (line 57)
-* exit <2>: Interactive mode. (line 37)
+* exit <2>: Interactive mode. (line 40)
* exit: Data types. (line 326)
* exp: Mathematical functions.
(line 6)
@@ -8596,24 +8676,24 @@ Index
(line 6)
* exponential integral: Mathematical functions.
(line 48)
-* extendcap: Pens. (line 125)
+* extendcap: Pens. (line 126)
* extension <1>: MetaPost. (line 10)
-* extension: Paths and guides. (line 228)
+* extension: Paths and guides. (line 227)
* external: embed. (line 28)
-* extrude: three. (line 427)
+* extrude: three. (line 456)
* F: Mathematical functions.
(line 48)
* fabs: Mathematical functions.
(line 6)
-* face: three. (line 511)
+* face: three. (line 540)
* factorial: Mathematical functions.
(line 39)
* Fedora: UNIX binary distributions.
(line 15)
* feynman: feynman. (line 6)
-* fft: Arrays. (line 252)
+* fft: Arrays. (line 249)
* FFTW: Compiling from UNIX source.
- (line 59)
+ (line 58)
* file <1>: Debugger. (line 45)
* file: Files. (line 6)
* Fill: Frames and pictures. (line 133)
@@ -8624,12 +8704,12 @@ Index
* filldraw: fill. (line 11)
* FillDraw: draw. (line 26)
* filloutside: fill. (line 27)
-* fillrule: Pens. (line 148)
-* find <1>: Arrays. (line 162)
+* fillrule: Pens. (line 149)
+* find <1>: Arrays. (line 159)
* find: Data types. (line 224)
-* firstcut: Paths and guides. (line 243)
+* firstcut: Paths and guides. (line 242)
* fit: Frames and pictures. (line 103)
-* fix-cm: Pens. (line 174)
+* fix-cm: Pens. (line 175)
* fixedscaling: Frames and pictures. (line 74)
* floor: Mathematical functions.
(line 26)
@@ -8637,19 +8717,19 @@ Index
* flush: Files. (line 59)
* fmod: Mathematical functions.
(line 6)
-* font: Pens. (line 188)
-* font command: Pens. (line 188)
-* fontcommand: Pens. (line 203)
-* fontsize: Pens. (line 174)
+* font: Pens. (line 189)
+* font command: Pens. (line 189)
+* fontcommand: Pens. (line 204)
+* fontsize: Pens. (line 175)
* for: Programming. (line 8)
-* format <1>: Options. (line 128)
+* format <1>: Options. (line 140)
* format: Data types. (line 266)
* forum: Help. (line 6)
* frame: Frames and pictures. (line 7)
* freeglut: Compiling from UNIX source.
(line 16)
* from: Import. (line 17)
-* FrontView: three. (line 340)
+* FrontView: three. (line 369)
* function declarations: Functions. (line 67)
* function shading: fill. (line 95)
* Function shading: fill. (line 95)
@@ -8663,12 +8743,12 @@ Index
(line 39)
* geometry: geometry. (line 6)
* getc: Files. (line 30)
-* getpair: Files. (line 111)
-* getreal: Files. (line 111)
-* getstring: Files. (line 111)
-* gettriple: Files. (line 111)
-* glOptions <1>: Options. (line 116)
-* glOptions: three. (line 180)
+* getpair: Files. (line 114)
+* getreal: Files. (line 114)
+* getstring: Files. (line 114)
+* gettriple: Files. (line 114)
+* glOptions <1>: Options. (line 128)
+* glOptions: three. (line 205)
* GNU Scientific Library: Mathematical functions.
(line 48)
* gouraudshade: fill. (line 58)
@@ -8682,20 +8762,20 @@ Index
* Grayscale: palette. (line 9)
* grayscale: Pens. (line 25)
* grid <1>: graph. (line 724)
-* grid: Pens. (line 247)
+* grid: Pens. (line 248)
* grid3: grid3. (line 6)
* gs: Configuring. (line 6)
* gsl: Mathematical functions.
(line 48)
* GSL: Compiling from UNIX source.
- (line 59)
-* gsOptions: Options. (line 116)
+ (line 58)
+* gsOptions: Options. (line 128)
* GUI: GUI. (line 6)
-* GUI installation: GUI Installation. (line 6)
-* GUI usage: GUI Usage. (line 6)
-* guide: Paths and guides. (line 296)
+* GUI installation: GUI installation. (line 6)
+* GUI usage: GUI usage. (line 6)
+* guide: Paths and guides. (line 295)
* guide3: three. (line 6)
-* hatch: Pens. (line 263)
+* hatch: Pens. (line 264)
* height: LaTeX usage. (line 32)
* help <1>: Debugger. (line 30)
* help <2>: Help. (line 6)
@@ -8705,13 +8785,14 @@ Index
* hex: Data types. (line 279)
* hexidecimal <1>: Pens. (line 59)
* hexidecimal: Data types. (line 279)
-* hidden surface removal: three. (line 511)
+* hidden surface removal: three. (line 540)
* histogram: Mathematical functions.
(line 39)
-* history: Files. (line 136)
-* historylines: Interactive mode. (line 42)
+* history <1>: Interactive mode. (line 40)
+* history: Files. (line 139)
+* historylines: Interactive mode. (line 45)
* HookHead: draw. (line 26)
-* HookHead3: three. (line 476)
+* HookHead3: three. (line 505)
* Horizontal: flowchart. (line 74)
* hypot: Mathematical functions.
(line 6)
@@ -8719,60 +8800,61 @@ Index
(line 48)
* i_scaled: Mathematical functions.
(line 48)
-* iconic: three. (line 180)
-* identity <1>: Arrays. (line 302)
+* iconic: three. (line 205)
+* identity <1>: Arrays. (line 299)
* identity <2>: Mathematical functions.
(line 6)
* identity: Transforms. (line 24)
* if: Programming. (line 8)
* IgnoreAspect: Frames and pictures. (line 58)
* image: palette. (line 34)
-* ImageMagick <1>: Options. (line 128)
+* ImageMagick <1>: Options. (line 140)
* ImageMagick <2>: animation. (line 6)
-* ImageMagick: Configuring. (line 68)
+* ImageMagick: Configuring. (line 67)
+* images: palette. (line 6)
* implicit casts: Casts. (line 6)
* implicit linear solver: MetaPost. (line 10)
* implicit scaling: Implicit scaling. (line 6)
* import: Import. (line 48)
-* inches: Tutorial. (line 63)
+* inches: Tutorial. (line 61)
* including images: label. (line 80)
* inheritance: Structures. (line 189)
* initialized: Arrays. (line 39)
* initializers: Variable initializers.
(line 6)
* InOutTicks: graph3. (line 34)
-* input <1>: Interactive mode. (line 31)
+* input <1>: Interactive mode. (line 29)
* input: Files. (line 11)
* insert <1>: Arrays. (line 39)
* insert: Data types. (line 235)
-* inside: Paths and guides. (line 275)
+* inside: Paths and guides. (line 274)
* inst: Debugger. (line 36)
* installation: Installation. (line 6)
* int: Data types. (line 28)
* integer division: Arithmetic & logical.
(line 6)
* interactive mode: Interactive mode. (line 6)
-* interior: Paths and guides. (line 271)
+* interior: Paths and guides. (line 270)
* international characters: unicode. (line 6)
* interp: Arithmetic & logical.
(line 76)
* interpolate: interpolate. (line 6)
-* intersect <1>: three. (line 433)
+* intersect <1>: three. (line 462)
* intersect <2>: math. (line 13)
-* intersect: Paths and guides. (line 176)
-* intersectionpoint <1>: three. (line 433)
+* intersect: Paths and guides. (line 175)
+* intersectionpoint <1>: three. (line 462)
* intersectionpoint <2>: math. (line 17)
-* intersectionpoint: Paths and guides. (line 220)
-* intersectionpoints <1>: three. (line 433)
-* intersectionpoints: Paths and guides. (line 224)
-* intersections <1>: three. (line 433)
-* intersections: Paths and guides. (line 187)
+* intersectionpoint: Paths and guides. (line 219)
+* intersectionpoints <1>: three. (line 462)
+* intersectionpoints: Paths and guides. (line 223)
+* intersections <1>: three. (line 462)
+* intersections: Paths and guides. (line 186)
* InTicks: graph3. (line 34)
* intMax: Data types. (line 28)
* intMin: Data types. (line 28)
-* inverse <1>: Arrays. (line 308)
+* inverse <1>: Arrays. (line 305)
* inverse: Transforms. (line 16)
-* invert: three. (line 366)
+* invert: three. (line 395)
* invisible: Pens. (line 39)
* J: Mathematical functions.
(line 6)
@@ -8781,11 +8863,14 @@ Index
(line 48)
* k_scaled: Mathematical functions.
(line 48)
-* keyboard bindings:: three. (line 149)
+* Kate: Editing modes. (line 49)
+* KDE editor: Editing modes. (line 49)
+* keyboard bindings:: three. (line 164)
* keys: Arrays. (line 39)
* keywords: Named arguments. (line 6)
* Korean: unicode. (line 12)
-* Label: graph. (line 332)
+* Label <1>: graph. (line 332)
+* Label: label. (line 15)
* label: clip. (line 16)
* Label: draw. (line 98)
* labelpath: labelpath. (line 6)
@@ -8793,10 +8878,10 @@ Index
* labelx: graph. (line 332)
* labely: graph. (line 332)
* Landscape: Frames and pictures. (line 95)
-* lastcut: Paths and guides. (line 247)
+* lastcut: Paths and guides. (line 246)
* lasy-mode: Editing modes. (line 6)
-* latex: Options. (line 128)
-* LaTeX fonts: Pens. (line 188)
+* latex: Options. (line 140)
+* LaTeX fonts: Pens. (line 189)
* LaTeX usage: LaTeX usage. (line 6)
* latin1: latin1. (line 6)
* latitude: Data types. (line 134)
@@ -8808,29 +8893,30 @@ Index
* LeftRight: graph. (line 280)
* LeftSide: label. (line 62)
* LeftTicks: graph. (line 155)
-* LeftView: three. (line 340)
+* LeftView: three. (line 369)
* legend <1>: graph. (line 421)
* legend <2>: draw. (line 64)
* legend: Drawing commands. (line 31)
* Legendre: Mathematical functions.
(line 48)
-* length <1>: three. (line 433)
+* length <1>: three. (line 462)
* length <2>: Arrays. (line 39)
-* length <3>: Paths and guides. (line 66)
+* length <3>: Paths and guides. (line 65)
* length: Data types. (line 60)
-* letter: Configuring. (line 62)
+* letter: Configuring. (line 61)
* libm routines: Mathematical functions.
(line 6)
* libsigsegv <1>: Help. (line 33)
* libsigsegv: Functions. (line 88)
* limits: graph. (line 626)
-* line: Arrays. (line 346)
-* line mode: Arrays. (line 346)
+* line: Arrays. (line 343)
+* line mode: Arrays. (line 343)
* Linear: graph. (line 672)
-* linecap: Pens. (line 125)
-* linejoin: Pens. (line 134)
-* lineskip: Pens. (line 174)
-* linewidth: Pens. (line 115)
+* linecap: Pens. (line 126)
+* linejoin: Pens. (line 135)
+* lineskip: Pens. (line 175)
+* linetype: Pens. (line 112)
+* linewidth: Pens. (line 116)
* locale: Data types. (line 286)
* Log: graph. (line 672)
* log: Mathematical functions.
@@ -8850,13 +8936,13 @@ Index
* loop: Programming. (line 8)
* MacOS X binary distributions: MacOS X binary distributions.
(line 6)
-* makepen: Pens. (line 296)
-* map: Arrays. (line 144)
+* makepen: Pens. (line 297)
+* map: Arrays. (line 141)
* Margin: draw. (line 42)
-* Margin3: three. (line 492)
-* margins: three. (line 228)
+* Margin3: three. (line 521)
+* margins: three. (line 254)
* Margins: draw. (line 42)
-* Margins3: three. (line 492)
+* Margins3: three. (line 521)
* mark: graph. (line 474)
* markangle: markers. (line 38)
* marker: graph. (line 474)
@@ -8866,64 +8952,65 @@ Index
* math: math. (line 6)
* mathematical functions: Mathematical functions.
(line 6)
-* max <1>: three. (line 433)
-* max <2>: Arrays. (line 231)
+* max <1>: three. (line 462)
+* max <2>: Arrays. (line 228)
* max <3>: Frames and pictures. (line 7)
-* max: Paths and guides. (line 260)
+* max: Paths and guides. (line 259)
* maxbound: Data types. (line 104)
-* maxtile: three. (line 180)
-* maxtimes: Paths and guides. (line 215)
-* maxviewport: three. (line 180)
-* merge: animation. (line 6)
+* maxtile: three. (line 205)
+* maxtimes: Paths and guides. (line 214)
+* maxviewport: three. (line 205)
* MetaPost: MetaPost. (line 6)
-* MetaPost ... : Tutorial. (line 176)
-* MetaPost cutafter: Paths and guides. (line 248)
-* MetaPost cutbefore: Paths and guides. (line 244)
+* MetaPost ... : Bezier curves. (line 67)
+* MetaPost cutafter: Paths and guides. (line 247)
+* MetaPost cutbefore: Paths and guides. (line 243)
* MetaPost pickup: Pens. (line 6)
* MetaPost whatever: MetaPost. (line 10)
* Microsoft Windows: Microsoft Windows. (line 6)
* MidArcArrow: draw. (line 26)
-* MidArcArrow3: three. (line 476)
+* MidArcArrow3: three. (line 505)
* MidArrow: draw. (line 26)
-* MidArrow3: three. (line 476)
-* midpoint: Paths and guides. (line 161)
+* MidArrow3: three. (line 505)
+* midpoint: Paths and guides. (line 160)
* MidPoint: label. (line 57)
-* min <1>: three. (line 433)
-* min <2>: Arrays. (line 224)
+* min <1>: three. (line 462)
+* min <2>: Arrays. (line 221)
* min <3>: Frames and pictures. (line 7)
-* min: Paths and guides. (line 256)
+* min: Paths and guides. (line 255)
* minbound: Data types. (line 101)
* minipage: label. (line 119)
-* mintimes: Paths and guides. (line 210)
-* miterjoin: Pens. (line 134)
-* miterlimit: Pens. (line 143)
-* mm: Tutorial. (line 63)
+* mintimes: Paths and guides. (line 209)
+* miterjoin: Pens. (line 135)
+* miterlimit: Pens. (line 144)
+* mm: Tutorial. (line 61)
+* mode: Files. (line 85)
* mouse: GUI. (line 6)
-* mouse bindings: three. (line 129)
-* Move: Pens. (line 335)
-* MoveQuiet: Pens. (line 341)
-* multisample: three. (line 119)
+* mouse bindings: three. (line 132)
+* Move: Pens. (line 336)
+* MoveQuiet: Pens. (line 342)
+* multisample: three. (line 122)
* multisampling: Compiling from UNIX source.
(line 16)
-* N: Tutorial. (line 94)
+* N: Tutorial. (line 104)
+* name: Files. (line 85)
* named arguments: Named arguments. (line 6)
-* new <1>: Arrays. (line 112)
+* new <1>: Arrays. (line 109)
* new: Structures. (line 6)
* newframe: Frames and pictures. (line 7)
* newl: Files. (line 59)
* newton: Mathematical functions.
(line 65)
* next: Debugger. (line 42)
-* NFSS: Pens. (line 188)
-* nobasealign: Pens. (line 164)
+* NFSS: Pens. (line 189)
+* nobasealign: Pens. (line 165)
* NoFill <1>: Frames and pictures. (line 141)
* NoFill: draw. (line 26)
* NoMargin: draw. (line 42)
-* NoMargin3: three. (line 492)
+* NoMargin3: three. (line 521)
* none: Files. (line 59)
* None: draw. (line 19)
-* normal: three. (line 419)
-* nosafe: Options. (line 144)
+* normal: three. (line 448)
+* nosafe: Options. (line 156)
* NOT: Arithmetic & logical.
(line 80)
* NoTicks: graph. (line 155)
@@ -8931,18 +9018,19 @@ Index
* null: Structures. (line 6)
* nullpen <1>: Frames and pictures. (line 127)
* nullpen: label. (line 14)
-* NURBS: three. (line 318)
-* O: three. (line 236)
+* NURBS: three. (line 346)
+* O: three. (line 262)
* obj: obj. (line 9)
-* oblique: three. (line 281)
-* obliqueX: three. (line 289)
-* obliqueY: three. (line 296)
-* obliqueZ: three. (line 281)
+* oblique: three. (line 307)
+* obliqueX: three. (line 315)
+* obliqueY: three. (line 322)
+* obliqueZ: three. (line 307)
* ode: ode. (line 9)
-* offset: Options. (line 148)
-* opacity: Pens. (line 218)
+* offset <1>: Options. (line 161)
+* offset: Pens. (line 112)
+* opacity: Pens. (line 219)
* open: Files. (line 11)
-* OpenGL: three. (line 119)
+* OpenGL: three. (line 122)
* operator: User-defined operators.
(line 6)
* operator --: graph. (line 31)
@@ -8957,92 +9045,94 @@ Index
* OR: Arithmetic & logical.
(line 80)
* orientation: Frames and pictures. (line 95)
-* orthographic: three. (line 300)
-* outformat: three. (line 119)
+* orthographic: three. (line 326)
+* outformat: three. (line 122)
* outprefix: Frames and pictures. (line 83)
-* output <1>: Options. (line 128)
+* output <1>: Options. (line 140)
* output: Files. (line 36)
* OutTicks: graph3. (line 34)
* overloading functions: Functions. (line 44)
-* overwrite: Pens. (line 320)
+* overwrite: Pens. (line 321)
* P: Mathematical functions.
(line 48)
* pack: label. (line 102)
* packing: Rest arguments. (line 30)
* pair <1>: Data types. (line 41)
-* pair: Tutorial. (line 17)
-* pairs: Arrays. (line 248)
-* paperheight: Configuring. (line 62)
-* papertype: Configuring. (line 62)
-* paperwidth: Configuring. (line 62)
+* pair: Tutorial. (line 49)
+* pairs: Arrays. (line 245)
+* paperheight: Configuring. (line 61)
+* papertype: Configuring. (line 61)
+* paperwidth: Configuring. (line 61)
* parametric surface: graph3. (line 100)
* parametrized curve: graph. (line 626)
-* patch-dependent colors: three. (line 75)
+* patch-dependent colors: three. (line 76)
* path <1>: flowchart. (line 74)
* path <2>: three. (line 43)
* path: Paths and guides. (line 7)
+* path markers: graph. (line 474)
* path3: three. (line 6)
-* path[]: Tutorial. (line 197)
+* path[]: Tutorial. (line 132)
* patterns <1>: patterns. (line 6)
-* patterns: Pens. (line 234)
-* pdflatex: Options. (line 128)
+* patterns: Pens. (line 235)
+* pdflatex: Options. (line 140)
* pdfviewer: Configuring. (line 6)
-* pdfviewerOptions: Options. (line 116)
+* pdfviewerOptions: Options. (line 128)
* pen: Pens. (line 6)
* PenMargin: draw. (line 42)
-* PenMargin2: three. (line 492)
-* PenMargin3: three. (line 492)
+* PenMargin2: three. (line 521)
+* PenMargin3: three. (line 521)
* PenMargins: draw. (line 42)
-* PenMargins2: three. (line 492)
-* PenMargins3: three. (line 492)
+* PenMargins2: three. (line 521)
+* PenMargins3: three. (line 521)
* perpendicular: geometry. (line 6)
-* perspective: three. (line 318)
+* perspective: three. (line 346)
* picture: Frames and pictures. (line 35)
* picture alignment: Frames and pictures. (line 205)
-* piecewisestraight: Paths and guides. (line 82)
+* piecewisestraight: Paths and guides. (line 81)
* Pl: Mathematical functions.
(line 48)
* plain: plain. (line 6)
-* planar: three. (line 83)
-* plane: three. (line 263)
-* planeproject: three. (line 416)
-* point <1>: three. (line 433)
-* point: Paths and guides. (line 85)
+* planar: three. (line 84)
+* plane: three. (line 289)
+* planeproject: three. (line 445)
+* point <1>: three. (line 462)
+* point: Paths and guides. (line 84)
* polar: Data types. (line 119)
* polargraph: graph. (line 90)
* polygon: graph. (line 474)
* pop: Arrays. (line 39)
* Portrait: Frames and pictures. (line 95)
-* postcontrol <1>: three. (line 433)
-* postcontrol: Paths and guides. (line 130)
+* postcontrol <1>: three. (line 462)
+* postcontrol: Paths and guides. (line 129)
* postfix operators: Self & prefix operators.
(line 19)
* postscript: Frames and pictures. (line 267)
-* PostScript fonts: Pens. (line 206)
-* PostScript subpath: Tutorial. (line 197)
+* PostScript fonts: Pens. (line 207)
+* PostScript subpath: Tutorial. (line 132)
* pow10: Mathematical functions.
(line 6)
-* prc: three. (line 197)
-* precision: Files. (line 86)
-* precontrol <1>: three. (line 433)
-* precontrol: Paths and guides. (line 123)
+* prc: three. (line 223)
+* precision: Files. (line 89)
+* precontrol <1>: three. (line 462)
+* precontrol: Paths and guides. (line 122)
* prefix operators: Self & prefix operators.
(line 6)
* private: Structures. (line 6)
* programming: Programming. (line 6)
* pstoedit: PostScript to Asymptote.
(line 6)
+* psview: Microsoft Windows. (line 16)
* psviewer: Configuring. (line 6)
-* psviewerOptions: Options. (line 116)
-* pt: Tutorial. (line 63)
+* psviewerOptions: Options. (line 128)
+* pt: Tutorial. (line 61)
* public: Structures. (line 6)
* push: Arrays. (line 39)
-* python: Configuring. (line 27)
-* Python usage: Interactive mode. (line 58)
-* quadraticroots: Arrays. (line 311)
+* Python usage: Interactive mode. (line 61)
+* quadraticroots: Arrays. (line 308)
* quarticroots: math. (line 22)
* quit <1>: Debugger. (line 54)
-* quit: Interactive mode. (line 37)
+* quit <2>: Interactive mode. (line 40)
+* quit: Tutorial. (line 35)
* quote: Import. (line 119)
* quotient: Arithmetic & logical.
(line 6)
@@ -9050,19 +9140,17 @@ Index
* radialshade: fill. (line 49)
* radians: Mathematical functions.
(line 17)
-* radius <1>: three. (line 433)
-* radius: Paths and guides. (line 119)
+* radius <1>: three. (line 462)
+* radius: Paths and guides. (line 118)
* Rainbow: palette. (line 12)
* rand: Mathematical functions.
(line 39)
* randMax: Mathematical functions.
(line 39)
-* read1: Arrays. (line 386)
-* read2: Arrays. (line 386)
-* read3: Arrays. (line 386)
+* read: Arrays. (line 384)
* reading: Files. (line 11)
* reading string arrays: Arrays. (line 353)
-* readline: Files. (line 128)
+* readline: Files. (line 131)
* real: Data types. (line 33)
* realDigits: Data types. (line 33)
* realEpsilon: Data types. (line 33)
@@ -9073,24 +9161,24 @@ Index
* recursion: Functions. (line 88)
* reflect: Transforms. (line 51)
* Relative: label. (line 52)
-* relpoint: Paths and guides. (line 157)
-* reltime: Paths and guides. (line 153)
+* relpoint: Paths and guides. (line 156)
+* reltime: Paths and guides. (line 152)
* remainder: Mathematical functions.
(line 6)
-* rename: Files. (line 145)
-* render <1>: Options. (line 128)
-* render: three. (line 119)
+* rename: Files. (line 148)
+* render <1>: Options. (line 140)
+* render: three. (line 122)
* replace: Data types. (line 252)
-* resetdefaultpen: Pens. (line 349)
+* resetdefaultpen: Pens. (line 350)
* rest arguments: Rest arguments. (line 6)
* restore: Frames and pictures. (line 261)
* restricted: Structures. (line 6)
* return: Debugger. (line 48)
-* reverse <1>: three. (line 433)
-* reverse <2>: Arrays. (line 149)
-* reverse <3>: Paths and guides. (line 164)
+* reverse <1>: three. (line 462)
+* reverse <2>: Arrays. (line 146)
+* reverse <3>: Paths and guides. (line 163)
* reverse: Data types. (line 248)
-* rewind: Files. (line 86)
+* rewind: Files. (line 89)
* rfind: Data types. (line 229)
* rgb: Pens. (line 30)
* Riemann zeta function: Mathematical functions.
@@ -9098,58 +9186,60 @@ Index
* Right: graph. (line 277)
* RightSide: label. (line 62)
* RightTicks: graph. (line 155)
-* RightView: three. (line 340)
+* RightView: three. (line 369)
* Rotate: label. (line 37)
* Rotate(pair z): label. (line 40)
* round: Mathematical functions.
(line 26)
-* roundcap: Pens. (line 125)
+* roundcap: Pens. (line 126)
* roundedpath: roundedpath. (line 6)
-* roundjoin: Pens. (line 134)
+* roundjoin: Pens. (line 135)
* roundrectangle: flowchart. (line 62)
* RPM: UNIX binary distributions.
(line 6)
* runtime imports: Import. (line 101)
* Russian: unicode. (line 7)
-* S: Tutorial. (line 94)
-* safe: Options. (line 144)
+* S: Tutorial. (line 104)
+* safe: Options. (line 156)
* save: Frames and pictures. (line 258)
-* saveline: Files. (line 128)
-* scale: three. (line 395)
+* saveline: Files. (line 131)
+* scale: three. (line 424)
* Scale: graph. (line 688)
* scale <1>: graph. (line 672)
-* scale: Transforms. (line 39)
+* scale <2>: Transforms. (line 39)
+* scale: Pens. (line 112)
* Scale: label. (line 46)
-* scale3: three. (line 392)
+* scale3: three. (line 421)
* scaled graph: graph. (line 653)
* scientific graph: graph. (line 386)
-* scroll: Files. (line 102)
-* search: Arrays. (line 167)
+* scroll: Files. (line 105)
+* search: Arrays. (line 164)
* search paths: Search paths. (line 6)
* Seascape: Frames and pictures. (line 100)
* secondary axis: graph. (line 803)
* secondaryX: graph. (line 803)
* secondaryY: graph. (line 803)
* seconds: Data types. (line 299)
-* seek: Files. (line 86)
-* seekeof: Files. (line 86)
+* seek: Files. (line 89)
+* seekeof: Files. (line 89)
* segmentation fault: Help. (line 33)
* self operators: Self & prefix operators.
(line 6)
-* sequence: Arrays. (line 131)
-* settings <1>: Options. (line 101)
-* settings: Configuring. (line 21)
+* sequence: Arrays. (line 128)
+* settings <1>: Options. (line 113)
+* settings: Configuring. (line 23)
* sgn: Mathematical functions.
(line 26)
* shading: fill. (line 32)
-* shift <1>: three. (line 380)
+* shift <1>: three. (line 409)
* shift: Transforms. (line 27)
* Shift: label. (line 34)
* shiftless: Transforms. (line 53)
* shipout: Frames and pictures. (line 83)
-* showtarget: three. (line 300)
+* showtarget: three. (line 326)
* Si: Mathematical functions.
(line 48)
+* signedint: Files. (line 71)
* SimpleHead: draw. (line 26)
* simplex: simplex. (line 6)
* simpson: Mathematical functions.
@@ -9158,31 +9248,33 @@ Index
(line 20)
* sin: Mathematical functions.
(line 6)
-* single: Files. (line 71)
+* single precision: Files. (line 71)
+* singleint: Files. (line 71)
+* singlereal: Files. (line 71)
* sinh: Mathematical functions.
(line 6)
-* size <1>: Options. (line 128)
-* size <2>: three. (line 433)
+* size <1>: Options. (line 140)
+* size <2>: three. (line 462)
* size <3>: Frames and pictures. (line 43)
-* size: Paths and guides. (line 71)
-* size3: three. (line 225)
+* size: Paths and guides. (line 70)
+* size3: three. (line 251)
* slant: Transforms. (line 45)
* Slant: label. (line 43)
* sleep: Data types. (line 329)
-* slice: Paths and guides. (line 233)
+* slice: Paths and guides. (line 232)
* slices: Slices. (line 6)
* slide: slide. (line 6)
* slopefield: slopefield. (line 6)
* solid: Pens. (line 92)
* solids: solids. (line 9)
-* solve: Arrays. (line 265)
-* sort: Arrays. (line 190)
+* solve: Arrays. (line 262)
+* sort: Arrays. (line 187)
* Spline <1>: graph3. (line 100)
* Spline: graph. (line 34)
* split: Data types. (line 261)
* sqrt: Mathematical functions.
(line 6)
-* squarecap: Pens. (line 125)
+* squarecap: Pens. (line 126)
* srand: Mathematical functions.
(line 39)
* stack overflow <1>: Help. (line 33)
@@ -9194,157 +9286,155 @@ Index
* step: Debugger. (line 39)
* stickframe: markers. (line 16)
* stop: Debugger. (line 10)
-* straight: three. (line 433)
+* straight: three. (line 462)
* Straight: graph. (line 31)
-* straight: Paths and guides. (line 78)
+* straight: Paths and guides. (line 77)
* strftime: Data types. (line 291)
* string: Data types. (line 179)
* stroke: fill. (line 36)
-* strokepath: Paths and guides. (line 290)
+* strokepath: Paths and guides. (line 289)
* strptime: Data types. (line 299)
* struct: Structures. (line 6)
* structures: Structures. (line 6)
-* subpath <1>: three. (line 433)
-* subpath: Paths and guides. (line 167)
+* subpath <1>: three. (line 462)
+* subpath: Paths and guides. (line 166)
* subpictures: Frames and pictures. (line 103)
* substr: Data types. (line 244)
* Subversion: Subversion. (line 6)
-* sum: Arrays. (line 219)
-* superpath: Tutorial. (line 197)
-* Suppress: Pens. (line 327)
-* SuppressQuiet: Pens. (line 331)
+* sum: Arrays. (line 216)
+* superpath: Tutorial. (line 132)
+* Suppress: Pens. (line 328)
+* SuppressQuiet: Pens. (line 332)
* surface <1>: graph3. (line 100)
* surface: three. (line 47)
* SVN: Subversion. (line 6)
-* system <1>: Options. (line 144)
-* system: Files. (line 153)
+* system <1>: Options. (line 156)
+* system: Files. (line 156)
* syzygy: syzygy. (line 6)
* tab: Files. (line 59)
-* tab completion: Tutorial. (line 21)
+* tab completion: Tutorial. (line 35)
* Tan: Mathematical functions.
(line 20)
* tan: Mathematical functions.
(line 6)
* tanh: Mathematical functions.
(line 6)
-* target: three. (line 300)
-* tell: Files. (line 86)
+* target: three. (line 326)
+* tell: Files. (line 89)
* tension <1>: three. (line 6)
-* tension: Tutorial. (line 165)
-* tensionSpecifier: Paths and guides. (line 381)
+* tension: Bezier curves. (line 56)
+* tensionSpecifier: Paths and guides. (line 380)
* tensor product shading: fill. (line 74)
* tensorshade: fill. (line 74)
-* tex <1>: Options. (line 128)
+* tex <1>: Options. (line 140)
* tex: Frames and pictures. (line 274)
-* TeX fonts: Pens. (line 197)
+* TeX fonts: Pens. (line 198)
* TeX string: Data types. (line 179)
-* texcommand: Configuring. (line 68)
-* texdvicommand: Configuring. (line 68)
+* texcommand: Configuring. (line 67)
* TeXHead: draw. (line 26)
-* TeXHead3: three. (line 476)
+* TeXHead3: three. (line 505)
* texpath <1>: label. (line 116)
-* texpath: Configuring. (line 68)
+* texpath: Configuring. (line 67)
* texpreamble: Frames and pictures. (line 282)
* texreset: Frames and pictures. (line 285)
* textbook graph: graph. (line 361)
* tgz: UNIX binary distributions.
(line 6)
-* thick: three. (line 104)
-* thin: three. (line 104)
+* thick: three. (line 105)
+* thin: three. (line 105)
* this: Structures. (line 6)
* three: three. (line 6)
* tick: graph. (line 332)
* Ticks: graph. (line 155)
* ticks: graph. (line 155)
* tildeframe: markers. (line 26)
-* tile: Pens. (line 247)
-* tilings: Pens. (line 234)
+* tile: Pens. (line 248)
+* tilings: Pens. (line 235)
* time: Data types. (line 291)
-* times: Paths and guides. (line 202)
+* times: Paths and guides. (line 201)
* Top: graph. (line 131)
-* TopView: three. (line 340)
+* TopView: three. (line 369)
* trace: Debugger. (line 51)
* trailingzero: graph. (line 169)
-* transform <1>: three. (line 407)
+* transform <1>: three. (line 436)
* transform: Transforms. (line 6)
-* transform3: three. (line 376)
-* transparency: Pens. (line 218)
-* transpose: Arrays. (line 211)
+* transform3: three. (line 405)
+* transparency: Pens. (line 219)
+* transpose: Arrays. (line 208)
* tree: tree. (line 9)
* trembling: trembling. (line 6)
* triangle: geometry. (line 6)
* triangulate: contour. (line 156)
-* tridiagonal: Arrays. (line 268)
+* tridiagonal: Arrays. (line 265)
* trigonometric integrals: Mathematical functions.
(line 48)
* triple: Data types. (line 108)
* TrueMargin: draw. (line 42)
-* TrueMargin3: three. (line 492)
+* TrueMargin3: three. (line 521)
* tube <1>: tube. (line 6)
-* tube: three. (line 104)
+* tube: three. (line 105)
* tutorial: Tutorial. (line 6)
* typedef <1>: Functions. (line 36)
* typedef: Data types. (line 339)
-* undefined: Paths and guides. (line 264)
+* undefined: Paths and guides. (line 263)
* UnFill: Frames and pictures. (line 152)
* unfill: fill. (line 105)
* UnFill: draw. (line 26)
* unicode: unicode. (line 6)
-* uniform: Arrays. (line 158)
+* uniform: Arrays. (line 155)
* Uninstall: Uninstall. (line 6)
* unit: Data types. (line 78)
-* unitbox <1>: three. (line 269)
-* unitbox: Tutorial. (line 218)
-* unitcircle <1>: three. (line 236)
-* unitcircle: Tutorial. (line 110)
+* unitbox <1>: three. (line 295)
+* unitbox: Tutorial. (line 153)
+* unitcircle <1>: three. (line 262)
+* unitcircle: Tutorial. (line 126)
* unitrand: Mathematical functions.
(line 39)
* unitsize <1>: Frames and pictures. (line 64)
-* unitsize: Tutorial. (line 73)
+* unitsize: Tutorial. (line 84)
* UNIX binary distributions: UNIX binary distributions.
(line 6)
* unpacking: Rest arguments. (line 39)
* unravel: Import. (line 31)
-* up: three. (line 300)
+* up: three. (line 326)
* update: Files. (line 36)
* UpsideDown: Frames and pictures. (line 95)
* usepackage: Frames and pictures. (line 287)
-* user coordinates: Tutorial. (line 73)
+* user coordinates: Tutorial. (line 84)
* user-defined operators: User-defined operators.
(line 6)
* usleep: Data types. (line 332)
* variable initializers: Variable initializers.
(line 6)
* vectorfield: graph. (line 965)
-* vectorfield3: graph3. (line 156)
-* vectorization: Arrays. (line 325)
+* vectorfield3: graph3. (line 159)
+* vectorization: Arrays. (line 322)
* verbatim: Frames and pictures. (line 267)
-* vertex-dependent colors: three. (line 75)
+* vertex-dependent colors: three. (line 76)
* Vertical: flowchart. (line 74)
* viewportheight: LaTeX usage. (line 32)
-* viewportmargin: three. (line 228)
-* viewportsize: three. (line 228)
+* viewportmargin: three. (line 254)
+* viewportsize: three. (line 254)
* viewportwidth: LaTeX usage. (line 32)
-* views: three. (line 197)
+* views: three. (line 223)
* vim: Editing modes. (line 33)
* virtual functions: Structures. (line 189)
* void: Data types. (line 10)
-* W: Tutorial. (line 94)
-* whatever: Paths and guides. (line 228)
+* W: Tutorial. (line 104)
+* whatever: Paths and guides. (line 227)
* Wheel: palette. (line 22)
* wheel mouse: GUI. (line 6)
* while: Programming. (line 29)
* white-space string delimiter mode: Arrays. (line 353)
* width: LaTeX usage. (line 32)
-* windingnumber: Paths and guides. (line 264)
+* windingnumber: Paths and guides. (line 263)
* word: Arrays. (line 353)
-* write <1>: Arrays. (line 394)
+* write <1>: Arrays. (line 393)
* write: Files. (line 51)
-* X: three. (line 236)
-* xasy <1>: GUI. (line 6)
-* xasy: Configuring. (line 68)
+* X: three. (line 262)
+* xasy: GUI. (line 6)
* xaxis3: graph3. (line 7)
-* xelatex <1>: Options. (line 128)
+* xelatex <1>: Options. (line 140)
* xelatex: embed. (line 10)
* xequals: graph. (line 284)
* XEquals: graph. (line 270)
@@ -9355,14 +9445,14 @@ Index
* xoutput: Files. (line 71)
* xpart: Data types. (line 89)
* xscale: Transforms. (line 33)
-* xscale3: three. (line 383)
+* xscale3: three. (line 412)
* xtick: graph. (line 332)
* XYEquals: graph3. (line 20)
* XYZero: graph3. (line 20)
* XZEquals: graph3. (line 20)
* XZero: graph. (line 265)
* XZZero: graph3. (line 20)
-* Y <1>: three. (line 236)
+* Y <1>: three. (line 262)
* Y: Mathematical functions.
(line 6)
* yaxis3: graph3. (line 7)
@@ -9371,12 +9461,12 @@ Index
* ylimits: graph. (line 626)
* ypart: Data types. (line 92)
* yscale: Transforms. (line 36)
-* yscale3: three. (line 386)
+* yscale3: three. (line 415)
* ytick: graph. (line 332)
* YZEquals: graph3. (line 20)
* YZero: graph. (line 119)
* YZZero: graph3. (line 20)
-* Z: three. (line 236)
+* Z: three. (line 262)
* zaxis3: graph3. (line 7)
* zero_Ai: Mathematical functions.
(line 48)
@@ -9388,11 +9478,11 @@ Index
(line 48)
* zero_J: Mathematical functions.
(line 48)
-* zerowinding: Pens. (line 148)
+* zerowinding: Pens. (line 149)
* zeta: Mathematical functions.
(line 48)
* zpart: Data types. (line 161)
-* zscale3: three. (line 389)
+* zscale3: three. (line 418)
* |: Arithmetic & logical.
(line 62)
* ||: Arithmetic & logical.
@@ -9402,144 +9492,145 @@ Index

Tag Table:
Node: Top574
-Node: Description6760
-Node: Installation10175
-Node: UNIX binary distributions11223
-Node: MacOS X binary distributions12329
-Node: Microsoft Windows13277
-Node: Configuring14447
-Node: Search paths18640
-Node: Compiling from UNIX source19320
-Ref: multisampling19909
-Node: Editing modes22335
-Node: Subversion24535
-Node: Uninstall24996
-Node: Tutorial25346
-Ref: unitcircle29089
-Ref: Bezier29298
-Node: Drawing commands34357
-Node: draw36066
-Ref: arrows37214
-Node: fill42439
-Ref: gradient shading43483
-Node: clip47676
-Node: label48268
-Ref: Label48967
-Node: Programming54711
-Ref: array iteration55528
-Node: Data types56610
-Ref: format65507
-Node: Paths and guides68971
-Ref: circle69225
-Ref: arctime74570
-Ref: extension78435
-Node: Pens85118
-Ref: fillrule92263
-Ref: basealign93160
-Ref: transparency95985
-Ref: makepen99428
-Ref: overwrite100266
-Node: Transforms101476
-Node: Frames and pictures103267
-Ref: envelope104408
-Ref: size105491
-Ref: unitsize106478
-Ref: shipout107538
-Ref: filltype109846
-Ref: add112829
-Ref: add about113775
-Ref: tex116720
-Node: Files117594
-Ref: cd118559
-Ref: scroll122940
-Node: Variable initializers125983
-Node: Structures128278
-Node: Operators135620
-Node: Arithmetic & logical135934
-Node: Self & prefix operators137831
-Node: User-defined operators138619
-Node: Implicit scaling139530
-Node: Functions140093
-Ref: stack overflow142846
-Node: Default arguments143410
-Node: Named arguments144149
-Node: Rest arguments146311
-Node: Mathematical functions149121
-Node: Arrays153726
-Ref: sort160907
-Ref: tridiagonal163198
-Ref: solve164426
-Node: Slices168553
-Node: Casts172447
-Node: Import174413
-Node: Static179643
-Node: LaTeX usage182539
-Node: Base modules187980
-Node: plain190480
-Node: simplex191132
-Node: math191405
-Node: interpolate192504
-Node: geometry192783
-Node: trembling193387
-Node: stats193748
-Node: patterns194008
-Node: markers194244
-Node: tree196027
-Node: binarytree196215
-Node: drawtree196804
-Node: syzygy197008
-Node: feynman197282
-Node: roundedpath197557
-Node: animation197840
-Ref: animate198259
-Node: embed199398
-Node: slide201187
-Node: MetaPost201527
-Node: unicode202243
-Node: latin1203131
-Node: babel203499
-Node: labelpath203728
-Node: labelpath3204548
-Node: annotate204859
-Node: CAD205330
-Node: graph205640
-Ref: ticks212478
-Ref: pathmarkers225626
-Ref: marker226091
-Ref: markuniform226442
-Ref: errorbars228233
-Ref: automatic scaling232289
-Node: palette242922
-Ref: images243040
-Ref: image247211
-Ref: logimage247689
-Ref: penimage248495
-Node: three248939
-Ref: PostScript3D270300
-Node: obj271992
-Node: graph3272244
-Ref: GaussianSurface277205
-Node: grid3278290
-Node: solids279030
-Node: tube279978
-Node: flowchart282209
-Node: contour286708
-Node: contour3291737
-Node: slopefield292044
-Node: ode293481
-Node: Options293741
-Ref: configuration file298908
-Ref: settings298908
-Ref: convert299979
-Node: Interactive mode302738
-Ref: history304362
-Node: GUI305667
-Node: GUI Installation306170
-Node: GUI Usage307696
-Node: PostScript to Asymptote308599
-Node: Help309742
-Node: Debugger311469
-Node: Credits313254
-Node: Index314167
+Node: Description6833
+Node: Installation10334
+Node: UNIX binary distributions11387
+Node: MacOS X binary distributions12493
+Node: Microsoft Windows13377
+Ref: psview14087
+Node: Configuring15008
+Node: Search paths19228
+Node: Compiling from UNIX source20025
+Ref: multisampling20614
+Node: Editing modes23032
+Node: Subversion25464
+Node: Uninstall25927
+Node: Tutorial26277
+Ref: unitcircle30503
+Node: Drawing commands32484
+Node: draw34195
+Ref: arrows35343
+Node: fill40586
+Ref: gradient shading41630
+Node: clip45823
+Node: label46415
+Ref: Label47114
+Node: Bezier curves52839
+Node: Programming56416
+Ref: array iteration57230
+Node: Data types58312
+Ref: format67213
+Node: Paths and guides70677
+Ref: circle70931
+Ref: arctime76288
+Ref: extension80153
+Node: Pens86836
+Ref: fillrule94080
+Ref: basealign94977
+Ref: transparency97802
+Ref: makepen101245
+Ref: overwrite102083
+Node: Transforms103293
+Node: Frames and pictures105084
+Ref: envelope106225
+Ref: size107308
+Ref: unitsize108295
+Ref: shipout109355
+Ref: filltype111688
+Ref: add114657
+Ref: add about115603
+Ref: tex118548
+Node: Files119422
+Ref: cd120387
+Ref: scroll124856
+Node: Variable initializers127929
+Node: Structures130224
+Node: Operators137676
+Node: Arithmetic & logical137990
+Node: Self & prefix operators139887
+Node: User-defined operators140675
+Node: Implicit scaling141586
+Node: Functions142149
+Ref: stack overflow144902
+Node: Default arguments145466
+Node: Named arguments146205
+Node: Rest arguments148367
+Node: Mathematical functions151177
+Node: Arrays155782
+Ref: sort162842
+Ref: tridiagonal165133
+Ref: solve166361
+Node: Slices170558
+Node: Casts174451
+Node: Import176417
+Node: Static181647
+Node: LaTeX usage184543
+Node: Base modules189988
+Node: plain192488
+Node: simplex193140
+Node: math193413
+Node: interpolate194512
+Node: geometry194791
+Node: trembling195385
+Node: stats195736
+Node: patterns195996
+Node: markers196232
+Node: tree198015
+Node: binarytree198203
+Node: drawtree198792
+Node: syzygy198996
+Node: feynman199270
+Node: roundedpath199545
+Node: animation199828
+Ref: animate200245
+Node: embed201384
+Node: slide203173
+Node: MetaPost203513
+Node: unicode204229
+Node: latin1205117
+Node: babel205485
+Node: labelpath205714
+Node: labelpath3206534
+Node: annotate206845
+Node: CAD207316
+Node: graph207626
+Ref: ticks214450
+Ref: pathmarkers227558
+Ref: marker228023
+Ref: markuniform228374
+Ref: errorbars230165
+Ref: automatic scaling234221
+Node: palette244867
+Ref: images244985
+Ref: image249156
+Ref: logimage249634
+Ref: penimage250440
+Node: three250884
+Ref: PostScript3D273456
+Node: obj275148
+Node: graph3275400
+Ref: GaussianSurface280525
+Node: grid3281610
+Node: solids282350
+Node: tube283298
+Node: flowchart285533
+Node: contour290032
+Node: contour3295063
+Node: slopefield295370
+Node: ode296807
+Node: Options297067
+Ref: configuration file302880
+Ref: settings302880
+Ref: convert303975
+Node: Interactive mode306764
+Ref: history308429
+Node: GUI309734
+Node: GUI installation310237
+Node: GUI usage311375
+Node: PostScript to Asymptote312278
+Node: Help313034
+Node: Debugger314770
+Node: Credits316555
+Node: Index317468

End Tag Table
diff --git a/Master/texmf/doc/info/dir b/Master/texmf/doc/info/dir
index 8e4409e6811..f9e705da18b 100644
--- a/Master/texmf/doc/info/dir
+++ b/Master/texmf/doc/info/dir
@@ -40,6 +40,7 @@ TeX
* gftopk: (web2c)gftopk invocation. Generic to packed fonts.
* gftype: (web2c)gftype invocation. GF to human-readable text.
* kpsewhich: (kpathsea)Invoking kpsewhich. TeX file searching.
+* latex2man: (latex2man)Top. Convert man pages in LaTeX.
* makempx: (web2c)makempx invocation. MetaPost label typesetting.
* mf: (web2c)mf invocation. Creating typeface families.
* mft: (web2c)mft invocation. Prettyprinting Metafont source.
diff --git a/Master/texmf/doc/info/dvipng.info b/Master/texmf/doc/info/dvipng.info
index 0b9be7c8220..7e25b004068 100644
--- a/Master/texmf/doc/info/dvipng.info
+++ b/Master/texmf/doc/info/dvipng.info
@@ -1,5 +1,4 @@
-This is dvipng.info, produced by makeinfo version 4.12 from
-../../../TeXlive-svn/texk/dvipng/dvipng.texi.
+This is dvipng.info, produced by makeinfo version 4.13 from dvipng.texi.
INFO-DIR-SECTION TeX
START-INFO-DIR-ENTRY
@@ -16,7 +15,7 @@ dvipng
This manual documents dvipng, a program to translate a DVI (DeVice
Independent) file into PNG (Portable Network Graphics).
- This file documents dvipng version 1.11
+ This file documents dvipng version 1.12
Corrections or perhaps rewrites of sections are _very welcome_.
@@ -327,7 +326,7 @@ File: dvipng.info, Node: Option summary, Next: Option details, Up: Command-li
Here is a handy summary of the options; it is printed out when you run
dvipng with no arguments or with the standard `--help' option.
- This is ./dvipng 1.10 Copyright 2002-2008 Jan-Ake Larsson
+ This is ./dvipng 1.12 Copyright 2002-2008 Jan-Ake Larsson
Usage: ./dvipng [OPTION]... FILENAME[.dvi]
Options are chosen to be similar to dvips' options where possible:
@@ -1056,29 +1055,29 @@ Index

Tag Table:
-Node: Top330
-Node: Introduction1225
-Node: Installation3464
-Node: Prerequisites3811
-Node: Configure6301
-Node: Build/install8340
-Node: Installation outside the texmf tree8808
-Node: Advice for non-privileged users9515
-Node: Basic usage10523
-Node: Command-line options11650
-Node: Option summary12074
-Node: Option details14383
-Node: Graphics29762
-Node: Encapsulated PostScript30327
-Node: Bitmapped graphics31670
-Node: Color32870
-Node: Color specifications33258
-Node: Color specials34357
-Node: Diagnosing problems35769
-Node: Contact information36252
-Node: Debug options36993
-Node: Credits38028
-Node: Copying39190
-Node: Index39970
+Node: Top297
+Node: Introduction1192
+Node: Installation3431
+Node: Prerequisites3778
+Node: Configure6268
+Node: Build/install8307
+Node: Installation outside the texmf tree8775
+Node: Advice for non-privileged users9482
+Node: Basic usage10490
+Node: Command-line options11617
+Node: Option summary12041
+Node: Option details14350
+Node: Graphics29729
+Node: Encapsulated PostScript30294
+Node: Bitmapped graphics31637
+Node: Color32837
+Node: Color specifications33225
+Node: Color specials34324
+Node: Diagnosing problems35736
+Node: Contact information36219
+Node: Debug options36960
+Node: Credits37995
+Node: Copying39157
+Node: Index39937

End Tag Table
diff --git a/Master/texmf/doc/info/dvips.info b/Master/texmf/doc/info/dvips.info
index 681a6779397..007024dca84 100644
--- a/Master/texmf/doc/info/dvips.info
+++ b/Master/texmf/doc/info/dvips.info
@@ -1,6 +1,7 @@
-This is dvips.info, produced by makeinfo version 4.12 from dvips.texi.
+This is ../../../texk/dvipsk/dvips.info, produced by makeinfo version
+4.13 from ../../../texk/dvipsk/dvips.texi.
-This manual documents Dvips version 5.97 (July 2008), a program to
+This manual documents Dvips version 5.98 (September 2009), a program to
translate a DVI file into PostScript. You may freely use, modify
and/or distribute this file.
@@ -17,7 +18,7 @@ File: dvips.info, Node: Top, Next: Why Dvips, Up: (dir)
Dvips
*****
-This manual documents Dvips version 5.97 (July 2008), a program to
+This manual documents Dvips version 5.98 (September 2009), a program to
translate a DVI file into PostScript. You may freely use, modify
and/or distribute this file.
@@ -724,7 +725,8 @@ reversal, use `-r0'. Such options are marked with a trailing `*'.
`-G*'
Shift non-printing characters (ASCII 0-32, 127) to higher-numbered
- positions. This may be useful sometimes.
+ positions. This was useful to work around bugs in old versions of
+ Adobe's PDF reader. It's more likely to cause problems nowadays.
`-h NAME'
Prepend NAME as an additional header file, or, if NAME is `-',
@@ -930,13 +932,18 @@ reversal, use `-r0'. Such options are marked with a trailing `*'.
once for `landscape'.
- In general, you should not use any `-t' option when using a
- `papersize' special, as some LaTeX packages do, e.g.,
- `hyperref.sty'.
+ `papersize' special, which some LaTeX packages (e.g.,
+ `hyperref') insert.
- - The exception is when using a nonstandard paper size that is
+ - One exception is when using a nonstandard paper size that is
not already defined in `config.ps'; in this case, you need to
specify `-t unknown'.
+ - Another exception is when producing multi-page files for
+ further processing; use `-t nopaper' to omit any paper size
+ information in the output. (If you just have a single page
+ document, you can use `-E' to get pure EPSF output.)
+
`-T HSIZE,VSIZE'
Set the paper size to (HSIZE,VSIZE), a comma-separated pair of
dimensions such as `.1in,-.3cm' (*note papersize special::). It
@@ -1208,6 +1215,10 @@ There is no provision for continuation lines.
`F'
Run as a filter. Same as `-f', *note Option details::.
+`G*'
+ Shift low-numbered characters; obsolete. Same as `-G', *note
+ Option details::.
+
`h HEADER'
Prepend HEADER to output. Same as `h-', *note Option details::.
@@ -1475,24 +1486,24 @@ For example:
When Dvips has a paper format name given on the command line, it
looks for a match by the NAME; when it has a `papersize' special, it
looks for a match by dimensions. The best match found (from the paper
-size information in the configuration file) is used. If nothing
-matches, a warning is printed and the first paper size is used. The
-dimensions must match within 5bp. Landscape mode for all paper sizes
-is automatically supported.
+size information in the configuration file) is used. The dimensions
+must match within 5bp.
+
+ If nothing matches, a warning is printed and the first paper size
+with zero dimensions is used; this should be the `unknown' paper size
+definition mentioned below, resulting in the actual dimensions being
+used.
+
+ Landscape mode for all paper sizes is automatically supported.
If your printer has a command to set a special paper size, then give
dimensions of `0in 0in'; the PostScript code that sets the paper size
can refer to the dimensions the user requested as `hsize' and `vsize';
these will be macros defined in the PostScript that return the
-requested size in default PostScript units. Virtually all of the
-PostScript commands you use here are device-dependent and degrade the
-portability of the file; that is why the default first paper size entry
-should not send any PostScript commands down (although a structured
-comment or two would be okay). Also, some printers want
+requested size in default PostScript units. Also, some printers want
`BeginPaperSize' comments and paper size setting commands; others (such
as the NeXT) want `PaperSize' comments and they will handle setting the
-paper size. There is no solution I could find that works for both
-(except maybe specifying both).
+paper size. So paper size entries should typically specify both.
When using a paper size that is not already defined in `config.ps',
you probably want to say `-t unknown' on the command line; the
@@ -1500,6 +1511,11 @@ you probably want to say `-t unknown' on the command line; the
PostScript incantation to set the PostScript page size, as just
described.
+ If you want no paper size information in the output at all, use
+`-t nopaper'. This is useful with multi-page output that will be
+processed further. If you just have a single page document, you can
+use `-E' to get pure EPSF output.
+
The Perl 5 script `contrib/configs/mkdvipspapers' in the
distribution directory may help in determining appropriate paper size
definitions.
@@ -3332,24 +3348,11 @@ and constructs. Each line has the format:
For example, the line
rpstrn StoneInformal <StoneInformal.pfb
- causes Dvips to download `StoneInformal.pfb' if your document (just
-as if it were a header file, *note Header files::) uses the font
-`StoneInformal'.
-
- If the `j' config file or command-line option is enabled,
-`StoneInformal.pfb' will be "partially downloaded"--only those
-characters your document actually uses will be extracted and downloaded,
-and the remainder discarded. *Note Option details::.
-
- Filenames of fonts that are partially downloaded are surrounded by
-curly braces (`{...}') in the progress report Dvips writes to standard
-output. Wholly-downloaded fonts appear inside angle brackets
-(`<...>'), like other downloaded files.
-
- Adobe Multiple Master fonts, such as Minion, cannot be partially
-downloaded. To partially download in general, but avoid partial
-downloading for individual fonts, use `<<' instead `<':
- pmnr8r Minion <<Minion.pfb
+ causes Dvips to download `StoneInformal.pfb' (just as if it were a
+header file, *note Header files::) if the DVI file (or a virtual font,
+*note Virtual fonts::) references the TFM file `rpstrn'. The
+PostScript `/FontName' of the font defined inside the `pfb' file should
+be `StoneInformal'.
You can generate transformed fonts with a line like this:
rpstrc StoneInformal <StoneInformal.pfb ".8 ExtendFont"
@@ -3387,6 +3390,16 @@ conversion yourself. In addition, Dvips scans the font to determine its
memory usage, just as it does for other header files (*note Header
files::).
+ If the `j' config file or command-line option is enabled (as it is
+by default), `StoneInformal.pfb' will be "partially downloaded"--only
+those characters your document actually uses will be extracted and
+downloaded, and the remainder discarded. *Note Option details::.
+
+ Adobe Multiple Master fonts, such as Minion, cannot be partially
+downloaded. To partially download in general, but avoid partial
+downloading for individual fonts, use `<<' instead `<':
+ pmnr8r Minion <<Minion.pfb
+
Here is a brief summary of how `psfonts.map' is read:
1. If a line is empty or begins with a space, percent, asterisk,
@@ -3417,10 +3430,12 @@ files::).
verbatim at the appropriate point. (And the double quotes
beginning and ending the word are removed.)
- 7. Otherwise the word is a name. The first such name is the TFM file
- that a virtual font file can refer to. If there is a second name,
- it is used as the PostScript name; if there is only one name, it
- is used for both the TeX name and the PostScript name.
+ 7. Otherwise the word is a name. The first such name is the TFM file,
+ that either a DVI file or a virtual font file can refer to. If
+ there is a second name, it is used as the PostScript name and
+ should match what is defined in the downloaded file; if there is
+ only one name, it is used for both the TeX name and the PostScript
+ name.

@@ -3760,12 +3775,12 @@ Index
* Menu:
* ! special (literal PS header): Literal headers. (line 6)
-* ! starting output filename: Option details. (line 223)
+* ! starting output filename: Option details. (line 224)
* " special (literal PostScript): " special. (line 6)
* %%BoundingBox: Bounding box. (line 17)
* %%Page, and multi-page information: PostScript hooks. (line 37)
-* %%Page, not generating: Option details. (line 197)
-* %%Page, removing: Option details. (line 153)
+* %%Page, not generating: Option details. (line 198)
+* %%Page, removing: Option details. (line 154)
* %%Page, required by Ghostview: Ghostscript installation.
(line 17)
* %%VMusage: Headers and memory usage.
@@ -3773,9 +3788,9 @@ Index
* %*Font: Fonts in figures. (line 6)
* (atend), bounding box specification: Bounding box. (line 28)
* +PSMAPFILE: Configuration file commands.
- (line 101)
+ (line 105)
* -: Option details. (line 11)
-* - as output filename: Option details. (line 223)
+* - as output filename: Option details. (line 224)
* --help <1>: Option details. (line 15)
* --help: Option summary. (line 7)
* --version: Option details. (line 18)
@@ -3794,71 +3809,71 @@ Index
* -F: Option details. (line 110)
* -f: Option details. (line 98)
* -G: Option details. (line 117)
-* -h NAME: Option details. (line 121)
-* -i: Option details. (line 126)
-* -j for partial font downloading: Option details. (line 139)
-* -K: Option details. (line 153)
-* -k for cropmarks: Option details. (line 145)
-* -l [=]NUM: Option details. (line 162)
-* -M: Option details. (line 183)
-* -m: Option details. (line 171)
-* -mode: Option details. (line 174)
-* -mode MODE: Option details. (line 174)
-* -N: Option details. (line 197)
-* -n NUM: Option details. (line 194)
-* -noomega: Option details. (line 205)
+* -h NAME: Option details. (line 122)
+* -i: Option details. (line 127)
+* -j for partial font downloading: Option details. (line 140)
+* -K: Option details. (line 154)
+* -k for cropmarks: Option details. (line 146)
+* -l [=]NUM: Option details. (line 163)
+* -M: Option details. (line 184)
+* -m: Option details. (line 172)
+* -mode: Option details. (line 175)
+* -mode MODE: Option details. (line 175)
+* -N: Option details. (line 198)
+* -n NUM: Option details. (line 195)
+* -noomega: Option details. (line 206)
* -O: Afm2tfm options. (line 41)
-* -o NAME: Option details. (line 218)
-* -O X-OFFSET,Y-OFFSET: Option details. (line 235)
-* -p [=]NUM: Option details. (line 253)
-* -P PRINTER: Option details. (line 267)
+* -o NAME: Option details. (line 219)
+* -O X-OFFSET,Y-OFFSET: Option details. (line 236)
+* -p [=]NUM: Option details. (line 254)
+* -P PRINTER: Option details. (line 268)
* -p PS-ENC <1>: Afm2tfm options. (line 46)
* -p PS-ENC: Changing PostScript encodings.
(line 6)
-* -pp FIRST-LAST: Option details. (line 262)
-* -pp RANGE: Option details. (line 262)
+* -pp FIRST-LAST: Option details. (line 263)
+* -pp RANGE: Option details. (line 263)
* -PPRINTER, and config file searching: Configuration file searching.
(line 27)
-* -q: Option details. (line 286)
-* -R: Option details. (line 293)
-* -r: Option details. (line 290)
-* -s: Option details. (line 301)
-* -S NUM: Option details. (line 308)
+* -q: Option details. (line 287)
+* -R: Option details. (line 294)
+* -r: Option details. (line 291)
+* -s: Option details. (line 302)
+* -S NUM: Option details. (line 309)
* -s SLANT: Afm2tfm options. (line 51)
* -T ENC-FILE: Changing both encodings.
(line 6)
-* -T HSIZE,VSIZE: Option details. (line 332)
-* -t PAPERTYPE: Option details. (line 313)
+* -T HSIZE,VSIZE: Option details. (line 338)
+* -t PAPERTYPE: Option details. (line 314)
* -T PS-TEX-ENC: Afm2tfm options. (line 61)
* -t TEX-ENC <1>: Afm2tfm options. (line 56)
* -t TEX-ENC: Changing TeX encodings.
(line 6)
* -u: Afm2tfm options. (line 65)
-* -U: Option details. (line 347)
-* -u PSMAPFILE: Option details. (line 339)
-* -V: Option details. (line 358)
-* -v: Option details. (line 355)
+* -U: Option details. (line 353)
+* -u PSMAPFILE: Option details. (line 345)
+* -V: Option details. (line 364)
+* -v: Option details. (line 361)
* -V VPL-FILE: Afm2tfm options. (line 74)
* -v VPL-FILE: Afm2tfm options. (line 71)
-* -X NUM: Option details. (line 375)
-* -x NUM: Option details. (line 367)
-* -Y NUM: Option details. (line 382)
+* -X NUM: Option details. (line 381)
+* -x NUM: Option details. (line 373)
+* -Y NUM: Option details. (line 388)
* -z: Hypertext. (line 6)
-* -Z for compressing bitmap fonts: Option details. (line 391)
-* -z for recognizing hyperdvi: Option details. (line 385)
-* ..-relative filenames: Option details. (line 293)
+* -Z for compressing bitmap fonts: Option details. (line 397)
+* -z for recognizing hyperdvi: Option details. (line 391)
+* ..-relative filenames: Option details. (line 294)
* .afm Adobe metric files: Metric files. (line 26)
* .dvipsrc, searched for: Configuration file searching.
(line 14)
-* .enc extension for encoding vectors: psfonts.map. (line 55)
+* .enc extension for encoding vectors: psfonts.map. (line 42)
* .lpro long prologue files: Header files. (line 12)
* .mf Metafont source files: Glyph files. (line 30)
* .NNNpk packed font bitmaps: Glyph files. (line 35)
* .pfa extension required for partial downloading: psfonts.map.
- (line 59)
+ (line 46)
* .pfa printer font ascii files: Glyph files. (line 25)
* .pfb extension required for partial downloading: psfonts.map.
- (line 59)
+ (line 46)
* .pfb printer font binary files: Glyph files. (line 25)
* .pfm printer font metric files: Metric files. (line 49)
* .pl property list files: Metric files. (line 39)
@@ -3869,11 +3884,11 @@ Index
* 612 792 bounding box size: Bounding box. (line 43)
* 8r encoding, and extra characters: Changing PostScript encodings.
(line 24)
-* 8r font encoding: psfonts.map. (line 44)
+* 8r font encoding: psfonts.map. (line 31)
* 8r.enc: Encodings. (line 35)
* < font downloading: psfonts.map. (line 11)
-* << whole font downloading: psfonts.map. (line 27)
-* <[ encoding vector downloading: psfonts.map. (line 49)
+* << whole font downloading: psfonts.map. (line 60)
+* <[ encoding vector downloading: psfonts.map. (line 36)
* =: ligature operation: Encoding file format.
(line 59)
* @ paper size config command: Configuration file commands.
@@ -3901,15 +3916,15 @@ Index
(line 21)
* A ring, Scandinavian letter: Reencoding with Afm2tfm.
(line 32)
-* a3 papertype: Option details. (line 313)
+* a3 papertype: Option details. (line 314)
* a4 paper size: Config file paper sizes.
- (line 79)
-* a4 papertype: Option details. (line 313)
+ (line 84)
+* a4 papertype: Option details. (line 314)
* A4size paper size: Config file paper sizes.
- (line 87)
-* absolute filenames, disabling: Option details. (line 293)
-* absolute page number, and -l: Option details. (line 162)
-* absolute page number, and -p: Option details. (line 253)
+ (line 92)
+* absolute filenames, disabling: Option details. (line 294)
+* absolute page number, and -l: Option details. (line 163)
+* absolute page number, and -p: Option details. (line 254)
* accents, in wrong position: Reencoding with Afm2tfm.
(line 32)
* accents, wrong: Afm2tfm options. (line 17)
@@ -3936,7 +3951,7 @@ Index
* b config command (#copies): Configuration file commands.
(line 24)
* base: Hypertext specials. (line 57)
-* base encoding, recommended: psfonts.map. (line 44)
+* base encoding, recommended: psfonts.map. (line 31)
* base fonts: Virtual fonts. (line 24)
* bbfig: Bounding box. (line 37)
* before header, inserting code: Including headers from TeX.
@@ -3954,7 +3969,7 @@ Index
* bop-hook <1>: PostScript hooks. (line 11)
* bop-hook <2>: EPSF scaling. (line 75)
* bop-hook: Paper trays. (line 6)
-* bop-hook, and offset pages: Option details. (line 248)
+* bop-hook, and offset pages: Option details. (line 249)
* boundary character: Encoding file format.
(line 41)
* bounding box, comment for: Bounding box. (line 6)
@@ -3998,21 +4013,21 @@ Index
(line 13)
* comments, in encoding files: Encoding file format.
(line 20)
-* comments, removing included: Option details. (line 153)
+* comments, removing included: Option details. (line 154)
* compilation: Installation. (line 6)
* compressed PostScript: Dynamic creation of graphics.
(line 6)
-* compressing bitmap fonts: Option details. (line 391)
+* compressing bitmap fonts: Option details. (line 397)
* Computer Modern in PostScript: Hypertext caveats. (line 6)
* Computer Modern, encoding of: Encodings. (line 15)
* condensed fonts: Afm2tfm options. (line 37)
* config.proto: config.ps installation.
(line 15)
-* config.ps: Option details. (line 267)
+* config.ps: Option details. (line 268)
* config.ps installation: config.ps installation.
(line 6)
* config.ps paper sizes: Config file paper sizes.
- (line 79)
+ (line 84)
* config.ps, searched for: Configuration file searching.
(line 10)
* configuration file options: Configuration file commands.
@@ -4038,8 +4053,8 @@ Index
* copies, duplicated page bodies: Option details. (line 31)
* copies, uncollated: Option details. (line 41)
* Crayola crayon box: Color macro files. (line 16)
-* crop.pro: Option details. (line 145)
-* cropmarks: Option details. (line 145)
+* crop.pro: Option details. (line 146)
+* cropmarks: Option details. (line 146)
* current font, in PostScript: PostScript typesetting.
(line 35)
* D config command (dpi): Configuration file commands.
@@ -4051,25 +4066,25 @@ Index
* debugging: Diagnosing problems. (line 6)
* debugging options: Debug options. (line 6)
* default resolutions: Configuration file commands.
- (line 123)
+ (line 127)
* default_texsizes Make variable: Configuration file commands.
- (line 139)
+ (line 143)
* Deutsch, Peter: Ghostscript installation.
(line 6)
* device dependency, and virtual fonts: Configuration file commands.
- (line 162)
+ (line 166)
* dictionary, CharStrings: PostScript typesetting.
(line 51)
* dictionary, PostScript language: PostScript typesetting.
(line 35)
* dictionary, SDict: Literal headers. (line 6)
* dictionary, userdict: Header files. (line 21)
-* distillation, and -z: Option details. (line 385)
+* distillation, and -z: Option details. (line 391)
* distiller, for PDF files: Hypertext. (line 11)
* dot accent: Reencoding with Afm2tfm.
(line 32)
* double-sided printing: Option details. (line 37)
-* downloading fonts partially: psfonts.map. (line 17)
+* downloading fonts partially: psfonts.map. (line 55)
* downloading PostScript fonts: psfonts.map. (line 6)
* Doyle, Mark: Hypertext. (line 21)
* draft copies: PostScript hooks. (line 16)
@@ -4088,7 +4103,7 @@ Index
* DVIPSHEADERS: Environment variables.
(line 31)
* DVIPSHEADERS, overrides H: Configuration file commands.
- (line 47)
+ (line 51)
* DVIPSMAKEPK: Environment variables.
(line 35)
* DVIPSRC: Environment variables.
@@ -4096,7 +4111,7 @@ Index
* DVIPSSIZES: Environment variables.
(line 46)
* DVIPSSIZES, overrides R: Configuration file commands.
- (line 136)
+ (line 140)
* dynamic creation of graphics: Dynamic creation of graphics.
(line 6)
* e config command (maxdrift): Configuration file commands.
@@ -4134,7 +4149,7 @@ Index
* error messages from printer: Printer errors. (line 6)
* even pages only: Option details. (line 37)
* examples of literal PostScript: Literal examples. (line 6)
-* expanded fonts <1>: psfonts.map. (line 32)
+* expanded fonts <1>: psfonts.map. (line 19)
* expanded fonts <2>: Afm2tfm options. (line 37)
* expanded fonts: Special font effects.
(line 24)
@@ -4154,14 +4169,14 @@ Index
(line 6)
* failure, to print at all: No output. (line 6)
* fallback resolutions: Configuration file commands.
- (line 123)
+ (line 127)
* figures and fonts: Fonts in figures. (line 6)
* figures, natural size: EPSF macros. (line 38)
* figures, scaling: EPSF scaling. (line 6)
* filter, running as a: Option details. (line 98)
-* first page printed: Option details. (line 253)
+* first page printed: Option details. (line 254)
* font concepts: Font concepts. (line 6)
-* font generation, avoiding: Option details. (line 183)
+* font generation, avoiding: Option details. (line 184)
* fontinst: Invoking afm2tfm. (line 13)
* fonts, as header files: Including headers from TeX.
(line 13)
@@ -4183,6 +4198,8 @@ Index
(line 34)
* fonts, system PostScript: PostScript font installation.
(line 24)
+* G character shifting config command: Configuration file commands.
+ (line 44)
* gf files: Glyph files. (line 41)
* gftopk: Glyph files. (line 41)
* Ghostscript installation: Ghostscript installation.
@@ -4193,7 +4210,7 @@ Index
(line 17)
* glyph files: Glyph files. (line 6)
* GLYPHFONTS, overrides P: Configuration file commands.
- (line 110)
+ (line 114)
* GNU Ghostscript: Ghostscript installation.
(line 13)
* gnuplot: Dynamic creation of graphics.
@@ -4203,16 +4220,16 @@ Index
* gs installation: Ghostscript installation.
(line 6)
* gsave/grestore, and literal PS: Literal examples. (line 27)
-* gsftopk: Option details. (line 359)
+* gsftopk: Option details. (line 365)
* h header downloading config command: Configuration file commands.
- (line 44)
+ (line 48)
* H header path config command: Configuration file commands.
- (line 47)
+ (line 51)
* Hafner, Jim: Color. (line 6)
-* header file, downloading: Option details. (line 121)
+* header file, downloading: Option details. (line 122)
* header files, defined: Header files. (line 6)
* header path, defining: Configuration file commands.
- (line 47)
+ (line 51)
* header=FILE \special: Including headers from TeX.
(line 6)
* headers and memory usage: Headers and memory usage.
@@ -4231,18 +4248,18 @@ Index
* hscale (psfile special option): psfile special. (line 30)
* hsize (psfile special option): psfile special. (line 24)
* html specials: Hypertext. (line 6)
-* html specials, and -z: Option details. (line 385)
+* html specials, and -z: Option details. (line 391)
* http://www.win.tue.nl/~dickie/idvi: Hypertext. (line 21)
* http://xxx.lanl.gov/hypertex: Hypertext. (line 21)
* Hungarian umlaut: Reencoding with Afm2tfm.
(line 32)
-* hyperdvi extensions, enabling: Option details. (line 385)
+* hyperdvi extensions, enabling: Option details. (line 391)
* hypertext and bitmap fonts: Hypertext caveats. (line 6)
* hypertext caveats: Hypertext caveats. (line 6)
* hypertext specials: Hypertext specials. (line 6)
* hypertext support: Hypertext. (line 6)
* i config command (pages/section): Configuration file commands.
- (line 51)
+ (line 55)
* idvi Java DVI reader: Hypertext. (line 21)
* Illustrator, workaround for: Including graphics fails.
(line 10)
@@ -4265,31 +4282,31 @@ Index
* inverted output: Small or inverted. (line 6)
* invoking Dvips: Invoking Dvips. (line 6)
* j config command (partial font downloading): Configuration file commands.
- (line 55)
+ (line 59)
* Java DVI reader: Hypertext. (line 21)
* Jeffrey, Alan: Invoking afm2tfm. (line 13)
-* K config command (comment-removeal): Configuration file commands.
- (line 59)
+* K config command (comment-removal): Configuration file commands.
+ (line 63)
* kerning, defined: Metric files. (line 15)
* KPATHSEA_DEBUG: Environment variables.
(line 18)
* landscape orientation, defined: Paper size and landscape.
(line 11)
-* landscape papertype: Option details. (line 313)
+* landscape papertype: Option details. (line 314)
* landscape, as \special: papersize special. (line 16)
-* last page printed: Option details. (line 162)
+* last page printed: Option details. (line 163)
* last-resort font scaling, with DVIPSSIZES: Environment variables.
(line 47)
* last-resort scaling, with R: Configuration file commands.
- (line 123)
-* ledger papertype: Option details. (line 313)
-* legal papertype: Option details. (line 313)
+ (line 127)
+* ledger papertype: Option details. (line 314)
+* legal papertype: Option details. (line 314)
* letter paper size: Config file paper sizes.
- (line 79)
-* letter papertype: Option details. (line 313)
+ (line 84)
+* letter papertype: Option details. (line 314)
* letterhead tray: Paper trays. (line 10)
* letterSize paper size: Config file paper sizes.
- (line 87)
+ (line 92)
* ligature operations: Encoding file format.
(line 54)
* ligature, defined: Metric files. (line 15)
@@ -4304,26 +4321,26 @@ Index
* lly (psfile special option): psfile special. (line 42)
* long documents not printing: Long documents fail. (line 6)
* low characters, shifting: Option details. (line 117)
-* lpr spooler, MS-DOS emulation: Option details. (line 223)
+* lpr spooler, MS-DOS emulation: Option details. (line 224)
* Lucida, installing: PostScript font installation.
(line 10)
* m config command (available memory): Configuration file commands.
- (line 63)
+ (line 67)
* M config command (mf mode): Configuration file commands.
- (line 82)
+ (line 86)
* macros for color: Color macro files. (line 6)
* macros for epsf inclusion <1>: EPSF macros. (line 6)
* macros for epsf inclusion: \includegraphics. (line 6)
* magnification, DVI: EPSF scaling. (line 63)
-* magnification, overriding DVI: Option details. (line 367)
-* magnification, vertical: Option details. (line 378)
+* magnification, overriding DVI: Option details. (line 373)
+* magnification, vertical: Option details. (line 384)
* mailcap and hypertext: Hypertext specials. (line 53)
-* manual feed: Option details. (line 171)
+* manual feed: Option details. (line 172)
* maxdrift: Option details. (line 71)
-* maximum pages printed: Option details. (line 194)
-* media: Option details. (line 313)
+* maximum pages printed: Option details. (line 195)
+* media: Option details. (line 314)
* memory available: Configuration file commands.
- (line 63)
+ (line 67)
* memory of printer exhausted: Printer errors. (line 14)
* memory usage, and headers: Headers and memory usage.
(line 6)
@@ -4332,45 +4349,47 @@ Index
(line 104)
* Metafont ligature operations: Encoding file format.
(line 54)
-* Metafont mode, specifying: Option details. (line 174)
+* Metafont mode, specifying: Option details. (line 175)
* Metafont source files: Glyph files. (line 30)
* metric files: Metric files. (line 6)
-* Minion typeface family: psfonts.map. (line 27)
-* missfont.log: Option details. (line 183)
-* MISSFONT_LOG: Option details. (line 186)
+* Minion typeface family: psfonts.map. (line 60)
+* missfont.log: Option details. (line 184)
+* MISSFONT_LOG: Option details. (line 187)
* Mitsubishi Shinko CHC-S446i printer: No output. (line 14)
* mkdvipspapers: Config file paper sizes.
- (line 75)
-* mktexpk, avoiding: Option details. (line 183)
+ (line 80)
+* mktexpk, avoiding: Option details. (line 184)
* mktexpk, changing name: Environment variables.
(line 36)
-* mode name, specifying: Option details. (line 174)
+* mode name, specifying: Option details. (line 175)
* Monotype fonts: PostScript font installation.
(line 10)
* Monotype fonts, installing: PostScript font installation.
(line 19)
-* mtpk: Option details. (line 359)
-* multiple master fonts: psfonts.map. (line 27)
-* multiple output files: Option details. (line 126)
+* mtpk: Option details. (line 365)
+* multiple master fonts: psfonts.map. (line 60)
+* multiple output files: Option details. (line 127)
* multiple paper trays: Paper trays. (line 6)
* Murphy, Tim: Hypertext specials. (line 20)
* N EPS-disabling config command: Configuration file commands.
- (line 85)
+ (line 89)
* name: Hypertext specials. (line 41)
-* narrow fonts: psfonts.map. (line 32)
+* narrow fonts: psfonts.map. (line 19)
* no output at all: No output. (line 6)
* non-printing characters, shifting: Option details. (line 117)
* non-resident fonts: psfonts.map. (line 6)
+* nopaper, paper format for -t: Config file paper sizes.
+ (line 75)
* O config command (offset): Configuration file commands.
- (line 98)
+ (line 102)
* o config command (output file): Configuration file commands.
- (line 90)
+ (line 94)
* oblique fonts: Special font effects.
(line 6)
* octal character codes: Afm2tfm options. (line 41)
* odd pages only: Option details. (line 27)
-* offset pages: Option details. (line 235)
-* Omega extensions: Option details. (line 205)
+* offset pages: Option details. (line 236)
+* Omega extensions: Option details. (line 206)
* option, details of: Option details. (line 6)
* options, debugging: Debug options. (line 6)
* options, Dvips: Invoking Dvips. (line 6)
@@ -4383,20 +4402,20 @@ Index
* output file, sectioning of: Headers and memory usage.
(line 6)
* output file, setting: Configuration file commands.
- (line 90)
-* output files, multiple: Option details. (line 126)
+ (line 94)
+* output files, multiple: Option details. (line 127)
* output, inverted: Small or inverted. (line 6)
* output, none: No output. (line 6)
-* output, redirecting: Option details. (line 218)
+* output, redirecting: Option details. (line 219)
* output, too small: Small or inverted. (line 6)
* p config command (font aliases): Configuration file commands.
- (line 101)
+ (line 105)
* P config command (PK path): Configuration file commands.
- (line 110)
-* page range: Option details. (line 262)
-* page, first printed: Option details. (line 253)
-* page, last printed: Option details. (line 162)
-* pages, maximum printed: Option details. (line 194)
+ (line 114)
+* page range: Option details. (line 263)
+* page, first printed: Option details. (line 254)
+* page, last printed: Option details. (line 163)
+* pages, maximum printed: Option details. (line 195)
* PaintType: Special font effects.
(line 50)
* Pantone colors: Color macro files. (line 16)
@@ -4407,32 +4426,32 @@ Index
* paper size, general: Paper size and landscape.
(line 6)
* paper trays: Paper trays. (line 6)
-* paper type: Option details. (line 313)
+* paper type: Option details. (line 314)
* papersize special: papersize special. (line 6)
-* papersize special, and no -t: Option details. (line 313)
-* partial font downloading: psfonts.map. (line 17)
+* papersize special, and no -t: Option details. (line 314)
+* partial font downloading: psfonts.map. (line 55)
* PDF files, font quality: Hypertext caveats. (line 6)
* PDF files, making <1>: Hypertext. (line 11)
* PDF files, making: Ghostscript installation.
(line 6)
-* PDF files, option for: Option details. (line 385)
+* PDF files, option for: Option details. (line 391)
* pdfmark: Hypertext. (line 6)
* pfa files: Glyph files. (line 25)
* pfb files: Glyph files. (line 25)
-* pfb files, automatically unpacked: psfonts.map. (line 62)
+* pfb files, automatically unpacked: psfonts.map. (line 49)
* pfm files: Metric files. (line 49)
* Phaser printer, used for color calibration: Color device configuration.
(line 18)
-* physical page number, and -l: Option details. (line 162)
-* physical page number, and -p: Option details. (line 253)
+* physical page number, and -l: Option details. (line 163)
+* physical page number, and -p: Option details. (line 254)
* physical page number, and bop-hook: PostScript hooks. (line 26)
* pipes, not readable: Option details. (line 98)
* pk files: Glyph files. (line 35)
* PKFONTS, overrides P: Configuration file commands.
- (line 110)
+ (line 114)
* plotfile, ps subspecial: ps special. (line 30)
* pltotf: Metric files. (line 39)
-* popen for output: Option details. (line 223)
+* popen for output: Option details. (line 224)
* portrait orientation, defined: Paper size and landscape.
(line 11)
* positioning accuracy: Option details. (line 71)
@@ -4443,8 +4462,8 @@ Index
* PostScript encoding, changing: Changing PostScript encodings.
(line 6)
* PostScript font alias file <1>: Configuration file commands.
- (line 101)
-* PostScript font alias file: Option details. (line 339)
+ (line 105)
+* PostScript font alias file: Option details. (line 345)
* PostScript fonts: PostScript fonts. (line 6)
* PostScript fonts, installing: PostScript font installation.
(line 6)
@@ -4470,9 +4489,9 @@ Index
(line 15)
* printer errors: Printer errors. (line 6)
* printer memory: Configuration file commands.
- (line 63)
+ (line 67)
* printer memory exhausted: Printer errors. (line 14)
-* printer offset: Option details. (line 235)
+* printer offset: Option details. (line 236)
* PRINTER, and config file searching: Configuration file searching.
(line 36)
* PRINTER, avoided with -f: Option details. (line 98)
@@ -4490,43 +4509,43 @@ Index
(line 24)
* psheaderdir: Header files. (line 12)
* psi character missing: Hypertext caveats. (line 55)
-* pstopk: Option details. (line 359)
+* pstopk: Option details. (line 365)
* Q config command (quiet): Configuration file commands.
- (line 117)
+ (line 121)
* q config command (quiet): Configuration file commands.
- (line 117)
-* quiet operation: Option details. (line 286)
+ (line 121)
+* quiet operation: Option details. (line 287)
* r config command (page reversal): Configuration file commands.
- (line 120)
+ (line 124)
* R fallback resolution config command: Configuration file commands.
- (line 123)
+ (line 127)
* reencode/*.enc: Encodings. (line 35)
* reencoding: Reencoding with Afm2tfm.
(line 6)
-* reencoding PostScript fonts: psfonts.map. (line 37)
+* reencoding PostScript fonts: psfonts.map. (line 24)
* registered character, accessing: Changing PostScript encodings.
(line 18)
* remapping: Reencoding with Afm2tfm.
(line 6)
* resident fonts, different in different printers <1>: Configuration file commands.
- (line 101)
+ (line 105)
* resident fonts, different in different printers: Option details.
- (line 339)
-* resolution: Option details. (line 375)
+ (line 345)
+* resolution: Option details. (line 381)
* resolution, setting: Option details. (line 58)
-* reverse pagination: Option details. (line 290)
+* reverse pagination: Option details. (line 291)
* rhi (psfile special option): psfile special. (line 46)
* Rokicki, Tomas: Why Dvips. (line 68)
* rotate.tex: ps special. (line 34)
* rwi (psfile special option): psfile special. (line 46)
* S config command (pict path): Configuration file commands.
- (line 148)
+ (line 152)
* s config command (save/restore): Configuration file commands.
- (line 145)
+ (line 149)
* save/restore, and inverted output: Small or inverted. (line 6)
* save/restore, and literal PS: Literal examples. (line 27)
* save/restore, and specials: ps special. (line 6)
-* save/restore, generating global: Option details. (line 301)
+* save/restore, generating global: Option details. (line 302)
* scaleunit: psfile special. (line 67)
* scaling of figures: EPSF scaling. (line 6)
* scaling small caps: Afm2tfm options. (line 33)
@@ -4540,15 +4559,15 @@ Index
(line 6)
* sections of output file, and memory: Headers and memory usage.
(line 6)
-* sections output, in separate files: Option details. (line 126)
-* security: Option details. (line 293)
-* shell command execution, disabling: Option details. (line 293)
+* sections output, in separate files: Option details. (line 127)
+* security: Option details. (line 294)
+* shell command execution, disabling: Option details. (line 294)
* shell escape, in config file: Configuration file commands.
(line 33)
* Shinko CHC-S446i printer: No output. (line 14)
* show PostScript operator: PostScript typesetting.
(line 23)
-* silent operation: Option details. (line 286)
+* silent operation: Option details. (line 287)
* simplex mode on duplex printers: Including headers from the command line.
(line 13)
* slanted fonts: Special font effects.
@@ -4567,21 +4586,21 @@ Index
* specials, hypertext: Hypertext specials. (line 6)
* splines: Glyph files. (line 17)
* spooler, lacking: Option details. (line 110)
-* spooling to lpr on MS-DOS: Option details. (line 223)
+* spooling to lpr on MS-DOS: Option details. (line 224)
* standard I/O: Option details. (line 98)
* standard input, reading options from: Option details. (line 11)
-* standard output, output to: Option details. (line 218)
+* standard output, output to: Option details. (line 219)
* standard PostScript, required by Ghostview: Ghostscript installation.
(line 17)
* start-hook: PostScript hooks. (line 11)
-* structured comments: Option details. (line 197)
+* structured comments: Option details. (line 198)
* system in config file: Configuration file commands.
(line 33)
* T config command (TFM path): Configuration file commands.
- (line 153)
+ (line 157)
* Tektronix Phaser printer, used for color calibration: Color device configuration.
(line 18)
-* testpage.tex: Option details. (line 242)
+* testpage.tex: Option details. (line 243)
* TeX encoding, changing: Changing TeX encodings.
(line 6)
* TeX, including headers in: Including headers from TeX.
@@ -4589,13 +4608,13 @@ Index
* TEXCONFIG: Environment variables.
(line 55)
* TEXFONTS, overrides P: Configuration file commands.
- (line 110)
+ (line 114)
* TEXFONTS, overrides T: Configuration file commands.
- (line 153)
+ (line 157)
* TEXINPUTS, overrides S: Configuration file commands.
- (line 148)
+ (line 152)
* texmext.enc: Encodings. (line 35)
-* TEXMFOUTPUT: Option details. (line 186)
+* TEXMFOUTPUT: Option details. (line 187)
* texmital.enc: Encodings. (line 35)
* texmsym.enc <1>: Changing TeX encodings.
(line 16)
@@ -4603,15 +4622,15 @@ Index
* TEXPICTS: Environment variables.
(line 62)
* TEXPICTS, overrides S: Configuration file commands.
- (line 148)
+ (line 152)
* TEXPKS, overrides P: Configuration file commands.
- (line 110)
+ (line 114)
* TEXSIZES, overrides R: Configuration file commands.
- (line 136)
+ (line 140)
* text in figures, chopped off: EPSF clipping. (line 6)
* tfm files: Metric files. (line 31)
* TFMFONTS, overrides T: Configuration file commands.
- (line 153)
+ (line 157)
* tftopl: Metric files. (line 39)
* Theisen, Tim: Ghostscript installation.
(line 17)
@@ -4620,18 +4639,20 @@ Index
* trademark character, accessing: Changing PostScript encodings.
(line 18)
* trailing spaces, dropped: Hypertext caveats. (line 55)
-* TranScript: Option details. (line 197)
-* transforming downloaded fonts: psfonts.map. (line 32)
+* TranScript: Option details. (line 198)
+* transforming downloaded fonts: psfonts.map. (line 19)
* trouble: Diagnosing problems. (line 6)
* Type 1 fonts: Glyph files. (line 25)
* typesetting in PostScript: PostScript typesetting.
(line 6)
* U config command (Xerox 4045): Configuration file commands.
- (line 158)
+ (line 162)
* uncollated copies: Option details. (line 41)
* uncompressing PostScript: Dynamic creation of graphics.
(line 6)
* uniform resource locator: Hypertext specials. (line 20)
+* unknown, paper format for -t <1>: Config file paper sizes.
+ (line 69)
* unknown, paper format for -t: papersize special. (line 29)
* URL, definition: Hypertext specials. (line 27)
* URL, extended for TeX: Hypertext specials. (line 20)
@@ -4640,14 +4661,14 @@ Index
* user-definable colors: User-definable colors.
(line 6)
* userdict, and dictionary files: Header files. (line 21)
-* userdict, used for header files: Option details. (line 121)
+* userdict, used for header files: Option details. (line 122)
* V config command (vf path): Configuration file commands.
- (line 162)
+ (line 166)
* verbose EPSF processing: EPSF macros. (line 46)
* vf files: Virtual fonts. (line 16)
* virtual font expansion: Virtual fonts. (line 34)
* virtual font path: Configuration file commands.
- (line 162)
+ (line 166)
* virtual fonts: Virtual fonts. (line 6)
* virtual fonts, creating: Invoking afm2tfm. (line 13)
* VM exhausted: Printer errors. (line 14)
@@ -4660,104 +4681,104 @@ Index
* vscale (psfile special option): psfile special. (line 33)
* vsize (psfile special option): psfile special. (line 27)
* W config command (warning): Configuration file commands.
- (line 167)
+ (line 171)
* warning messages, defining: Configuration file commands.
- (line 167)
-* warnings, suppressing: Option details. (line 286)
-* whole font downloading: psfonts.map. (line 27)
-* wide fonts: psfonts.map. (line 32)
+ (line 171)
+* warnings, suppressing: Option details. (line 287)
+* whole font downloading: psfonts.map. (line 60)
+* wide fonts: psfonts.map. (line 19)
* X config command (horizontal resolution): Configuration file commands.
- (line 174)
-* Xerox 4045: Option details. (line 347)
+ (line 178)
+* Xerox 4045: Option details. (line 353)
* Y config command (vertical resolution): Configuration file commands.
- (line 177)
+ (line 181)
* Y&Y fonts, installing: PostScript font installation.
(line 19)
* Z config command (compression): Configuration file commands.
- (line 180)
+ (line 184)
* z config command (secure mode): Configuration file commands.
- (line 183)
-* | starting output filename: Option details. (line 223)
+ (line 187)
+* | starting output filename: Option details. (line 224)

Tag Table:
-Node: Top517
-Node: Why Dvips1261
-Node: Installation4709
-Node: config.ps installation5847
-Node: PostScript font installation8389
-Node: Ghostscript installation11263
-Node: Diagnosing problems12360
-Node: Debug options13455
-Node: No output14658
-Node: Small or inverted16126
-Node: Printer errors16845
-Node: Long documents fail18177
-Node: Including graphics fails18518
-Node: Invoking Dvips19756
-Node: Basic usage20347
-Node: Command-line options21331
-Node: Option summary21780
-Node: Option details23942
-Node: Environment variables42575
-Node: Config files45534
-Node: Configuration file searching46217
-Node: Configuration file commands49517
-Node: Paper size and landscape56534
-Node: papersize special58132
-Node: Config file paper sizes59541
-Node: Paper trays63613
-Node: Interaction with PostScript64947
-Node: PostScript figures65600
-Node: Bounding box66326
-Node: \includegraphics69697
-Node: EPSF macros71988
-Node: EPSF scaling73958
-Node: EPSF clipping76528
-Node: psfile special77170
-Node: Dynamic creation of graphics79563
-Node: Fonts in figures80881
-Node: Header files82541
-Node: Including headers from TeX83747
-Node: Including headers from the command line85781
-Node: Headers and memory usage86881
-Node: Literal PS87591
-Node: " special88173
-Node: ps special88914
-Node: Literal headers90412
-Node: PostScript hooks91127
-Node: Literal examples93217
-Node: Hypertext94669
-Node: Hypertext caveats96227
-Node: Hypertext specials100624
-Node: PostScript fonts103258
-Node: Font concepts104374
-Node: Metric files105541
-Node: Glyph files108367
-Node: Virtual fonts110723
-Node: Encodings112613
-Node: PostScript typesetting114995
-Node: Making a font available118077
-Node: Invoking afm2tfm123107
-Node: Changing font encodings124077
-Node: Changing TeX encodings124867
-Node: Changing PostScript encodings125967
-Node: Changing both encodings127311
-Node: Reencoding with Afm2tfm127984
-Node: Encoding file format131088
-Node: Special font effects135291
-Node: Afm2tfm options137554
-Node: psfonts.map140539
-Node: Color145263
-Node: Color macro files146307
-Node: User-definable colors149505
-Node: Color subtleties150780
-Node: Ted Turner152431
-Node: Color device configuration153656
-Node: Color support details156098
-Node: Color specifications156476
-Node: Color specials157879
-Node: Index160008
+Node: Top564
+Node: Why Dvips1313
+Node: Installation4761
+Node: config.ps installation5899
+Node: PostScript font installation8441
+Node: Ghostscript installation11315
+Node: Diagnosing problems12412
+Node: Debug options13507
+Node: No output14710
+Node: Small or inverted16178
+Node: Printer errors16897
+Node: Long documents fail18229
+Node: Including graphics fails18570
+Node: Invoking Dvips19808
+Node: Basic usage20399
+Node: Command-line options21383
+Node: Option summary21832
+Node: Option details23994
+Node: Environment variables42998
+Node: Config files45957
+Node: Configuration file searching46640
+Node: Configuration file commands49940
+Node: Paper size and landscape57053
+Node: papersize special58651
+Node: Config file paper sizes60060
+Node: Paper trays64215
+Node: Interaction with PostScript65549
+Node: PostScript figures66202
+Node: Bounding box66928
+Node: \includegraphics70299
+Node: EPSF macros72590
+Node: EPSF scaling74560
+Node: EPSF clipping77130
+Node: psfile special77772
+Node: Dynamic creation of graphics80165
+Node: Fonts in figures81483
+Node: Header files83143
+Node: Including headers from TeX84349
+Node: Including headers from the command line86383
+Node: Headers and memory usage87483
+Node: Literal PS88193
+Node: " special88775
+Node: ps special89516
+Node: Literal headers91014
+Node: PostScript hooks91729
+Node: Literal examples93819
+Node: Hypertext95271
+Node: Hypertext caveats96829
+Node: Hypertext specials101226
+Node: PostScript fonts103860
+Node: Font concepts104976
+Node: Metric files106143
+Node: Glyph files108969
+Node: Virtual fonts111325
+Node: Encodings113215
+Node: PostScript typesetting115597
+Node: Making a font available118679
+Node: Invoking afm2tfm123709
+Node: Changing font encodings124679
+Node: Changing TeX encodings125469
+Node: Changing PostScript encodings126569
+Node: Changing both encodings127913
+Node: Reencoding with Afm2tfm128586
+Node: Encoding file format131690
+Node: Special font effects135893
+Node: Afm2tfm options138156
+Node: psfonts.map141141
+Node: Color145873
+Node: Color macro files146917
+Node: User-definable colors150115
+Node: Color subtleties151390
+Node: Ted Turner153041
+Node: Color device configuration154266
+Node: Color support details156708
+Node: Color specifications157086
+Node: Color specials158489
+Node: Index160618

End Tag Table
diff --git a/Master/texmf/doc/info/fontname.info b/Master/texmf/doc/info/fontname.info
index ff1b5a430d8..14b93d87ea9 100644
--- a/Master/texmf/doc/info/fontname.info
+++ b/Master/texmf/doc/info/fontname.info
@@ -1,4 +1,4 @@
-This is fontname.info, produced by makeinfo version 4.11 from
+This is fontname.info, produced by makeinfo version 4.13 from
fontname.texi.
This document is in the public domain and may be used freely.
@@ -14,8 +14,8 @@ File: fontname.info, Node: Top, Next: Introduction, Up: (dir)
Filenames for TeX fonts
***********************
-This is Fontname, a naming scheme for (the base part of) external TeX
-font filenames. Last update 10 September 2005.
+This is the Fontname document, a naming scheme for (the base part of)
+external TeX font filenames. Last update 5 July 2009.
* Menu:
@@ -24,7 +24,6 @@ font filenames. Last update 10 September 2005.
* Long names:: A specification for long filenames.
* Font name lists:: Real fontnames for many existing fonts.
* Encodings:: Specifications for various encodings.
-* Font legalities:: Legal issues vary from country to country.
* General index:: Index.
--- The Detailed Node Listing ---
@@ -150,30 +149,25 @@ File: fontname.info, Node: References, Prev: History, Up: Introduction
Related files and distributions:
* The TeX Directory Structure (TDS) standard, available at
- (`ftp://tug.org/tex/tds' and `CTAN:/tds') specifies a directory
- tree for all TeX library files. The directory names given in
- *note Suppliers:: and *note Typefaces:: are intended to mesh with
- that standard.
+ (`http://tug.org/tds' and `CTAN:/tds') specifies a directory tree
+ for all TeX library files. The directory names given in *note
+ Suppliers:: and *note Typefaces:: are intended to mesh with that
+ standard.
* The `modes.mf' file (`ftp://tug.org/tex/modes.mf') contains
recommended mode names to use as directory names.
- * The PSfonts distribution (`CTAN:/fonts/psfonts') contains TeX
- support for many fonts, both commercially available and free.
-
- * The Fontinst distribution (`CTAN:/fonts/utilities/psfonts')
+ * The Fontinst distribution (`http://tug.org/applications/fontinst'
supports quite general creation of virtual fonts, named according
to the scheme given here.
- * The Dvips translator (original at
- `ftp://labrea.stanford.edu/pub/dvips*.tar.gz' and variation at
- `ftp://tug.org/tex/dvipsk.tar.gz') supports resident and
- downloadable PostScript fonts. Dvips was the first real
- application of Fontname 1. Dvips also includes Afm2tfm, another
+ * The Dvips translator (`http://tug.org/dvips') supports resident
+ and downloadable PostScript fonts. Dvips was the first place where
+ Fontname became widely known. Dvips also includes Afm2tfm, another
program that can create virtual fonts.
- * The Dviljk processor (`ftp://tug.org/tex/dviljk.tar.gz') contains
- TeX support for the fonts built into the LaserJet 4.
+ * The Dviljk processor (included in TeX Live) contains TeX support
+ for the fonts built into the LaserJet 4.
* `Designing New Typefaces with Metafont', by Richard Southall,
Stanford Computer Science Department Technical Report
@@ -187,13 +181,13 @@ File: fontname.info, Node: Filenames for fonts, Next: Long names, Prev: Intro
2 Filenames for fonts
*********************
-We must limit ourselves to eight character names, for compatibility with
-DOS filesystems and the ISO 9660 standard used for CD-ROM distribution.
-Names may consist of only the letters (monocase a-z), numerals (0-9),
-and underscore.
+In this scheme, names may consist of only the letters (monocase a-z),
+numerals (0-9), and underscore. Having two names which differ only in
+case is undesirable, since it results in clashes on common Windows
+filesystems.
- Here is the basic division of the eight characters (the spaces here
-are merely for readability):
+ Here is the basic scheme (the spaces here are merely for
+readability):
S TT W [V...] [N] [E] [DD]
@@ -223,11 +217,15 @@ E
DD
represents the design size (in decimal), and is omitted if the
font is linearly scaled. Mittelbach in `TUGboat' 13(1) proposes
- using hexadecimal or base-36 notation. I don't think the
- increased range makes up for the unreadability of the common sizes
- (e.g., 10pt fonts would have a suffix `a' (in hex), or `j' (in
- base 36)).
+ using hexadecimal or base-36 notation. In my opinion, the
+ increased range does not make up for the unreadability of the
+ common sizes (e.g., 10pt fonts would have a suffix `a' (in hex),
+ or `j' (in base 36)).
+
+ We used to try to limit font names to eight characters. This was
+never completely possible, and since DOS filesystems have become rare,
+it's no longer an issue.
The weight, variants, and width are probably all best taken from the
original name of the font, instead of trying to relate them to some
@@ -306,6 +304,7 @@ directory name, and comment.
u urw URW
v sil SIL
w wolfram Wolfram
+ y arkandis Arkandis Digital Foundry
z - bizarre (fontname is nonstandard)
- autofont Eddie Kohler's autofont program
- jknappen Joerg Knappen
@@ -371,7 +370,7 @@ supplier.
@c @mapfile{
@c email = "tex-fonts@tug.org",
-@c date = "21feb08",
+@c date = "22feb09",
@c url = "http://tug.org/fontname/typeface.map",
@c supported = "yes",
@c docstring = "Typeface abbreviations for the TeX Fontname scheme.",
@@ -605,6 +604,7 @@ im imago Imago
in industri Industria
io ionic Ionic b:News701BT
ip impressm Impressum
+ir Irianis IrianisADF
is italnos ItalianOldStyle
it italia Italia
iw ironwood Ironwood
@@ -863,6 +863,9 @@ ut utopia Utopia
uw usherwoo Usherwood
uy universi University
v0 vineta Vineta
+v1 venturissans VenturisSansADF
+v2 venturis2 VenturisADFNo2
+v3 venturissans2 VenturisSansADFNo2
va activa Activa
vc vectora Vectora
vd vandijck VanDijck
@@ -870,11 +873,13 @@ ve veraseri VeraSerif
vg visigoth Visigoth
vi victoria Victoria
vj veljovic Veljovic
+vl versaill Versailles
vm veramono VeraSansMono
vn verdana Verdana
-vl versaill Versailles
+vo venturisold VenturisOldADF
vr vagrnd VAGRounded
vs verasans VeraSans
+vt venturis VenturisADF
vv viva Viva
w0 weddingt WeddingT
w1 wiesbswi WiesbadenSwing
@@ -1192,7 +1197,7 @@ PostScript `Encoding' name.
obsolete [3=>7f] Fraction
obsolete [4 fax; now typeface `lx', Lucida Fax]
5 escape for (presently) phonetic encodings
- 6 escape for Cyrillic encodings [was `SemiSerif']
+ 6 escape for (mostly) Cyrillic encodings [was `SemiSerif']
7 escape for (mostly) 7-bit encodings
8 escape for (mostly) 8-bit encodings
9 escape for (presently) expert encodings [was oldstyle digits]
@@ -1232,6 +1237,7 @@ PostScript `Encoding' name.
6b Cyrillic part of ISO 8859-5, seven bits
6c T2C
6d Cyrillic CP866 encoding
+ 6g LGR Greek font encoding
6i ISO 8859-5
6k Cyrillic KOI8-R encoding
6m Cyrillic Macintosh encoding
@@ -1363,7 +1369,7 @@ benefit of DVI-reading programs in the same file. Comments start with
Besides allowing long names, this sort of mapping file has other
benefits. TeX source or DVI files can be more easily transported,
-because the font names in a particular file can be made work on every
+because the font names in a particular file can be made to work on every
system. Also, when combined with a consistent naming scheme, macros
could be written to access any of a number of fonts. Right now, each
font family has to have specialized macros written to deal with it.
@@ -11544,7 +11550,7 @@ accordingly:
uzdr Dingbats d050000l

-File: fontname.info, Node: Encodings, Next: Font legalities, Prev: Font name lists, Up: Top
+File: fontname.info, Node: Encodings, Next: General index, Prev: Font name lists, Up: Top
Appendix B Encodings
********************
@@ -12387,12 +12393,92 @@ File: fontname.info, Node: ec, Next: groff, Prev: dvips, Up: Encodings
B.5 `ec.enc': Cork encoding
===========================
+% @@psencodingfile@{
+% date = "6jul08",
+% filename = "ec.enc",
+% email = "tex-fonts@@tug.org",
+% docstring = "This is the EC (aka Cork aka T1) encoding vector
+% for 8-bit fonts to be used with TeX."
+% @}
+%
+% Names of the glyphs try to comply with:
+% Adobe Glyph List For New Fonts, ver. 1.6, 30 Januaury 2006
+% http://partners.adobe.com/public/developer/en/opentype/aglfn13.txt
+% but some exceptions are listed below.
+%
+% The following characters are not present in Unicode:
+% - /perthousandzero = used to compose /perthousand, /pertenthousand, ... out of /percent + this character
+% - Germandbls = now there is a related character in Unicode,
+% U+1E9E - LATIN CAPITAL LETTER SHARP S
+% but probably /S_S ligature name should be used instead
+%
+% The following two characters have different Unicode mappings than on the AGL:
+% - /tcedilla = U+0163 - LATIN SMALL LETTER T WITH CEDILLA
+% according to AGL it should be /tcommaaccent
+% - /Tcedilla = U+0162 - LATIN CAPITAL LETTER T WITH CEDILLA
+% according to AGL it should be /Tcommaaccent
+% But having /scedilla and /tcommaaccent mixed is even more ugly.
+%
+% The following characters are not present on the AGL:
+% - /dotlessj = U+0237 - LATIN SMALL LETTER DOTLESS J
+% - /cwm = U+200B - ZERO WIDTH SPACE
+% - /visiblespace = U+2423 - OPEN BOX
+%
+% The following ligatures are deprecated by recent AGL:
+% - /ff, /fi, /fl, /ffi, /ffl = /f_i and similar should have been used instead
+%
+% Special characters:
+% - /hyphen.alt = hanging hyphen char (half-width)
+% used when no micro-typographic extensions were available yet
+%
+% Other remarks:
+% - /Eth = U+00D0 - LATIN CAPITAL LETTER ETH
+% must also be used as /Dcroat
+% U+0110 - LATIN CAPITAL LETTER D WITH STROKE
+%
+% Misleading names and shapes of letters (that lead to different names in past)
+% - /lcaron = U+013E - LATIN SMALL LETTER L WITH CARON
+% /lquoteright
+% - /Lcaron = U+013D - LATIN CAPITAL LETTER L WITH CARON
+% /Lquoteright
+% - /dcaron = U+010F - LATIN SMALL LETTER D WITH CARON
+% /dquoteright
+% - /tcaron = U+0165 - LATIN SMALL LETTER T WITH CARON
+% /tquoteright
+% - /dcroat = U+0111 - LATIN SMALL LETTER D WITH STROKE
+% /dbar, /dmacron
+%
+% - /cwm - /bom, /zerowidthnobreakspace
+% - /underscore - /underline
+% - /hyphen.alt - /sfthyphen, /hyphen, /dash
+%
+%
+% Turkish & Romanian
+% --------------------
+% EC encoding has been defined to include /tcedilla and /scedilla.
+% For Turkish one needs /scedilla, while for Romanian one would need
+% "t with comma below" (/tcommaaccent) and "s with comma below" (/scommaaccent).
+% "t with cedilla" in not used in any language except in inferior
+% Romanian typography that can use cedillas instead of commas below.
+% AGL has a strange mapping as well.
%
-% This is the EC encoding.
+% Without adding an additional character, it is impossible to support both
+% languages at the same time, so EC is not really best choice for Romanians,
+% even though it can be "misused" if one replaces both /scedilla and /tcedilla
+% with /scommaaccent and /tcommaaccent.
%
-% These are the ligs and kerns in addition to those found in the
-% AFM file. (The only ligs in the Times-Roman.afm file are the
-% fi and fl ligatures.)
+% Characters that have been renamed in July 2008:
+% 0x18 /zeroinferior -> /perthousandzero
+% 0x20 U+2423 /visualspace -> /visiblespace (if font doesn't have it, use /space)
+% 0x7F U+002D /hyphen -> /hyphen.alt U+???
+% 0x8D U+014A /Ng -> /Eng
+% 0x9E U+0111 /dbar -> /dcroat
+% 0xAD U+014B /ng -> /eng
+% 0xB4 U+0165 /tquoteright -> /tcaron
+%
+% Although these ligatures and kerns are somewhat questionable to have
+% in an encoding file, they've been here forever, and they are
+% traditional in the TeX world, so we preserve them.
%
% LIGKERN space l =: lslash ; space L =: Lslash ;
% LIGKERN question quoteleft =: questiondown ; exclam quoteleft =: exclamdown ;
@@ -12414,60 +12500,263 @@ B.5 `ec.enc': Cork encoding
% LIGKERN comma comma =: quotedblbase ; less less =: guillemotleft ;
% LIGKERN greater greater =: guillemotright ;
%
-/ECEncoding [ % now 256 chars follow
-% 0x00
- /grave /acute /circumflex /tilde /dieresis /hungarumlaut /ring /caron
- /breve /macron /dotaccent /cedilla
- /ogonek /quotesinglbase /guilsinglleft /guilsinglright
-% 0x10
- /quotedblleft /quotedblright /quotedblbase /guillemotleft
- /guillemotright /endash /emdash /cwm
- /zeroinferior /dotlessi /dotlessj /ff /fi /fl /ffi /ffl
-% 0x20
- /visualspace /exclam /quotedbl /numbersign
- /dollar /percent /ampersand /quoteright
- /parenleft /parenright /asterisk /plus /comma /hyphen /period /slash
-% 0x30
- /zero /one /two /three /four /five /six /seven
- /eight /nine /colon /semicolon /less /equal /greater /question
-% 0x40
- /at /A /B /C /D /E /F /G /H /I /J /K /L /M /N /O
-% 0x50
- /P /Q /R /S /T /U /V /W
- /X /Y /Z /bracketleft /backslash /bracketright /asciicircum /underscore
-% 0x60
- /quoteleft /a /b /c /d /e /f /g /h /i /j /k /l /m /n /o
-% 0x70
- /p /q /r /s /t /u /v /w
- /x /y /z /braceleft /bar /braceright /asciitilde /hyphen
-% 0x80
- /Abreve /Aogonek /Cacute /Ccaron /Dcaron /Ecaron /Eogonek /Gbreve
- /Lacute /Lcaron /Lslash /Nacute /Ncaron /Ng /Ohungarumlaut /Racute
-% 0x90
- /Rcaron /Sacute /Scaron /Scedilla
- /Tcaron /Tcedilla /Uhungarumlaut /Uring
- /Ydieresis /Zacute /Zcaron /Zdotaccent /IJ /Idotaccent /dbar /section
-% 0xA0
- /abreve /aogonek /cacute /ccaron /dcaron /ecaron /eogonek /gbreve
- /lacute /lcaron /lslash /nacute /ncaron /ng /ohungarumlaut /racute
-% 0xB0
- /rcaron /sacute /scaron /scedilla
- /tquoteright /tcedilla /uhungarumlaut /uring
- /ydieresis /zacute /zcaron /zdotaccent /ij /exclamdown /questiondown /sterling
-% 0xC0
- /Agrave /Aacute /Acircumflex /Atilde /Adieresis /Aring /AE /Ccedilla
- /Egrave /Eacute /Ecircumflex /Edieresis
- /Igrave /Iacute /Icircumflex /Idieresis
-% 0xD0
- /Eth /Ntilde /Ograve /Oacute /Ocircumflex /Otilde /Odieresis /OE
- /Oslash /Ugrave /Uacute /Ucircumflex /Udieresis /Yacute /Thorn /Germandbls
-% 0xE0
- /agrave /aacute /acircumflex /atilde /adieresis /aring /ae /ccedilla
- /egrave /eacute /ecircumflex /edieresis
- /igrave /iacute /icircumflex /idieresis
-% 0xF0
- /eth /ntilde /ograve /oacute /ocircumflex /otilde /odieresis /oe
- /oslash /ugrave /uacute /ucircumflex /udieresis /yacute /thorn /germandbls
+/ECEncoding [ % now 256 chars follow
+/grave % 0x00 U+0060
+/acute % 0x01 U+00B4
+/circumflex % 0x02 U+02C6
+/tilde % 0x03 U+02DC
+/dieresis % 0x04 U+00A8
+/hungarumlaut % 0x05 U+02DD
+/ring % 0x06 U+02DA
+/caron % 0x07 U+02C7
+/breve % 0x08 U+02D8
+/macron % 0x09 U+00AF
+/dotaccent % 0x0A U+02D9
+/cedilla % 0x0B U+00B8
+/ogonek % 0x0C U+02DB
+/quotesinglbase % 0x0D U+201A
+/guilsinglleft % 0x0E U+2039
+/guilsinglright % 0x0F U+203A
+/quotedblleft % 0x10 U+201C
+/quotedblright % 0x11 U+201D
+/quotedblbase % 0x12 U+201E
+/guillemotleft % 0x13 U+00AB
+/guillemotright % 0x14 U+00BB
+/endash % 0x15 U+2013
+/emdash % 0x16 U+2014
+/cwm % 0x17 U+200B
+/perthousandzero % 0x18 ______
+/dotlessi % 0x19 U+0131
+/dotlessj % 0x1A U+0237
+/ff % 0x1B U+FB00
+/fi % 0x1C U+FB01
+/fl % 0x1D U+FB02
+/ffi % 0x1E U+FB03
+/ffl % 0x1F U+FB04
+/visiblespace % 0x20 U+2423
+/exclam % 0x21
+/quotedbl % 0x22
+/numbersign % 0x23
+/dollar % 0x24
+/percent % 0x25
+/ampersand % 0x26
+/quoteright % 0x27 U+2019
+/parenleft % 0x28
+/parenright % 0x29
+/asterisk % 0x2A
+/plus % 0x2B
+/comma % 0x2C
+/hyphen % 0x2D
+/period % 0x2E
+/slash % 0x2F
+/zero % 0x30
+/one % 0x31
+/two % 0x32
+/three % 0x33
+/four % 0x34
+/five % 0x35
+/six % 0x36
+/seven % 0x37
+/eight % 0x38
+/nine % 0x39
+/colon % 0x3A
+/semicolon % 0x3B
+/less % 0x3C
+/equal % 0x3D
+/greater % 0x3E
+/question % 0x3F
+/at % 0x40
+/A % 0x41
+/B % 0x42
+/C % 0x43
+/D % 0x44
+/E % 0x45
+/F % 0x46
+/G % 0x47
+/H % 0x48
+/I % 0x49
+/J % 0x4A
+/K % 0x4B
+/L % 0x4C
+/M % 0x4D
+/N % 0x4E
+/O % 0x4F
+/P % 0x50
+/Q % 0x51
+/R % 0x52
+/S % 0x53
+/T % 0x54
+/U % 0x55
+/V % 0x56
+/W % 0x57
+/X % 0x58
+/Y % 0x59
+/Z % 0x5A
+/bracketleft % 0x5B
+/backslash % 0x5C
+/bracketright % 0x5D
+/asciicircum % 0x5E
+/underscore % 0x5F
+/quoteleft % 0x60 U+2018
+/a % 0x61
+/b % 0x62
+/c % 0x63
+/d % 0x64
+/e % 0x65
+/f % 0x66
+/g % 0x67
+/h % 0x68
+/i % 0x69
+/j % 0x6A
+/k % 0x6B
+/l % 0x6C
+/m % 0x6D
+/n % 0x6E
+/o % 0x6F
+/p % 0x70
+/q % 0x71
+/r % 0x72
+/s % 0x73
+/t % 0x74
+/u % 0x75
+/v % 0x76
+/w % 0x77
+/x % 0x78
+/y % 0x79
+/z % 0x7A
+/braceleft % 0x7B
+/bar % 0x7C
+/braceright % 0x7D
+/asciitilde % 0x7E
+/hyphen.alt % 0x7F U+002D % U+????
+/Abreve % 0x80 U+0102
+/Aogonek % 0x81 U+0104
+/Cacute % 0x82 U+0106
+/Ccaron % 0x83 U+010C
+/Dcaron % 0x84 U+010E
+/Ecaron % 0x85 U+011A
+/Eogonek % 0x86 U+0118
+/Gbreve % 0x87 U+011E
+/Lacute % 0x88 U+0139
+/Lcaron % 0x89 U+013D
+/Lslash % 0x8A U+0141
+/Nacute % 0x8B U+0143
+/Ncaron % 0x8C U+0147
+/Eng % 0x8D U+014A
+/Ohungarumlaut % 0x8E U+0150
+/Racute % 0x8F U+0154
+/Rcaron % 0x90 U+0158
+/Sacute % 0x91 U+015A
+/Scaron % 0x92 U+0160
+/Scedilla % 0x93 U+015E
+/Tcaron % 0x94 U+0164
+/Tcedilla % 0x95 U+0162
+/Uhungarumlaut % 0x96 U+0170
+/Uring % 0x97 U+016E
+/Ydieresis % 0x98 U+0178
+/Zacute % 0x99 U+0179
+/Zcaron % 0x9A U+017D
+/Zdotaccent % 0x9B U+017B
+/IJ % 0x9C U+0132
+/Idotaccent % 0x9D U+0130
+/dcroat % 0x9E U+0111
+/section % 0x9F U+00A7
+/abreve % 0xA0 U+0103
+/aogonek % 0xA1 U+0105
+/cacute % 0xA2 U+0107
+/ccaron % 0xA3 U+010D
+/dcaron % 0xA4 U+010F
+/ecaron % 0xA5 U+011B
+/eogonek % 0xA6 U+0119
+/gbreve % 0xA7 U+011F
+/lacute % 0xA8 U+013A
+/lcaron % 0xA9 U+013E
+/lslash % 0xAA U+0142
+/nacute % 0xAB U+0144
+/ncaron % 0xAC U+0148
+/eng % 0xAD U+014B
+/ohungarumlaut % 0xAE U+0151
+/racute % 0xAF U+0155
+/rcaron % 0xB0 U+0159
+/sacute % 0xB1 U+015B
+/scaron % 0xB2 U+0161
+/scedilla % 0xB3 U+015F
+/tcaron % 0xB4 U+0165
+/tcedilla % 0xB5 U+0163
+/uhungarumlaut % 0xB6 U+0171
+/uring % 0xB7 U+016F
+/ydieresis % 0xB8 U+00FF
+/zacute % 0xB9 U+017A
+/zcaron % 0xBA U+017E
+/zdotaccent % 0xBB U+017C
+/ij % 0xBC U+0133
+/exclamdown % 0xBD U+00A1
+/questiondown % 0xBE U+00BF
+/sterling % 0xBF U+00A3
+/Agrave % 0xC0
+/Aacute % 0xC1
+/Acircumflex % 0xC2
+/Atilde % 0xC3
+/Adieresis % 0xC4
+/Aring % 0xC5
+/AE % 0xC6
+/Ccedilla % 0xC7
+/Egrave % 0xC8
+/Eacute % 0xC9
+/Ecircumflex % 0xCA
+/Edieresis % 0xCB
+/Igrave % 0xCC
+/Iacute % 0xCD
+/Icircumflex % 0xCE
+/Idieresis % 0xCF
+/Eth % 0xD0
+/Ntilde % 0xD1
+/Ograve % 0xD2
+/Oacute % 0xD3
+/Ocircumflex % 0xD4
+/Otilde % 0xD5
+/Odieresis % 0xD6
+/OE % 0xD7 U+0152
+/Oslash % 0xD8
+/Ugrave % 0xD9
+/Uacute % 0xDA
+/Ucircumflex % 0xDB
+/Udieresis % 0xDC
+/Yacute % 0xDD
+/Thorn % 0xDE
+/Germandbls % 0xDF (U+1E9E, /S_S)
+/agrave % 0xE0
+/aacute % 0xE1
+/acircumflex % 0xE2
+/atilde % 0xE3
+/adieresis % 0xE4
+/aring % 0xE5
+/ae % 0xE6
+/ccedilla % 0xE7
+/egrave % 0xE8
+/eacute % 0xE9
+/ecircumflex % 0xEA
+/edieresis % 0xEB
+/igrave % 0xEC
+/iacute % 0xED
+/icircumflex % 0xEE
+/idieresis % 0xEF
+/eth % 0xF0
+/ntilde % 0xF1
+/ograve % 0xF2
+/oacute % 0xF3
+/ocircumflex % 0xF4
+/otilde % 0xF5
+/odieresis % 0xF6
+/oe % 0xF7 U+0153
+/oslash % 0xF8
+/ugrave % 0xF9
+/uacute % 0xFA
+/ucircumflex % 0xFB
+/udieresis % 0xFC
+/yacute % 0xFD
+/thorn % 0xFE
+/germandbls % 0xFF U+00DF
] def

@@ -14304,15 +14593,14 @@ B.12 `texnansi.enc'
From Y&Y.
% @psencodingfile{
+% date = "22apr09",
+% filename = "texnansi.enc",
+% email = "tex-fonts@tug.org",
% author = "Y&Y, Inc.",
% version = "1.1",
-% date = "1 December 1996",
-% filename = "texnansi.enc",
-% email = "help@YandY.com",
-% address = "45 Walden Street // Concord, MA 01742, USA",
% codetable = "ISO/ASCII",
-% checksum = "xx",
-% docstring = "Encoding for fonts in Adobe Type 1 format for use with TeX."
+% docstring = "texnansi (aka LY1) encoding vector for Type 1 fonts to
+% be used with TeX, following ASCII and Windows ANSI."
% }
%
% The idea is to have all 228 characters normally included in Type 1 text
@@ -14357,268 +14645,271 @@ From Y&Y.
% into PFA form, to include the attached `texnansi.enc' encoding vector,
% and to then actually reencode the font based on that encoding vector.
%
+% Revised 2009 April 20 with doc changes only (Uni20AC -> uni20ac).
+% Revised 2009 March 9 with doc changes only.
% Revised 1996 June 1 by adding second position for `fl' to avoid Acrobat bug.
% Revised 1996 June 1 by adding second position for `fraction' for same reason.
-% Revised 1997 Oct 1 by adding cwm (used in boundary char TFM code)
-% Revised 1998 Mar 1 by adding Unicode for Euro character
+% Revised 1997 Oct 1 by adding cwm (used in boundary char TFM code).
+% Revised 1998 Mar 1 by adding Unicode for Euro character.
+% emacs-page
%
-/TeXnANSIEncoding [
-/.notdef % 0
-/Euro % /Uni20AC 1
-/.notdef % 2
-/.notdef % 3
-/fraction % 4
-/dotaccent % 5
-/hungarumlaut % 6
-/ogonek % 7
-/fl % 8
-/.notdef % /fraction % 9 not used (see 4), backward compatability only
-/cwm % 10 not used, except boundary char internally maybe
-/ff % 11
-/fi % 12
-/.notdef % /fl % 13 not used (see 8), backward compatability only
-/ffi % 14
-/ffl % 15
-/dotlessi % 16
-/dotlessj % 17
-/grave % 18
-/acute % 19
-/caron % 20
-/breve % 21
-/macron % 22
-/ring % 23
-/cedilla % 24
-/germandbls % 25
-/ae % 26
-/oe % 27
-/oslash % 28
-/AE % 29
-/OE % 30
-/Oslash % 31
-/space % 32 % /suppress in TeX text
-/exclam % 33
-/quotedbl % 34 % /quotedblright in TeX text
-/numbersign % 35
-/dollar % 36
-/percent % 37
-/ampersand % 38
-/quoteright % 39 % /quotesingle in ANSI
-/parenleft % 40
-/parenright % 41
-/asterisk % 42
-/plus % 43
-/comma % 44
-/hyphen % 45
-/period % 46
-/slash % 47
-/zero % 48
-/one % 49
-/two % 50
-/three % 51
-/four % 52
-/five % 53
-/six % 54
-/seven % 55
-/eight % 56
-/nine % 57
-/colon % 58
-/semicolon % 59
-/less % 60 % /exclamdown in Tex text
-/equal % 61
-/greater % 62 % /questiondown in TeX text
-/question % 63
-/at % 64
-/A % 65
-/B % 66
-/C % 67
-/D % 68
-/E % 69
-/F % 70
-/G % 71
-/H % 72
-/I % 73
-/J % 74
-/K % 75
-/L % 76
-/M % 77
-/N % 78
-/O % 79
-/P % 80
-/Q % 81
-/R % 82
-/S % 83
-/T % 84
-/U % 85
-/V % 86
-/W % 87
-/X % 88
-/Y % 89
-/Z % 90
-/bracketleft % 91
-/backslash % 92 % /quotedblleft in TeX text
-/bracketright % 93
-/circumflex % 94 % /asciicircum in ASCII
-/underscore % 95 % /dotaccent in TeX text
-/quoteleft % 96 % /grave accent in ANSI
-/a % 97
-/b % 98
-/c % 99
-/d % 100
-/e % 101
-/f % 102
-/g % 103
-/h % 104
-/i % 105
-/j % 106
-/k % 107
-/l % 108
-/m % 109
-/n % 110
-/o % 111
-/p % 112
-/q % 113
-/r % 114
-/s % 115
-/t % 116
-/u % 117
-/v % 118
-/w % 119
-/x % 120
-/y % 121
-/z % 122
-/braceleft % 123 % /endash in TeX text
-/bar % 124 % /emdash in TeX test
-/braceright % 125 % /hungarumlaut in TeX text
-/tilde % 126 % /asciitilde in ASCII
-/dieresis % 127 not used (see 168), use higher up instead
-/Lslash % 128 this position is unfortunate, but now too late to fix
-/quotesingle % 129
-/quotesinglbase % 130
-/florin % 131
-/quotedblbase % 132
-/ellipsis % 133
-/dagger % 134
-/daggerdbl % 135
-/circumflex % 136
-/perthousand % 137
-/Scaron % 138
-/guilsinglleft % 139
-/OE % 140
-/Zcaron % 141
-/asciicircum % 142
-/minus % 143
-/lslash % 144
-/quoteleft % 145
-/quoteright % 146
-/quotedblleft % 147
-/quotedblright % 148
-/bullet % 149
-/endash % 150
-/emdash % 151
-/tilde % 152
-/trademark % 153
-/scaron % 154
-/guilsinglright % 155
-/oe % 156
-/zcaron % 157
-/asciitilde % 158
-/Ydieresis % 159
-/nbspace % 160 % /space (no break space)
-/exclamdown % 161
-/cent % 162
-/sterling % 163
-/currency % 164
-/yen % 165
-/brokenbar % 166
-/section % 167
-/dieresis % 168
-/copyright % 169
-/ordfeminine % 170
-/guillemotleft % 171
-/logicalnot % 172
-/sfthyphen % 173 % /hyphen (hanging hyphen)
-/registered % 174
-/macron % 175
-/degree % 176
-/plusminus % 177
-/twosuperior % 178
-/threesuperior % 179
-/acute % 180
-/mu % 181
-/paragraph % 182
-/periodcentered % 183
-/cedilla % 184
-/onesuperior % 185
-/ordmasculine % 186
-/guillemotright % 187
-/onequarter % 188
-/onehalf % 189
-/threequarters % 190
-/questiondown % 191
-/Agrave % 192
-/Aacute % 193
-/Acircumflex % 194
-/Atilde % 195
-/Adieresis % 196
-/Aring % 197
-/AE % 198
-/Ccedilla % 199
-/Egrave % 200
-/Eacute % 201
-/Ecircumflex % 202
-/Edieresis % 203
-/Igrave % 204
-/Iacute % 205
-/Icircumflex % 206
-/Idieresis % 207
-/Eth % 208
-/Ntilde % 209
-/Ograve % 210
-/Oacute % 211
-/Ocircumflex % 212
-/Otilde % 213
-/Odieresis % 214
-/multiply % 215 % OE in T1
-/Oslash % 216
-/Ugrave % 217
-/Uacute % 218
-/Ucircumflex % 219
-/Udieresis % 220
-/Yacute % 221
-/Thorn % 222
-/germandbls % 223
-/agrave % 224
-/aacute % 225
-/acircumflex % 226
-/atilde % 227
-/adieresis % 228
-/aring % 229
-/ae % 230
-/ccedilla % 231
-/egrave % 232
-/eacute % 233
-/ecircumflex % 234
-/edieresis % 235
-/igrave % 236
-/iacute % 237
-/icircumflex % 238
-/idieresis % 239
-/eth % 240
-/ntilde % 241
-/ograve % 242
-/oacute % 243
-/ocircumflex % 244
-/otilde % 245
-/odieresis % 246
-/divide % 247 % oe in T1
-/oslash % 248
-/ugrave % 249
-/uacute % 250
-/ucircumflex % 251
-/udieresis % 252
-/yacute % 253
-/thorn % 254
-/ydieresis % 255 % germandbls in T1
+/TeXnANSIEncoding [ % now 256 chars follow
+/.notdef % 0x00 0
+/Euro % 0x01 1 /uni20AC
+/.notdef % 0x02 2
+/.notdef % 0x03 3
+/fraction % 0x04 4
+/dotaccent % 0x05 5
+/hungarumlaut % 0x06 6
+/ogonek % 0x07 7
+/fl % 0x08 8
+/.notdef % 0x09 9 /fraction at 4, backward compatibility only
+/cwm % 0x0A 10 not used, except boundary char internally
+/ff % 0x0B 11
+/fi % 0x0C 12
+/.notdef % 0x0D 13 /fl at 8, backward compatibility only
+/ffi % 0x0E 14
+/ffl % 0x0F 15
+/dotlessi % 0x10 16
+/dotlessj % 0x11 17
+/grave % 0x12 18
+/acute % 0x13 19
+/caron % 0x14 20
+/breve % 0x15 21
+/macron % 0x16 22
+/ring % 0x17 23
+/cedilla % 0x18 24
+/germandbls % 0x19 25
+/ae % 0x1A 26
+/oe % 0x1B 27
+/oslash % 0x1C 28
+/AE % 0x1D 29
+/OE % 0x1E 30
+/Oslash % 0x1F 31
+/space % 0x20 32 /suppress in TeX text
+/exclam % 0x21 33
+/quotedbl % 0x22 34 /quotedblright in TeX text
+/numbersign % 0x23 35
+/dollar % 0x24 36
+/percent % 0x25 37
+/ampersand % 0x26 38
+/quoteright % 0x27 39 /quotesingle in ANSI
+/parenleft % 0x28 40
+/parenright % 0x29 41
+/asterisk % 0x2A 42
+/plus % 0x2B 43
+/comma % 0x2C 44
+/hyphen % 0x2D 45
+/period % 0x2E 46
+/slash % 0x2F 47
+/zero % 0x30 48
+/one % 0x31 49
+/two % 0x32 50
+/three % 0x33 51
+/four % 0x34 52
+/five % 0x35 53
+/six % 0x36 54
+/seven % 0x37 55
+/eight % 0x38 56
+/nine % 0x39 57
+/colon % 0x3A 58
+/semicolon % 0x3B 59
+/less % 0x3C 60 /exclamdown in Tex text
+/equal % 0x3D 61
+/greater % 0x3E 62 /questiondown in TeX text
+/question % 0x3F 63
+/at % 0x40 64
+/A % 0x41 65
+/B % 0x42 66
+/C % 0x43 67
+/D % 0x44 68
+/E % 0x45 69
+/F % 0x46 70
+/G % 0x47 71
+/H % 0x48 72
+/I % 0x49 73
+/J % 0x4A 74
+/K % 0x4B 75
+/L % 0x4C 76
+/M % 0x4D 77
+/N % 0x4E 78
+/O % 0x4F 79
+/P % 0x50 80
+/Q % 0x51 81
+/R % 0x52 82
+/S % 0x53 83
+/T % 0x54 84
+/U % 0x55 85
+/V % 0x56 86
+/W % 0x57 87
+/X % 0x58 88
+/Y % 0x59 89
+/Z % 0x5A 90
+/bracketleft % 0x5B 91
+/backslash % 0x5C 92 /quotedblleft in TeX text
+/bracketright % 0x5D 93
+/circumflex % 0x5E 94 /asciicircum in ASCII
+/underscore % 0x5F 95 /dotaccent in TeX text
+/quoteleft % 0x60 96 /grave accent in ANSI
+/a % 0x61 97
+/b % 0x62 98
+/c % 0x63 99
+/d % 0x64 100
+/e % 0x65 101
+/f % 0x66 102
+/g % 0x67 103
+/h % 0x68 104
+/i % 0x69 105
+/j % 0x6A 106
+/k % 0x6B 107
+/l % 0x6C 108
+/m % 0x6D 109
+/n % 0x6E 110
+/o % 0x6F 111
+/p % 0x70 112
+/q % 0x71 113
+/r % 0x72 114
+/s % 0x73 115
+/t % 0x74 116
+/u % 0x75 117
+/v % 0x76 118
+/w % 0x77 119
+/x % 0x78 120
+/y % 0x79 121
+/z % 0x7A 122
+/braceleft % 0x7B 123 /endash in TeX text
+/bar % 0x7C 124 /emdash in TeX test
+/braceright % 0x7D 125 /hungarumlaut in TeX text
+/tilde % 0x7E 126 /asciitilde in ASCII
+/dieresis % 0x7F 127 also at 168
+/Lslash % 0x80 128 position is unfortunate, but too late to fix
+/quotesingle % 0x81 129
+/quotesinglbase % 0x82 130
+/florin % 0x83 131
+/quotedblbase % 0x84 132
+/ellipsis % 0x85 133
+/dagger % 0x86 134
+/daggerdbl % 0x87 135
+/circumflex % 0x88 136
+/perthousand % 0x89 137
+/Scaron % 0x8A 138
+/guilsinglleft % 0x8B 139
+/OE % 0x8C 140
+/Zcaron % 0x8D 141
+/asciicircum % 0x8E 142
+/minus % 0x8F 143
+/lslash % 0x90 144
+/quoteleft % 0x91 145
+/quoteright % 0x92 146
+/quotedblleft % 0x93 147
+/quotedblright % 0x94 148
+/bullet % 0x95 149
+/endash % 0x96 150
+/emdash % 0x97 151
+/tilde % 0x98 152
+/trademark % 0x99 153
+/scaron % 0x9A 154
+/guilsinglright % 0x9B 155
+/oe % 0x9C 156
+/zcaron % 0x9D 157
+/asciitilde % 0x9E 158
+/Ydieresis % 0x9F 159
+/nbspace % 0xA0 160 no break space
+/exclamdown % 0xA1 161
+/cent % 0xA2 162
+/sterling % 0xA3 163
+/currency % 0xA4 164
+/yen % 0xA5 165
+/brokenbar % 0xA6 166
+/section % 0xA7 167
+/dieresis % 0xA8 168
+/copyright % 0xA9 169
+/ordfeminine % 0xAA 170
+/guillemotleft % 0xAB 171
+/logicalnot % 0xAC 172
+/sfthyphen % 0xAD 173 /hyphen (hanging hyphen)
+/registered % 0xAE 174
+/macron % 0xAF 175
+/degree % 0xB0 176
+/plusminus % 0xB1 177
+/twosuperior % 0xB2 178
+/threesuperior % 0xB3 179
+/acute % 0xB4 180
+/mu % 0xB5 181
+/paragraph % 0xB6 182
+/periodcentered % 0xB7 183
+/cedilla % 0xB8 184
+/onesuperior % 0xB9 185
+/ordmasculine % 0xBA 186
+/guillemotright % 0xBB 187
+/onequarter % 0xBC 188
+/onehalf % 0xBD 189
+/threequarters % 0xBE 190
+/questiondown % 0xBF 191
+/Agrave % 0xC0 192
+/Aacute % 0xC1 193
+/Acircumflex % 0xC2 194
+/Atilde % 0xC3 195
+/Adieresis % 0xC4 196
+/Aring % 0xC5 197
+/AE % 0xC6 198
+/Ccedilla % 0xC7 199
+/Egrave % 0xC8 200
+/Eacute % 0xC9 201
+/Ecircumflex % 0xCA 202
+/Edieresis % 0xCB 203
+/Igrave % 0xCC 204
+/Iacute % 0xCD 205
+/Icircumflex % 0xCE 206
+/Idieresis % 0xCF 207
+/Eth % 0xD0 208
+/Ntilde % 0xD1 209
+/Ograve % 0xD2 210
+/Oacute % 0xD3 211
+/Ocircumflex % 0xD4 212
+/Otilde % 0xD5 213
+/Odieresis % 0xD6 214
+/multiply % 0xD7 215 OE in T1
+/Oslash % 0xD8 216
+/Ugrave % 0xD9 217
+/Uacute % 0xDA 218
+/Ucircumflex % 0xDB 219
+/Udieresis % 0xDC 220
+/Yacute % 0xDD 221
+/Thorn % 0xDE 222
+/germandbls % 0xDF 223
+/agrave % 0xE0 224
+/aacute % 0xE1 225
+/acircumflex % 0xE2 226
+/atilde % 0xE3 227
+/adieresis % 0xE4 228
+/aring % 0xE5 229
+/ae % 0xE6 230
+/ccedilla % 0xE7 231
+/egrave % 0xE8 232
+/eacute % 0xE9 233
+/ecircumflex % 0xEA 234
+/edieresis % 0xEB 235
+/igrave % 0xEC 236
+/iacute % 0xED 237
+/icircumflex % 0xEE 238
+/idieresis % 0xEF 239
+/eth % 0xF0 240
+/ntilde % 0xF1 241
+/ograve % 0xF2 242
+/oacute % 0xF3 243
+/ocircumflex % 0xF4 244
+/otilde % 0xF5 245
+/odieresis % 0xF6 246
+/divide % 0xF7 247 oe in T1
+/oslash % 0xF8 248
+/ugrave % 0xF9 249
+/uacute % 0xFA 250
+/ucircumflex % 0xFB 251
+/udieresis % 0xFC 252
+/yacute % 0xFD 253
+/thorn % 0xFE 254
+/ydieresis % 0xFF 255 germandbls in T1
] def

@@ -14631,22 +14922,28 @@ From Y&Y. `texnansi' without repeats.
% @psencodingfile{
% author = "Y&Y, Inc.",
-% version = "1.2",
-% date = "1 December 1998",
-% filename = "texnansix.enc",
-% email = "support@YandY.com",
-% address = "45 Walden Street // Concord, MA 01742, USA",
+% version = "1.3",
+% date = "22apr09",
+% filename = "texnansx.enc",
+% email = "tex-fonts@tug.org",
% codetable = "ISO/ASCII",
-% checksum = "xx",
% docstring = "Encoding for fonts in Adobe Type 1 format for use with TeX."
% }
+% MODIFIED FOR AFM2TFM to avoid repeated encodings, namely these
+% positions have become .notdef:
%
-% MODIFIED FOR AFM2TFM to avoid repeated encodings...
+% 137/circumflex 141/OE 146/quoteleft 147/quoteright 153/tilde 157/oe
+% 169/dieresis 176/macron 181/acute 185/cedilla 199/AE 217/Oslash
+% 224/germandbls 231/ae 249/oslash
%
+% 22apr09 document the precise differences from texnansi.
+% 17aug08 change /Uni20AC (wrong capitalization of /Uni) to /Euro for
+% consistency with other encodings. tex-live mail from Vasile Gaburici,
+% 16 Aug 2008 20:44:08.
%
/TeXnANSIEncoding [
/.notdef % 0
-/Uni20AC % /Euro 1
+/Euro % /uni20AC 1
/.notdef % 2
/.notdef % 3
/fraction % 4
@@ -15564,82 +15861,7 @@ B.15 `xt2.enc': typewriter OT1 + ISO Latin 2 extended
% LIGKERN f {} f ; f {} i ; f {} l ;

-File: fontname.info, Node: Font legalities, Next: General index, Prev: Encodings, Up: Top
-
-Appendix C Font legalities
-**************************
-
-This section owes a great deal to Charles Bigelow (co-designer with Kris
-Holmes of the Lucida typeface family, among others), who has generously
-answered our many queries about fonts and the law around the world with
-remarkable patience and understanding. (But he is naturally not
-responsible for any errors here, much less our opinions.)
-
- Fonts have always been treated rather strangely under the law, as
-befits their rather strange nature: letterforms are indivisibly both
-_useful_ and _artistic_. In most countries--in all countries until
-recently--utility has taken precedence; i.e., it has been legal to copy
-fonts without permission or fee.
-
- In any case, to the best of my knowledge, the situation in those
-countries which have adopted any sort of typeface protection is as
-follows. This was originally written in the early 1990's; these days,
-the situation is probably different, due to widespread adoption of
-software patents, among other things, but I lack specific information
-to include.
-
-United States
- Typeface designs can be patented, but not copyrighted. Only a few
- designs have been patented. (Lucida and Stone are the only ones I
- know of. I don't know what the grounds were for patenting Stone,
- but Lucida had some novel features in its design which make it
- reasonable to patent, given the acceptance of the patent system in
- the first place.)
-
- Particular programs which instantiate a font can be copyrighted
- just as any other computer program can. This is arguably wrong,
- since font programs are nothing but a description of the shapes,
- possibly with some simple hints, and there's only one basic way to
- describe the shapes in any given language. Thus, the creativity
- lies in making the shape right, not in making the computer program
- right, so it would seem that to be consistent, the copyright laws
- should protect the design, not the program--the opposite of the
- current situation.
-
-Germany
- Typeface designs have been copyrightable as original works of art
- since 1981. As a result, many (perhaps most) designs have been
- copyrighted there. The law is not retroactive, but German courts
- have upheld the intellectual property rights of designers of
- earlier fonts as well: In one case the heirs of Paul Renner
- (designer of Futura) won a suit against the Bauer foundry for
- arbitrarily discontinuing a portion of their royalties.
-
-England
- A copyright law passed in 1989 covers typeface designs first
- published in England (or published in Britain within 30 days of
- its publication elsewhere), and it _is_ retroactive. It's unclear
- how far back the law extends, but Times Roman, designed in the
- late 1920's and 1930's by Stanley Morison is probably covered.
- This does not mean GNU (for example) cannot have a Times Roman; it
- just means we cannot start with an English version, as the law
- does not forbid importing foreign versions of English typefaces.
-
-France
- The Romain du Roi typeface designed by Philippe Grandjean in 1702
- for the French royal family is protected, and perhaps other such
- "royal" designs. There is no protection for designs in general.
-
-
- In 1973 the international Vienna treaty on typeface design protection
-was proposed. France ratified it in 1974 or 1975, and Germany in 1981.
-The English law might constitute ratification, but this has not been
-settled. In any case, since at least four countries have to ratify it
-before it takes effect (and even then it takes effect only in those
-countries which ratify it), it is still of no consequence for now.
-
-
-File: fontname.info, Node: General index, Prev: Font legalities, Up: Top
+File: fontname.info, Node: General index, Prev: Encodings, Up: Top
General index
*************
@@ -15666,18 +15888,15 @@ General index
* Beebe, Nelson: History. (line 30)
* Beeton, Barbara: History. (line 30)
* Bernstein, Rocky: History. (line 30)
-* Bigelow, Charles: Font legalities. (line 6)
* bitstrea.map: Bitstream fonts. (line 6)
* bizarre font names: Suppliers. (line 31)
* Bouche, Thierry: History. (line 30)
* bright variant: Variants. (line 28)
* bugs, reporting: Introduction. (line 12)
* category codes: Long naming scheme. (line 34)
-* CD-ROM distribution: Filenames for fonts. (line 6)
* character scaling, automatic: Widths. (line 13)
* compression: Widths. (line 6)
* contributors: History. (line 30)
-* copyright on fonts: Font legalities. (line 6)
* Cork encoding: ec. (line 6)
* CP-1251 encoding: 6w. (line 6)
* Cugley, Damian: History. (line 30)
@@ -15686,15 +15905,13 @@ General index
* Cyrillic fonts: Variants. (line 86)
* design size specification: Filenames for fonts. (line 40)
* distribution: Introduction. (line 16)
-* DOS filesystems: Filenames for fonts. (line 6)
* dtc.map: DTC fonts. (line 6)
-* Dviljk translator: References. (line 31)
+* Dviljk translator: References. (line 26)
* Dvips encoding: dvips. (line 6)
-* Dvips translator: References. (line 24)
+* Dvips translator: References. (line 21)
* dvips.enc: dvips. (line 6)
* EC encoding: ec. (line 6)
* ec.enc: ec. (line 6)
-* eight-character limitation: Filenames for fonts. (line 6)
* encoding files: Introduction. (line 16)
* encoding vectors: Encodings. (line 6)
* encoding, Dvips: dvips. (line 6)
@@ -15713,7 +15930,6 @@ General index
* encodings, texnansi: texnansi. (line 6)
* encodings, texnansx: texnansx. (line 6)
* encodings, unspecified: Variants. (line 67)
-* England, font design protection law: Font legalities. (line 52)
* Ertner, Vincent: URW fonts. (line 6)
* escape for nonstandard names: Suppliers. (line 31)
* expansion: Widths. (line 6)
@@ -15723,30 +15939,23 @@ General index
* extension, TeX math encoding: texmext. (line 6)
* fax variant: Variants. (line 28)
* filenames, basics: Filenames for fonts. (line 11)
-* font copyrighting: Font legalities. (line 6)
* font scaling: Filenames for fonts. (line 40)
* font_coding_scheme: Long naming scheme. (line 30)
-* Fontinst distribution: References. (line 20)
+* Fontinst distribution: References. (line 17)
* FontName: Typefaces. (line 49)
* fontname mapping file: Name mapping file. (line 6)
* Fontname version 2: History. (line 14)
* foundries: Suppliers. (line 6)
-* France, font design protection law: Font legalities. (line 62)
-* Futura: Font legalities. (line 43)
* Garamond, versions of: Typefaces. (line 16)
-* Germany, font design protection law: Font legalities. (line 43)
-* Grandjean, Philippe: Font legalities. (line 62)
* Greek fonts: Variants. (line 86)
* Groff encoding: groff. (line 6)
* groff.enc: groff. (line 6)
* hexadecimal design size: Filenames for fonts. (line 40)
* history: History. (line 6)
-* Holmes, Kris: Font legalities. (line 6)
* Horn, Berthol: History. (line 30)
* individual font designers: Suppliers. (line 19)
* informal variant: Variants. (line 102)
* introduction: Introduction. (line 6)
-* ISO 9660: Filenames for fonts. (line 6)
* ISO Latin 2 extended and typewriter, TeX encoding: xt2. (line 6)
* ISO Latin 2 extended, TeX encoding: xl2. (line 6)
* italic, TeX math encoding: texmital. (line 6)
@@ -15755,10 +15964,8 @@ General index
* Knuth, Donald E.: Name mapping file. (line 28)
* Lang, Russell: History. (line 30)
* LaserJet 4 fonts: Variants. (line 67)
-* legalisms: Font legalities. (line 6)
* letterspacing: Variants. (line 17)
* ligatures and encodings: Variants. (line 53)
-* limitations: Filenames for fonts. (line 6)
* linotype.map: Linotype fonts. (line 6)
* long names: Long names. (line 6)
* long naming scheme: Long naming scheme. (line 6)
@@ -15766,7 +15973,6 @@ General index
* Lslash: Variants. (line 53)
* Lubalin, Herb: Suppliers. (line 9)
* Lucida Bright: 8r. (line 6)
-* Lucida, protection of: Font legalities. (line 25)
* MacKay, Pierre: History. (line 30)
* mapping file: Name mapping file. (line 6)
* mapping files: Introduction. (line 16)
@@ -15779,27 +15985,22 @@ General index
* Mittelbach, Frank: History. (line 6)
* modes.mf: References. (line 14)
* monotype.map: Monotype fonts. (line 6)
-* Morison, Stanley: Font legalities. (line 52)
* multiple variants: Variants. (line 9)
* nonstandard names, escape for: Suppliers. (line 31)
-* patenting of fonts: Font legalities. (line 6)
* phonetic encodings: Variants. (line 44)
* pi fonts: Typefaces. (line 42)
* PostScript encoding vectors: Encodings. (line 6)
* PostScript fonts, standard: Standard PostScript fonts.
(line 6)
-* PSfonts distribution: References. (line 17)
* qx encoding: qx. (line 6)
* qx.enc: qx. (line 6)
* Rahtz, Sebastian: History. (line 30)
* raw fonts: Suppliers. (line 25)
* references: References. (line 6)
* related files: References. (line 6)
-* Renner, Paul: Font legalities. (line 43)
* reporting bugs: Introduction. (line 12)
* Rivlin, Jean: History. (line 30)
* Rokicki, Tom: History. (line 30)
-* romain du roi: Font legalities. (line 62)
* sans variant: Variants. (line 117)
* Schoepf, Rainer: History. (line 6)
* schoolbook variant: Variants. (line 102)
@@ -15808,11 +16009,10 @@ General index
* semiserif variant: Variants. (line 28)
* small caps fonts: Variants. (line 17)
* small foundries: Suppliers. (line 19)
-* Southall, Richard: References. (line 34)
+* Southall, Richard: References. (line 29)
* standard PostScript fonts: Standard PostScript fonts.
(line 6)
* Stone Informal: Variants. (line 102)
-* Stone, protection of: Font legalities. (line 25)
* SuperFont: Variants. (line 44)
* supplier.map: Suppliers. (line 34)
* suppliers: Suppliers. (line 6)
@@ -15821,7 +16021,7 @@ General index
* T5 encoding: t5. (line 6)
* t5.enc: t5. (line 6)
* TDS standard: References. (line 8)
-* terminology: References. (line 34)
+* terminology: References. (line 29)
* TeX base encoding: 8r. (line 6)
* TeX Directory Structure standard: References. (line 8)
* TeX Latin 1 encoding: ec. (line 6)
@@ -15837,20 +16037,16 @@ General index
* texnansi.enc: texnansi. (line 6)
* texnansx encoding: texnansx. (line 6)
* texnansx.enc: texnansx. (line 6)
-* Times Roman, protection of: Font legalities. (line 52)
* type foundries: Suppliers. (line 6)
-* typeface design protection: Font legalities. (line 6)
* typeface.map: Typefaces. (line 49)
* typefaces: Typefaces. (line 6)
* typewriter variant: Variants. (line 117)
* unattributed fonts: Suppliers. (line 19)
-* United States, font design protection law: Font legalities. (line 25)
* URW fonts: URW fonts. (line 6)
* urw.map: URW fonts. (line 34)
* utilities: Introduction. (line 16)
* variant.map: Variants. (line 132)
* variants: Variants. (line 6)
-* Vienna treaty: Font legalities. (line 68)
* Vietnamese encoding: t5. (line 6)
* weight: Weights. (line 6)
* weight.map: Weights. (line 14)
@@ -15865,45 +16061,44 @@ General index

Tag Table:
Node: Top260
-Node: Introduction2037
-Node: History3104
-Node: References4919
-Node: Filenames for fonts6470
-Node: Suppliers8073
-Node: Typefaces10608
-Node: Weights31449
-Node: Variants32262
-Node: Widths42471
-Node: Long names43879
-Node: Name mapping file44438
-Node: Long naming scheme46016
-Node: Font name lists47772
-Node: Standard PostScript fonts48231
-Node: Adobe fonts49693
-Node: Apple fonts239673
-Node: Bitstream fonts240007
-Node: DTC fonts300771
-Node: ITC fonts301688
-Node: Linotype fonts347328
-Node: Monotype fonts603354
-Node: URW fonts689911
-Node: Encodings693110
-Node: 6w695170
-Node: 8a697655
-Node: 8r700165
-Node: dvips705149
-Node: ec708955
-Node: groff712470
-Node: t5717404
-Node: qx725355
-Node: texmext766827
-Node: texmsym770683
-Node: texmital773866
-Node: texnansi776600
-Node: texnansx783679
-Node: xl2788658
-Node: xt2793645
-Node: Font legalities798272
-Node: General index802095
+Node: Introduction1969
+Node: History3036
+Node: References4851
+Node: Filenames for fonts6171
+Node: Suppliers7913
+Node: Typefaces10494
+Node: Weights31520
+Node: Variants32333
+Node: Widths42613
+Node: Long names44021
+Node: Name mapping file44580
+Node: Long naming scheme46161
+Node: Font name lists47917
+Node: Standard PostScript fonts48376
+Node: Adobe fonts49838
+Node: Apple fonts239818
+Node: Bitstream fonts240152
+Node: DTC fonts300916
+Node: ITC fonts301833
+Node: Linotype fonts347473
+Node: Monotype fonts603499
+Node: URW fonts690056
+Node: Encodings693255
+Node: 6w695313
+Node: 8a697798
+Node: 8r700308
+Node: dvips705292
+Node: ec709098
+Node: groff720921
+Node: t5725855
+Node: qx733806
+Node: texmext775278
+Node: texmsym779134
+Node: texmital782317
+Node: texnansi785051
+Node: texnansx797470
+Node: xl2802819
+Node: xt2807806
+Node: General index812433

End Tag Table
diff --git a/Master/texmf/doc/info/kpathsea.info b/Master/texmf/doc/info/kpathsea.info
index 52e8fdc336f..6850dccfb61 100644
--- a/Master/texmf/doc/info/kpathsea.info
+++ b/Master/texmf/doc/info/kpathsea.info
@@ -1,10 +1,10 @@
-This is kpathsea.info, produced by makeinfo version 4.12 from
+This is kpathsea.info, produced by makeinfo version 4.13 from
kpathsea.texi.
This file documents the Kpathsea library for path searching.
Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
-2005, 2007, 2008 Karl Berry & Olaf Weber.
+2005, 2007, 2008, 2009 Karl Berry & Olaf Weber.
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@@ -18,7 +18,7 @@ permission notice identical to this one.
Permission is granted to copy and distribute translations of this
manual into another language, under the above conditions for modified
versions, except that this permission notice may be stated in a
-translation approved by the Free Software Foundation.
+translation approved by the TeX Users Group.
INFO-DIR-SECTION TeX
START-INFO-DIR-ENTRY
@@ -39,8 +39,8 @@ Kpathsea library
****************
This manual documents how to install and use the Kpathsea library for
-filename lookup. It corresponds to version 3.5.7, released in
-July 2008.
+filename lookup. It corresponds to version 5.0.0, released in
+June 2009.
* Menu:
@@ -60,8 +60,8 @@ File: kpathsea.info, Node: Introduction, Next: Installation, Prev: Top, Up:
1 Introduction
**************
-This manual corresponds to version 3.5.7 of the Kpathsea library,
-released in July 2008.
+This manual corresponds to version 5.0.0 of the Kpathsea library,
+released in June 2009.
The library's fundamental purpose is to return a filename from a
list of directories specified by the user, similar to what shells do
@@ -91,22 +91,14 @@ library, you must (offer to) distribute the source to the library,
along with any changes you have made, and allow anyone to modify the
library source and distribute their modifications. It does not mean
you have to distribute the source to your program, although we hope you
-will. See the files `GPL' and `LGPL' for the text of the GNU licenses.
+will. See the accompanying files for the text of the GNU licenses.
If you know enough about TeX to be reading this manual, then you (or
your institution) should consider joining the TeX Users Group (if
-you're already a member, great!). TUG produces the periodical
+you're already a member, thanks!). TUG produces the periodical
`TUGboat', sponsors an annual meeting and publishes the proceedings,
and arranges courses on TeX for all levels of users throughout the
-world. Anyway, here is the address:
-
- TeX Users Group
- P.O. Box 2311
- Portland OR 97208-2311
- USA
- phone: +1 503 223-9994
- fax: +1 503 223-3960
- email: <tug@tug.org>
+world. See `http://tug.org' for information.
* Menu:
@@ -1249,7 +1241,7 @@ This is `ftp://ftp.tug.org/tex/unixtex.ftp', last updated 26 December
2003. Also available as `http://www.tug.org/unixtex.ftp'. The IP
address is currently `[130.225.2.178]'. It is also in Kpathsea source
distributions as `etc/unixtex.ftp' (although the network version is
-usually newer). Mail <tex-k@mail.tug.org> with comments or questions.
+usually newer). Mail <tex-k@tug.org> with comments or questions.
Following are general instructions for Unix or other sites who wish
to acquire the Web2c distribution, (plain) TeX, LaTeX (2e), BibTeX,
@@ -1374,13 +1366,11 @@ Numerous organizations distribute various TeX CD-ROM's (and DVD's):
minimal TeX source distribution described in the previous section
(i.e., enough to print GNU documentation); email <gnu@gnu.org>.
- * Most Linux distributions include some TeX package based on Web2c;
- see the Linux documentation file `Distribution-HOWTO' for a
- comparison of Linux distributions, available (for example) via
- `http://www.linux.org'.
+ * Most GNU/Linux distributions include some TeX package based on TeX
+ Live.
If you know of additional TeX distributions to add to this list,
-please inform <tex-k@mail.tug.org>.
+please inform <tex-k@tug.org>.

File: kpathsea.info, Node: Other TeX packages, Prev: CD-ROM distribution, Up: unixtex.ftp
@@ -1417,7 +1407,7 @@ File: kpathsea.info, Node: Reporting bugs, Prev: unixtex.ftp, Up: Installatio
(A copy of this chapter is in the file `kpathsea/BUGS'.)
If you have problems or suggestions, please report them to
-<tex-k@mail.tug.org> using the bug checklist below.
+<tex-k@tug.org> using the bug checklist below.
Please report bugs in the documentation; not only factual errors or
inconsistent behavior, but unclear or incomplete explanations, typos,
@@ -1440,8 +1430,7 @@ File: kpathsea.info, Node: Bug checklist, Next: Mailing lists, Up: Reporting
Before reporting a bug, please check below to be sure it isn't already
known (*note Common problems::).
- Bug reports should be sent via electronic mail to
-<tex-k@mail.tug.org>.
+ Bug reports should be sent via electronic mail to <tex-k@tug.org>.
The general principle is that a good bug report includes all the
information necessary for reproduction. Therefore, to enable
@@ -1513,8 +1502,8 @@ File: kpathsea.info, Node: Mailing lists, Next: Debugging, Prev: Bug checklis
-------------------
Web2c and Kpathsea in general are discussed on the mailing list
-<tex-k@mail.tug.org>. To join, email <tex-k-request@mail.tug.org> with
-a line consisting of
+<tex-k@tug.org>. To join, email <tex-k-request@tug.org> with a line
+consisting of
subscribe YOU@YOUR.PREFERRED.EMAIL.ADDRESS
@@ -1531,14 +1520,11 @@ or not is read some of the archives from
Be aware that large data files are sometimes included in bug reports.
If this is a problem for you, do not join the list.
- If you only want announcements of new releases, not bug reports and
-discussion, join <tex-archive@math.utah.edu> (via mail to
-<tex-archive-request@math.utah.edu>).
-
If you are looking for general TeX help, such as how to use LaTeX,
-please use the mailing list <info-tex@shsu.edu> mailing list, which is
-gatewayed to the `comp.text.tex' Usenet newsgroup (or post to the
-newsgroup; the gateway is bidirectional).
+please use the mailing list <texhax@tug.org> mailing list
+(`http://lists.tug.org/texhax') which is gatewayed to the
+`comp.text.tex' Usenet newsgroup (or post to the newsgroup; the gateway
+is bidirectional).

File: kpathsea.info, Node: Debugging, Next: Logging, Prev: Mailing lists, Up: Reporting bugs
@@ -1560,8 +1546,8 @@ program-specific debugging options as well.
You can also set the environment variable `KPATHSEA_DEBUG'; in this
case, you should use the numbers below. If you run the program under a
-debugger and set the variable `kpathsea_debug', also use the numbers
-below.
+debugger and set the instance variable `kpse->debug', also use the
+numbers below.
In any case, by far the simplest value to use is `-1', which will
turn on all debugging output. This is usually better than guessing
@@ -2441,7 +2427,7 @@ more work.
500 regular files, `st_nlink' will be 3, and Kpathsea has to stat every
one of those 501 entries. Therein lies slowness.
- You can disable the trick by undefining `UNIX_ST_LINK' in
+ You can disable the trick by undefining `ST_NLINK_TRICK' in
`kpathsea/config.h'. (It is undefined by default except under Unix.)
Unfortunately, in some cases files in leaf directories are `stat''d:
@@ -2691,15 +2677,17 @@ filename, and returns the first file found.
Here's the current list of recognized names and the associated
suffixes. *Note Supported file formats::, for more information on
each of these.
+
gf: gf
pk: pk
- bitmap font
+ bitmap font:
+ tfm: .tfm
afm: .afm
base: .base
bib: .bib
bst: .bst
cnf: .cnf
- ls-R: ls-R
+ ls-R: ls-R ls-r
fmt: .fmt
map: .map
mem: .mem
@@ -2708,40 +2696,42 @@ filename, and returns the first file found.
mft: .mft
mp: .mp
mppool: .pool
- MetaPost support
+ MetaPost support:
ocp: .ocp
ofm: .ofm .tfm
opl: .opl
otp: .otp
ovf: .ovf
ovp: .ovp
- graphic/figure: .eps .epsi
- tex: .tex
- TeX system documentation
+ graphic/figure: .eps .epsi
+ tex: .tex .sty .cls .fd .aux .bbl .def .clo .ldf
+ TeX system documentation:
texpool: .pool
- TeX system sources
- PostScript header/font: .pro
- Troff fonts
- tfm: .tfm
+ TeX system sources: .dtx .ins
+ PostScript header: .pro
+ Troff fonts:
type1 fonts: .pfa .pfb
vf: .vf
- dvips config
+ dvips config:
ist: .ist
- truetype fonts: .ttf .ttc
- type42 fonts
- web2c files
- other text files
- other binary files
- misc fonts
- web: .web
- cweb: .w .web
- enc: .enc
- cmap: .cmap
- sfd: .sfd
- opentype fonts
- pdftex config
+ truetype fonts: .ttf .ttc .TTF .TTC
+ type42 fonts: .t42 .T42
+ web2c files:
+ other text files:
+ other binary files:
+ misc fonts:
+ web: .web .ch
+ cweb: .w .web .ch
+ enc files: .enc
+ cmap files:
+ subfont definition files: .sfd
+ opentype fonts: .otf
+ pdftex config:
lig files: .lig
- texmfscripts
+ texmfscripts:
+ lua: .luc .luctex .texluc .lua .luatex .texlua
+ font feature files: .fea
+ cid maps: .cid .cidmap
This option and `--path' are mutually exclusive.
@@ -2884,6 +2874,9 @@ their corresponding format:
`texmf.cnf'
`cnf'
+`XDvi'
+ `other text files'
+
A user-specified format will override the above defaults.
@@ -3012,8 +3005,8 @@ environment variables with an underscore, e.g., `TEXINPUTS_latex'
(web2c)bibtex invocation.) `BIBINPUTS', `TEXBIB'; suffix `.bib'.
`bst'
- (BibTeX style file, *note Basic BibTeX style files: (web2c)Basic
- BibTeX style files.) `BSTINPUTS'; suffix `.bst'.
+ (BibTeX style, *note Basic BibTeX style files: (web2c)Basic BibTeX
+ style files.) `BSTINPUTS'; suffix `.bst'.
`cmap'
(character map files) `CMAPFONTS'; suffix `.cmap'.
@@ -3037,6 +3030,13 @@ environment variables with an underscore, e.g., `TEXINPUTS_latex'
(TeX memory dump, *note Memory dumps: (web2c)Memory dumps.)
`TEXFORMATS', `TEXMFINI'; suffix `.fmt'.
+`font cid map'
+ (CJK mapping) `FONTCIDMAPS' suffix `.cid'.
+
+`font feature files'
+ (primarily for OpenType font features) `FONTFEATURES' suffix
+ `.fea'.
+
`gf'
(generic font bitmap, *note Glyph files: (dvips)Glyph files.)
`PROGRAMFONTS', `GFFONTS', `GLYPHFONTS', `TEXFONTS'; suffix `gf'.
@@ -3083,6 +3083,14 @@ environment variables with an underscore, e.g., `TEXINPUTS_latex'
(font-related files that don't fit the other categories)
`MISCFONTS'
+`mlbib'
+ (MlBibTeX bibliography source) `MLBIBINPUTS', `BIBINPUTS',
+ `TEXBIB'; suffixes `.mlbib', `.mlbib'.
+
+`mlbst'
+ (MlBibTeX style) `MLBSTINPUTS', `BSTINPUTS'; suffixes `.mlbst',
+ `.bst'.
+
`mp'
(MetaPost source, *note mpost invocation: (web2c)mpost invocation.)
`MPINPUTS'; suffix `.mp'.
@@ -3248,7 +3256,7 @@ tried; the difference is the order in which they are tried.
*already* have an extension. A name without an extension (e.g., `tex
story') will always have an extension added first.
- This algorithm is implemented in the routine `kpse_find_file' in
+ This algorithm is implemented in the routine `kpathsea_find_file' in
`kpathsea/tex-file.c'. You can watch it in action with the debugging
options (*note Debugging::).
@@ -3278,7 +3286,7 @@ first successful lookup.
4. Look for FALLBACK.DPI, where FALLBACK is some last-resort font
(typically `cmr10').
- This is implemented in `kpse_find_glyph_format' in
+ This is implemented in `kpathsea_find_glyph' in
`kpathsea/tex-glyph.c'.
* Menu:
@@ -3396,9 +3404,8 @@ to find fonts at their stated size or not at all.
Finally, if the font cannot be found even at the fallback
resolutions, Kpathsea looks for a fallback font, typically `cmr10'.
-Programs must enable this feature by assigning to the global variable
-`kpse_fallback_font' or calling `kpse_init_prog' (*note Calling
-sequence::); the default is no fallback font.
+Programs must enable this feature by calling `kpathsea_init_prog'
+(*note Calling sequence::); the default is no fallback font.

File: kpathsea.info, Node: Suppressing warnings, Prev: Glyph lookup, Up: TeX support
@@ -3459,16 +3466,24 @@ File: kpathsea.info, Node: Programming overview, Next: Calling sequence, Up:
5.1 Programming overview
========================
-Aside from this manual, your best source of information is the source to
-the programs I've modified to use Kpathsea (*note Introduction::). Of
-those, Dviljk is probably the simplest, and hence a good place to start.
+Aside from this manual, your best source of information is the source
+to the programs that use Kpathsea (*note Introduction::). Of those,
+Dviljk is probably the simplest, and hence a good place to start.
Xdvik adds VF support and the complication of X resources. Dvipsk adds
the complication of its own config files. Web2c is source code I also
-maintain, so it uses Kpathsea rather straightforwardly, but is of course
-complicated by the Web to C translation. Finally, Kpsewhich is a small
-utility program whose sole purpose is to exercise the main
+maintain, so it uses Kpathsea rather straightforwardly, but is of
+course complicated by the Web to C translation. Finally, Kpsewhich is
+a small utility program whose sole purpose is to exercise the main
path-searching functionality.
+ When looking at these program sources, you should know that previous
+versions of the library had a different programming interface, to
+support re-entrancy. In that interface the library function names were
+prefixed with `kpse_' instead of `kpathsea_', and they did not need an
+instance variable as first argument. This change was made in 2009.
+Some of the programs mentioned above may still be using the previous
+interface.
+
Beyond these examples, the `.h' files in the Kpathsea source
describe the interfaces and functionality (and of course the `.c' files
define the actual routines, which are the ultimate documentation).
@@ -3507,40 +3522,39 @@ File: kpathsea.info, Node: Calling sequence, Next: Program-specific files, Pr
The typical way to use Kpathsea in your program goes something like
this:
- 1. Call `kpse_set_program_name' with `argv[0]' as the first argument;
- the second argument is a string or `NULL'. The second argument is
- used by Kpathsea as the program name for the `.PROGRAM' feature of
- config files (*note Config files::). If the second argument is
- `NULL', the value of the first argument is used. This function
- must be called before any other use of the Kpathsea library.
-
- `kpse_set_program_name' always sets the global variables
- `program_invocation_name' and `program_invocation_short_name'.
- These variables are used in the error message macros defined in
- `kpathsea/lib.h'. It sets the global variable `kpse_program_name'
- to the program name it uses.
+ 1. Call `kpathsea_new' to create a new library instance. This variable
+ must be passed as the first argument to all the following library
+ functions. The rest of this manual will be using `kpse' as a
+ placeholder for the name of this variable.
+
+ 2. Call `kpathsea_set_program_name' with `argv[0]' as the second
+ argument; the third argument is a string or `NULL'. The third
+ argument is used by Kpathsea as the program name for the
+ `.PROGRAM' feature of config files (*note Config files::). If the
+ third argument is `NULL', the value of the second argument is
+ used. This function must be called before any other use of the
+ Kpathsea library.
+
+ `kpathsea_set_program_name' always sets the variables
+ `kpse->invocation_name' and `kpse->invocation_short_name'. These
+ variables are used in the error message macros defined in
+ `kpathsea/lib.h'. It sets the variable `kpse->program_name' to
+ the program name it uses.
It also initializes debugging options based on the environment
variable `KPATHSEA_DEBUG' (if that is set).
- Finally, it sets the variables `SELFAUTOLOC', `SELFAUTODIR' and
- `SELFAUTOPARENT' to the location, parent and grandparent directory
- of the executable, removing `.' and `..' path elements and
- resolving symbolic links. These are used in the default
- configuration file to allow people to invoke TeX from anywhere.
- You can use `kpsewhich --expand-var=\$SELFAUTOLOC', etc., to see
- the values.
-
- 2. The `kpse_set_progname' is deprecated. A call to
- `kpse_set_progname' with `argv[0]' is equivalent to a call of
- `kpse_set_program_name' with first argument `argv[0]' and second
- argument `NULL'. The function is deprecated because it cannot
- ensure that the `.PROGRAM' feature of config files will always
- work (*note Config files::).
+ Finally, it sets the environment variables `SELFAUTOLOC',
+ `SELFAUTODIR' and `SELFAUTOPARENT' to the location, parent and
+ grandparent directory of the executable, removing `.' and `..' path
+ elements and resolving symbolic links. These are used in the
+ default configuration file to allow people to invoke TeX from
+ anywhere. You can use `kpsewhich --expand-var=\$SELFAUTOLOC',
+ etc., to see the values.
3. Set debugging options. *Note Debugging::. If your program doesn't
have a debugging option already, you can define one and set
- `kpathsea_debug' to the number that the user supplies (as in Dviljk
+ `kpse->debug' to the number that the user supplies (as in Dviljk
and Web2c), or you can just omit this altogether (people can
always set `KPATHSEA_DEBUG'). If you do have runtime debugging
already, you need to merge Kpathsea's options with yours (as in
@@ -3548,12 +3562,12 @@ this:
4. If your program has its own configuration files that can define
search paths, you should assign those paths to the `client_path'
- member in the appropriate element of the `kpse_format_info' array.
- (This array is indexed by file type; see `tex-file.h'.) See
- `resident.c' in Dvipsk for an example.
+ member in the appropriate element of the `kpse->format_info'
+ array. (This array is indexed by file type; see `tex-file.h'.)
+ See `resident.c' in Dvipsk for an example.
- 5. Call `kpse_init_prog' (see `proginit.c'). It's useful for the DVI
- drivers, at least, but for other programs it may be simpler to
+ 5. Call `kpathsea_init_prog' (see `proginit.c'). It's useful for the
+ DVI drivers, at least, but for other programs it may be simpler to
extract the parts of it that actually apply. This does not
initialize any paths, it just looks for (and sets) certain
environment variables and other random information. (A search
@@ -3562,26 +3576,28 @@ this:
the BibTeX search paths in a DVI driver.)
6. The routine to actually find a file of type FORMAT is
- `kpse_find_FORMAT', defined in `tex-file.h'. These are macros that
- expand to a call to `kpse_find_file'. You can call, say,
- `kpse_find_tfm' after doing only the first of the initialization
- steps above--Kpathsea automatically reads the `texmf.cnf' generic
- config files, looks for environment variables, and does expansions
- at the first lookup.
-
- 7. To find PK and/or GF bitmap fonts, the routines are `kpse_find_pk',
- `kpse_find_gf' and `kpse_find_glyph', defined in `tex-glyph.h'.
- These return a structure in addition to the resultant filename,
- because fonts can be found in so many ways. See the documentation
- in the source.
+ `kpathsea_find_file'. You can call `kpathsea_find_file' after
+ doing only the first and second of the initialization steps
+ above--Kpathsea automatically reads the `texmf.cnf' generic config
+ files, looks for environment variables, and does expansions at the
+ first lookup.
+
+ 7. To find PK and/or GF bitmap fonts, the routine is
+ `kpathsea_find_glyph', defined in `tex-glyph.h'. This returns a
+ structure in addition to the resultant filename, because fonts can
+ be found in so many ways. See the documentation in the source.
8. To actually open a file, not just return a filename, call
- `kpse_open_file'. This function takes the name to look up and a
- Kpathsea file format as arguments, and returns the usual `FILE *'.
- It always assumes the file must exist, and thus will search the
- disk if necessary (unless the search path specified `!!', etc.).
- In other words, if you are looking up a VF or some other file that
- need not exist, don't use this.
+ `kpathsea_open_file'. This function takes the name to look up and
+ a Kpathsea file format as arguments, and returns the usual `FILE
+ *'. It always assumes the file must exist, and thus will search
+ the disk if necessary (unless the search path specified `!!',
+ etc.). In other words, if you are looking up a VF or some other
+ file that need not exist, don't use this.
+
+ 9. To close the kpathsea library instance you are using, call
+ `kpathsea_finish'. This function closes any open log files and
+ frees the memory used by the instance.
Kpathsea also provides many utility routines. Some are generic: hash
@@ -3617,7 +3633,8 @@ That is to say, the name of the variable is constructed by converting
the name of the program to upper case, and appending `INPUTS'.
The only difference between these two formats is whether
-`kpse_open_file' will open the files it finds in text or binary mode.
+`kpathsea_open_file' will open the files it finds in text or binary
+mode.

File: kpathsea.info, Node: Programming with config files, Prev: Program-specific files, Up: Programming
@@ -3630,22 +3647,22 @@ file that Kpathsea uses for your program. This helps installers by
keeping all configuration in one place.
To retrieve a value VAR from config files, the best way is to call
-`kpse_var_value' on the string `VAR'. This will look first for an
+`kpathsea_var_value' on the string `VAR'. This will look first for an
environment variable VAR, then a config file value. The result will be
the value found or `NULL'. This function is declared in
`kpathsea/variable.h'. For an example, see the `shell_escape' code in
`web2c/lib/texmfmp.c'.
The routine to do variable expansion in the context of a search path
-(as opposed to simply retrieving a value) is `kpse_var_expand', also
+(as opposed to simply retrieving a value) is `kpathsea_var_expand', also
declared in `kpathsea/variable.h'. It's generally only necessary to
set the search path structure components as explained in the previous
section, rather than using this yourself.
If for some reason you want to retrieve a value _only_ from a config
file, not automatically looking for a corresponding environment
-variable, call `kpse_cnf_get' (declared in `kpathsea/cnf.h') with the
-string VAR.
+variable, call `kpathsea_cnf_get' (declared in `kpathsea/cnf.h') with
+the string VAR.
No initialization calls are needed.
@@ -3680,20 +3697,20 @@ Index
(line 38)
* --help: Standard options. (line 8)
* --interactive: Path searching options.
- (line 106)
+ (line 110)
* --mode=STRING: Path searching options.
- (line 117)
+ (line 121)
* --must-exist: Path searching options.
- (line 122)
+ (line 126)
* --path=STRING: Path searching options.
- (line 127)
+ (line 131)
* --progname=NAME: Path searching options.
- (line 136)
+ (line 140)
* --show-path=NAME: Auxiliary tasks. (line 41)
* --srcdir, for building multiple architectures: configure scenarios.
(line 18)
* --subdir=STRING: Path searching options.
- (line 141)
+ (line 145)
* --var-value=VARIABLE: Auxiliary tasks. (line 12)
* --version: Standard options. (line 10)
* --with options: configure options. (line 16)
@@ -3714,9 +3731,9 @@ Index
* -g, compiling without: configure scenarios. (line 32)
* -L option to ls: ls-R. (line 38)
* -mktex=FILETYPE: Path searching options.
- (line 111)
+ (line 115)
* -no-mktex=FILETYPE: Path searching options.
- (line 111)
+ (line 115)
* -O, compiling with: configure scenarios. (line 32)
* -static: ShellWidgetClass. (line 43)
* . directories, ignored: ls-R. (line 33)
@@ -3731,6 +3748,8 @@ Index
(line 28)
* .bst: Supported file formats.
(line 32)
+* .cid: Supported file formats.
+ (line 58)
* .cmap: Supported file formats.
(line 36)
* .cnf: Supported file formats.
@@ -3738,61 +3757,67 @@ Index
* .enc: Supported file formats.
(line 51)
* .eps: Supported file formats.
- (line 62)
+ (line 69)
* .epsi: Supported file formats.
- (line 62)
+ (line 69)
+* .fea: Supported file formats.
+ (line 61)
* .fmt: Supported file formats.
(line 54)
* .ist: Supported file formats.
- (line 67)
+ (line 74)
* .lig: Supported file formats.
- (line 71)
+ (line 78)
* .map: Supported file formats.
- (line 77)
+ (line 84)
* .mem: Supported file formats.
- (line 80)
+ (line 87)
* .mf: Supported file formats.
- (line 88)
+ (line 95)
* .mft: Supported file formats.
- (line 96)
+ (line 103)
+* .mlbib: Supported file formats.
+ (line 111)
+* .mlbst: Supported file formats.
+ (line 115)
* .mp: Supported file formats.
- (line 104)
+ (line 119)
* .ocp: Supported file formats.
- (line 112)
+ (line 127)
* .ofm: Supported file formats.
- (line 116)
+ (line 131)
* .opl: Supported file formats.
- (line 123)
+ (line 138)
* .otp: Supported file formats.
- (line 126)
+ (line 141)
* .ovf: Supported file formats.
- (line 129)
+ (line 144)
* .ovp: Supported file formats.
- (line 132)
+ (line 147)
* .pfa: Supported file formats.
- (line 184)
+ (line 199)
* .pfb: Supported file formats.
- (line 184)
+ (line 199)
* .pk: Supported file formats.
- (line 139)
+ (line 154)
* .pool: Supported file formats.
- (line 92)
+ (line 99)
* .pro: Supported file formats.
- (line 145)
+ (line 160)
* .rhosts, writable by TeX: Security. (line 10)
* .sfd: Supported file formats.
- (line 149)
+ (line 164)
* .tex: Supported file formats.
- (line 152)
+ (line 167)
* .tex file, included in ls-R: ls-R. (line 33)
* .tfm: Supported file formats.
- (line 172)
+ (line 187)
* .ttc: Supported file formats.
- (line 181)
+ (line 196)
* .ttf: Supported file formats.
- (line 181)
+ (line 196)
* .vf: Supported file formats.
- (line 192)
+ (line 207)
* .w: Supported file formats.
(line 43)
* .web: Supported file formats.
@@ -3839,6 +3864,8 @@ Index
* announcement mailing list: Mailing lists. (line 6)
* ANSI C: TeX or Metafont failing.
(line 30)
+* API, re-entrant: Programming overview.
+ (line 16)
* append-only directories and mktexpk: Security. (line 36)
* appendonlydir: mktex configuration. (line 61)
* architecture-(in)dependent files, installing only: Installing files.
@@ -3846,9 +3873,9 @@ Index
* architectures, compiling multiple: configure scenarios. (line 18)
* arguments to mktex: mktex script arguments.
(line 6)
-* argv[0]: Calling sequence. (line 9)
+* argv[0]: Calling sequence. (line 14)
* ash, losing with configure: configure shells. (line 19)
-* autoconf, recommended: Calling sequence. (line 93)
+* autoconf, recommended: Calling sequence. (line 94)
* automounter, and configuration: configure scenarios. (line 29)
* automounter, and ls-R: ls-R. (line 40)
* auxiliary tasks: Auxiliary tasks. (line 6)
@@ -3876,9 +3903,9 @@ Index
* bug checklist: Bug checklist. (line 6)
* bug mailing list: Mailing lists. (line 6)
* bugs, reporting: Reporting bugs. (line 6)
-* c-*.h: Calling sequence. (line 93)
+* c-*.h: Calling sequence. (line 94)
* c-auto.h: Programming overview.
- (line 25)
+ (line 33)
* c-auto.in: Running configure. (line 6)
* cache of fonts, local: Security. (line 22)
* calling sequence: Calling sequence. (line 6)
@@ -3891,13 +3918,13 @@ Index
* CD-ROM distributions: CD-ROM distribution. (line 6)
* CFLAGS: configure environment.
(line 14)
-* ChangeLog entry: Bug checklist. (line 56)
+* ChangeLog entry: Bug checklist. (line 55)
* checklist for bug reports: Bug checklist. (line 6)
* checksum: Suppressing warnings.
(line 16)
* circle fonts: Fontmap. (line 19)
* clean Make target: Cleaning up. (line 15)
-* client_path in kpse_format_info: Calling sequence. (line 48)
+* client_path in kpse->format_info: Calling sequence. (line 47)
* CMAPFONTS: Supported file formats.
(line 36)
* cmr10, as fallback font: Fallback font. (line 15)
@@ -3913,7 +3940,7 @@ Index
* common features in glyph lookup: Basic glyph lookup. (line 6)
* common problems: Common problems. (line 6)
* comp.sys.sun.admin FAQ: ShellWidgetClass. (line 6)
-* comp.text.tex: Mailing lists. (line 29)
+* comp.text.tex: Mailing lists. (line 25)
* compilation: Installation. (line 6)
* compilation value, source for path: Path sources. (line 20)
* compiler bugs: TeX or Metafont failing.
@@ -3929,19 +3956,19 @@ Index
* conditions for use: Introduction. (line 31)
* config files: Config files. (line 6)
* config files, for Kpathsea-using programs: Calling sequence.
- (line 48)
+ (line 47)
* config files, programming with: Programming with config files.
(line 6)
* config.h: Programming overview.
- (line 25)
-* config.log: Bug checklist. (line 28)
+ (line 33)
+* config.log: Bug checklist. (line 27)
* config.ps: Specially-recognized files.
(line 16)
* config.ps, search path for: Supported file formats.
(line 47)
-* config.status: Bug checklist. (line 31)
+* config.status: Bug checklist. (line 30)
* configuration: Installation. (line 6)
-* configuration bugs: Bug checklist. (line 31)
+* configuration bugs: Bug checklist. (line 30)
* configuration compiler options: configure environment.
(line 23)
* configuration file, source for path: Path sources. (line 17)
@@ -3952,12 +3979,12 @@ Index
* configure options: configure options. (line 6)
* configure options for mktex scripts: mktex configuration. (line 12)
* configure, running: Running configure. (line 6)
-* context diff: Bug checklist. (line 56)
+* context diff: Bug checklist. (line 55)
* continuation character: Config files. (line 31)
-* core dumps, reporting: Bug checklist. (line 62)
+* core dumps, reporting: Bug checklist. (line 61)
* CPPFLAGS: configure environment.
(line 22)
-* crashes, reporting: Bug checklist. (line 62)
+* crashes, reporting: Bug checklist. (line 61)
* CTAN, defined: Electronic distribution.
(line 6)
* CTAN.sites: Electronic distribution.
@@ -3969,10 +3996,10 @@ Index
* database, for filenames: Filename database. (line 6)
* database, format of: Database format. (line 6)
* debug.h: Debugging. (line 6)
-* debugger: Bug checklist. (line 62)
+* debugger: Bug checklist. (line 61)
* debugging: Debugging. (line 6)
* debugging options, in Kpathsea-using program: Calling sequence.
- (line 40)
+ (line 39)
* debugging output: Debugging. (line 27)
* debugging with -g, disabling: configure scenarios. (line 32)
* DEC shells and configure: configure shells. (line 25)
@@ -4013,7 +4040,7 @@ Index
* dlsym: dlopen. (line 6)
* dlsym.c: dlopen. (line 21)
* doc files: Supported file formats.
- (line 158)
+ (line 173)
* DOS compatible names: mktex configuration. (line 69)
* DOS support: Custom installation. (line 19)
* DOS TeX implementations: Other TeX packages. (line 6)
@@ -4028,9 +4055,9 @@ Index
* dvipdfmx.cfg: Specially-recognized files.
(line 19)
* DVIPSFONTS: Supported file formats.
- (line 227)
+ (line 242)
* DVIPSHEADERS: Supported file formats.
- (line 184)
+ (line 199)
* DVIPSMAKEPK: mktex script names. (line 32)
* DVIPSSIZES: Fallback font. (line 6)
* dynamic creation of files: mktex scripts. (line 6)
@@ -4053,10 +4080,10 @@ Index
* environment variables, old: Unable to find files.
(line 14)
* epoch, seconds since: Logging. (line 15)
-* error message macros: Calling sequence. (line 16)
+* error message macros: Calling sequence. (line 22)
* excessive startup time: Slow path searching. (line 6)
* expand.c: Brace expansion. (line 26)
-* expanding symlinks: Calling sequence. (line 25)
+* expanding symlinks: Calling sequence. (line 31)
* expansion, default: Default expansion. (line 6)
* expansion, path element: Searching overview. (line 43)
* expansion, search path: Path expansion. (line 6)
@@ -4084,7 +4111,7 @@ Index
* file lookup: File lookup. (line 6)
* file permissions: Security. (line 47)
* file types, registering new: Programming overview.
- (line 31)
+ (line 39)
* filename aliases: Filename aliases. (line 6)
* filename database: Filename database. (line 6)
* filename database generation: Filename database generation.
@@ -4104,13 +4131,17 @@ Index
(line 6)
* font of last resort: Fallback font. (line 6)
* font set, infinite: mktex scripts. (line 6)
+* FONTCIDMAPS: Supported file formats.
+ (line 58)
+* FONTFEATURES: Supported file formats.
+ (line 61)
* fontmap files: Fontmap. (line 6)
* fontmaps: mktex configuration. (line 87)
* fontname: mktex configuration. (line 88)
* fontnames, arbitrary length: Fontmap. (line 15)
* fonts, being created: Simple installation. (line 79)
* FOOINPUTS: Supported file formats.
- (line 209)
+ (line 224)
* fopen, redefined: Debugging. (line 54)
* format of external database: Database format. (line 6)
* Free Software Foundation: CD-ROM distribution. (line 12)
@@ -4123,20 +4154,20 @@ Index
* fundamental purpose of Kpathsea: Introduction. (line 6)
* gcc, compiling with: configure environment.
(line 11)
-* gdb, recommended: Bug checklist. (line 62)
+* gdb, recommended: Bug checklist. (line 61)
* generation of filename database: Filename database generation.
(line 6)
* get_applicationShellWidgetClass: ShellWidgetClass. (line 6)
* get_wmShellWidgetClass: ShellWidgetClass. (line 6)
* gf: Supported file formats.
- (line 58)
+ (line 65)
* GFFONTS: Supported file formats.
- (line 58)
+ (line 65)
* globally writable directories: Security. (line 30)
* glyph lookup: Glyph lookup. (line 6)
* glyph lookup bitmap tolerance: Basic glyph lookup. (line 15)
* GLYPHFONTS: Supported file formats.
- (line 58)
+ (line 65)
* glyphlist.txt: Specially-recognized files.
(line 25)
* GNU C compiler bugs: TeX or Metafont failing.
@@ -4145,9 +4176,9 @@ Index
* group-writable directories: Security. (line 40)
* GSFTOPK_DEBUG (128): Debugging. (line 88)
* hash table buckets, printing: Debugging. (line 105)
-* hash table routines: Calling sequence. (line 86)
+* hash table routines: Calling sequence. (line 87)
* hash_summary_only variable for debugging: Debugging. (line 105)
-* help, mailing list for general TeX: Mailing lists. (line 29)
+* help, mailing list for general TeX: Mailing lists. (line 25)
* HIER: Default path features.
(line 41)
* history of Kpathsea: History. (line 6)
@@ -4160,9 +4191,9 @@ Index
(line 6)
* include fontmap directive: Fontmap. (line 33)
* INDEXSTYLE: Supported file formats.
- (line 67)
-* info-tex@shsu.edu: Mailing lists. (line 29)
-* input lines, reading: Calling sequence. (line 86)
+ (line 74)
+* info-tex@shsu.edu: Mailing lists. (line 25)
+* input lines, reading: Calling sequence. (line 87)
* install-data Make target: Installing files. (line 28)
* install-exec Make target: Installing files. (line 23)
* installation: Installation. (line 6)
@@ -4178,7 +4209,7 @@ Index
* installation, simple: Simple installation. (line 6)
* installing files: Installing files. (line 6)
* interactive query: Path searching options.
- (line 106)
+ (line 110)
* interface, not frozen: Introduction. (line 27)
* introduction: Introduction. (line 6)
* kdebug:: Debugging. (line 105)
@@ -4189,23 +4220,37 @@ Index
* Knuth, Donald E., original author: Electronic distribution.
(line 25)
* Korn shell, losing with configure: configure shells. (line 14)
+* kpathsae_var_value: Programming with config files.
+ (line 10)
* Kpathsea config file, source for path: Path sources. (line 17)
* Kpathsea version number: Kpathsea application distributions.
(line 6)
* kpathsea.h: Programming overview.
- (line 16)
+ (line 24)
* kpathsea/HIER: Default path features.
(line 41)
* kpathsea/README.CONFIGURE: Running configure. (line 15)
-* KPATHSEA_DEBUG: Calling sequence. (line 22)
-* kpathsea_debug: Debugging. (line 18)
+* kpathsea_cnf_get: Programming with config files.
+ (line 23)
+* KPATHSEA_DEBUG <1>: Calling sequence. (line 28)
* KPATHSEA_DEBUG: Debugging. (line 18)
-* kpathsea_debug: Debugging. (line 6)
-* kpathsea_debug variable: Calling sequence. (line 40)
+* kpathsea_find_file <1>: Calling sequence. (line 62)
+* kpathsea_find_file: File lookup. (line 37)
+* kpathsea_find_glyph: Glyph lookup. (line 26)
+* kpathsea_finish: Calling sequence. (line 82)
+* kpathsea_init_prog <1>: Calling sequence. (line 53)
+* kpathsea_init_prog: Fallback font. (line 15)
+* kpathsea_new: Calling sequence. (line 9)
+* kpathsea_open_file: Calling sequence. (line 74)
+* kpathsea_set_program_name: Calling sequence. (line 14)
* KPATHSEA_WARNING: Config files. (line 18)
+* kpse->debug: Debugging. (line 6)
+* kpse->debug variable: Calling sequence. (line 39)
+* kpse->format_info: Calling sequence. (line 47)
+* kpse->invocation_name: Calling sequence. (line 22)
+* kpse->invocation_short_name: Calling sequence. (line 22)
+* kpse->program_name: Calling sequence. (line 22)
* KPSE_BITMAP_TOLERANCE: Basic glyph lookup. (line 15)
-* kpse_cnf_get: Programming with config files.
- (line 23)
* KPSE_DEBUG_EXPAND (16): Debugging. (line 68)
* KPSE_DEBUG_FOPEN (4): Debugging. (line 53)
* KPSE_DEBUG_HASH (2): Debugging. (line 46)
@@ -4214,22 +4259,9 @@ Index
* KPSE_DEBUG_STAT (1): Debugging. (line 38)
* KPSE_DEBUG_VARS (64): Debugging. (line 83)
* KPSE_DOT expansion: KPSE_DOT expansion. (line 6)
-* kpse_fallback_font: Fallback font. (line 15)
-* kpse_find_*: Calling sequence. (line 63)
-* kpse_find_file <1>: Calling sequence. (line 63)
-* kpse_find_file: File lookup. (line 37)
-* kpse_find_glyph_format: Glyph lookup. (line 26)
-* kpse_format_info: Calling sequence. (line 48)
* kpse_format_info_type: Debugging. (line 61)
-* kpse_init_prog: Calling sequence. (line 54)
* kpse_init_prog, and MAKETEX_MODE: Default path features.
(line 25)
-* kpse_open_file: Calling sequence. (line 77)
-* kpse_program_name: Calling sequence. (line 16)
-* kpse_set_progname: Calling sequence. (line 33)
-* kpse_set_program_name: Calling sequence. (line 9)
-* kpse_var_value: Programming with config files.
- (line 10)
* kpsewhich: Invoking kpsewhich. (line 6)
* Kpsewhich, and debugging: Debugging. (line 31)
* ksh, losing with configure: configure shells. (line 14)
@@ -4237,7 +4269,7 @@ Index
* LaserJet drive: Kpathsea application distributions.
(line 13)
* last-resort font: Fallback font. (line 6)
-* LaTeX help mailing list: Mailing lists. (line 29)
+* LaTeX help mailing list: Mailing lists. (line 25)
* lcircle10: Fontmap. (line 19)
* LDFLAGS: configure environment.
(line 38)
@@ -4255,8 +4287,8 @@ Index
* libucb, avoiding: Running make. (line 44)
* license for using the library: Introduction. (line 31)
* LIGFONTS: Supported file formats.
- (line 71)
-* lines, reading arbitrary-length: Calling sequence. (line 86)
+ (line 78)
+* lines, reading arbitrary-length: Calling sequence. (line 87)
* Linux File System Standard: mktex configuration. (line 114)
* Linux shells and configure: configure shells. (line 19)
* Linux, using Web2c: CD-ROM distribution. (line 16)
@@ -4272,7 +4304,7 @@ Index
* lostchar: Suppressing warnings.
(line 19)
* ls-R: Supported file formats.
- (line 74)
+ (line 81)
* ls-R and AFS: Installing files. (line 40)
* ls-R database file: ls-R. (line 6)
* ls-R, simplest build: ls-R. (line 18)
@@ -4292,7 +4324,7 @@ Index
* MAKETEX_FINE_DEBUG (1024): Debugging. (line 100)
* MAKETEX_MODE: Default path features.
(line 19)
-* memory allocation routines: Calling sequence. (line 86)
+* memory allocation routines: Calling sequence. (line 87)
* metafont driver files: mktex configuration. (line 94)
* Metafont failures: TeX or Metafont failing.
(line 6)
@@ -4305,15 +4337,15 @@ Index
* MFBASES: Supported file formats.
(line 24)
* MFINPUTS: Supported file formats.
- (line 88)
+ (line 95)
* MFPOOL: Supported file formats.
- (line 92)
+ (line 99)
* MFTINPUTS: Supported file formats.
- (line 96)
+ (line 103)
* mirrors, FTP: Electronic distribution.
(line 13)
* MISCFONTS: Supported file formats.
- (line 100)
+ (line 107)
* mismatched checksum warnings: Suppressing warnings.
(line 17)
* missfont.log: mktex script names. (line 35)
@@ -4338,17 +4370,21 @@ Index
(line 12)
* mktextex: mktex script names. (line 27)
* mktextfm: mktex script names. (line 30)
+* MLBIBINPUTS: Supported file formats.
+ (line 111)
+* MLBSTINPUTS: Supported file formats.
+ (line 115)
* mode directory, omitting: mktex configuration. (line 99)
* Morgan, Tim: History. (line 12)
* mostlyclean Make target: Cleaning up. (line 10)
* MPINPUTS: Supported file formats.
- (line 104)
+ (line 119)
* MPMEMS: Supported file formats.
- (line 80)
+ (line 87)
* MPPOOL: Supported file formats.
- (line 108)
+ (line 123)
* MPSUPPORT: Supported file formats.
- (line 84)
+ (line 91)
* MT_FEATURES: mktex configuration. (line 40)
* multiple architectures, compiling on: configure scenarios. (line 18)
* multiple architectures, directories for: configure scenarios.
@@ -4360,7 +4396,7 @@ Index
* NetBSD configure error: Empty Makefiles. (line 6)
* NetBSD shells and configure: configure shells. (line 19)
* Neumann, Gustaf: History. (line 57)
-* newsgroup for TeX: Mailing lists. (line 29)
+* newsgroup for TeX: Mailing lists. (line 25)
* NeXT sed error: Empty Makefiles. (line 6)
* NeXT, lacking X11: Kpathsea application distributions.
(line 6)
@@ -4374,20 +4410,20 @@ Index
* non-Unix operating systems: Custom installation. (line 19)
* none: Suppressing warnings.
(line 23)
-* null pointers, dereferencing: Bug checklist. (line 62)
+* null pointers, dereferencing: Bug checklist. (line 61)
* numeric debugging values: Debugging. (line 34)
* obtaining TeX: unixtex.ftp. (line 6)
* obtaining Web2c by ftp: Electronic distribution.
(line 6)
* obtaining Web2c on CD-ROM: CD-ROM distribution. (line 6)
* OCPINPUTS: Supported file formats.
- (line 112)
+ (line 127)
* OFMFONTS: Supported file formats.
- (line 116)
+ (line 131)
* online Metafont display, spurious: Unable to generate fonts.
(line 36)
* OPENTYPEFONTS: Supported file formats.
- (line 120)
+ (line 135)
* OpenWin libraries, dynamic linking problems: ShellWidgetClass.
(line 6)
* optimization caveat: TeX or Metafont failing.
@@ -4398,14 +4434,14 @@ Index
* OS/2 support: Custom installation. (line 19)
* other TeX distributions: Other TeX packages. (line 6)
* OTPINPUTS: Supported file formats.
- (line 126)
+ (line 141)
* overview of path searching: Searching overview. (line 6)
* overview of programming with Kpathsea: Programming overview.
(line 6)
* OVFFONTS: Supported file formats.
- (line 129)
+ (line 144)
* OVPFONTS: Supported file formats.
- (line 132)
+ (line 147)
* patches, Sun OpenWin: ShellWidgetClass. (line 29)
* path expansion: Path expansion. (line 6)
* path searching: Path searching. (line 6)
@@ -4424,7 +4460,7 @@ Index
(line 27)
* paths.h, creating: Running make. (line 6)
* pathsearch.h: Programming overview.
- (line 16)
+ (line 24)
* pc Pascal compiler: History. (line 12)
* PCL driver: Kpathsea application distributions.
(line 13)
@@ -4435,14 +4471,14 @@ Index
* pdftex.cfg: Specially-recognized files.
(line 34)
* PDFTEXCONFIG: Supported file formats.
- (line 136)
+ (line 151)
* pdftexconfig.tex: Specially-recognized files.
(line 34)
* permission denied: Searching overview. (line 56)
* permissions, directory: Security. (line 51)
* permissions, file: Security. (line 47)
* PKFONTS: Supported file formats.
- (line 139)
+ (line 154)
* plain.base: Unable to generate fonts.
(line 46)
* pointer combination warnings: Pointer combination warnings.
@@ -4461,11 +4497,9 @@ Index
* problems, common: Common problems. (line 6)
* proginit.c: Default path features.
(line 25)
-* proginit.h: Calling sequence. (line 54)
+* proginit.h: Calling sequence. (line 53)
* program-varying paths: Supported file formats.
(line 12)
-* program_invocation_name: Calling sequence. (line 16)
-* program_invocation_short_name: Calling sequence. (line 16)
* programming overview: Programming overview.
(line 6)
* programming with config files: Programming with config files.
@@ -4475,12 +4509,14 @@ Index
* proof mode: Unable to generate fonts.
(line 36)
* PSHEADERS: Supported file formats.
- (line 145)
+ (line 160)
* pxp Pascal preprocessor: History. (line 12)
* quoting variable values: Variable expansion. (line 17)
+* re-entrant API: Programming overview.
+ (line 16)
* readable: Suppressing warnings.
(line 26)
-* reading arbitrary-length lines: Calling sequence. (line 86)
+* reading arbitrary-length lines: Calling sequence. (line 87)
* README.CONFIGURE: Running configure. (line 15)
* README.mirrors: Electronic distribution.
(line 13)
@@ -4488,7 +4524,7 @@ Index
* relative filenames: Searching overview. (line 52)
* relative filenames in ls-R: Installing files. (line 40)
* reporting bugs: Reporting bugs. (line 6)
-* resident.c: Calling sequence. (line 48)
+* resident.c: Calling sequence. (line 47)
* resolution, setting: Path searching options.
(line 17)
* resolutions, last-resort: Fallback font. (line 6)
@@ -4510,13 +4546,13 @@ Index
* searching the disk: Searching overview. (line 22)
* security considerations: Security. (line 6)
* sed error from configure: Empty Makefiles. (line 6)
-* SELFAUTODIR: Calling sequence. (line 25)
-* SELFAUTOLOC: Calling sequence. (line 25)
-* SELFAUTOPARENT: Calling sequence. (line 25)
-* sending patches: Bug checklist. (line 56)
+* SELFAUTODIR: Calling sequence. (line 31)
+* SELFAUTOLOC: Calling sequence. (line 31)
+* SELFAUTOPARENT: Calling sequence. (line 31)
+* sending patches: Bug checklist. (line 55)
* setgid scripts: Security. (line 40)
* SFDFONTS: Supported file formats.
- (line 149)
+ (line 164)
* sh5, ok with configure: configure shells. (line 25)
* shared library, making: Shared library. (line 6)
* shell scripts as configuration files: Config files. (line 72)
@@ -4532,20 +4568,22 @@ Index
* slow startup time: Slow path searching. (line 6)
* Solaris BSD compatibility, not: Running make. (line 44)
* source files: Supported file formats.
- (line 161)
+ (line 176)
* sources for search paths: Path sources. (line 6)
* special: Suppressing warnings.
(line 30)
* st_nlink: Subdirectory expansion.
(line 26)
-* stack trace: Bug checklist. (line 62)
+* ST_NLINK_TRICK: Subdirectory expansion.
+ (line 38)
+* stack trace: Bug checklist. (line 61)
* standalone path searching: Invoking kpsewhich. (line 6)
* standard error and debugging output: Debugging. (line 27)
* standard options: Standard options. (line 6)
* startup time, excessive: Slow path searching. (line 6)
* static linking: ShellWidgetClass. (line 39)
* static linking and dlsym: dlopen. (line 6)
-* string routines: Calling sequence. (line 86)
+* string routines: Calling sequence. (line 87)
* strip: mktex configuration. (line 108)
* stripsupplier: mktex configuration. (line 102)
* striptypeface: mktex configuration. (line 105)
@@ -4565,19 +4603,19 @@ Index
* symbolic links not found: Unable to find files.
(line 21)
* symbolic links, and ls-R: ls-R. (line 38)
-* symlinks, resolving: Calling sequence. (line 25)
+* symlinks, resolving: Calling sequence. (line 31)
* system C compiler bugs: TeX or Metafont failing.
(line 19)
* system dependencies: Running configure. (line 6)
* system V universe: Running make. (line 44)
* T1FONTS: Supported file formats.
- (line 184)
+ (line 199)
* T1INPUTS: Supported file formats.
- (line 184)
+ (line 199)
* T42FONTS: Supported file formats.
- (line 189)
+ (line 204)
* tcfmgr.map: Specially-recognized files.
- (line 44)
+ (line 47)
* TDS: TeX directory structure.
(line 6)
* testing, post-installation: Installation testing.
@@ -4593,20 +4631,19 @@ Index
(line 6)
* TeX file lookup: File lookup. (line 6)
* TeX glyph lookup: Glyph lookup. (line 6)
-* TeX help mailing list: Mailing lists. (line 29)
+* TeX help mailing list: Mailing lists. (line 25)
* TeX hierarchy, one: configure scenarios. (line 13)
* TeX Live CD-ROM: CD-ROM distribution. (line 8)
* TeX support: TeX support. (line 6)
* TeX Users Group: Introduction. (line 39)
-* tex-archive@math.utah.edu: Mailing lists. (line 25)
* tex-file.c: File lookup. (line 37)
* tex-file.h: Programming overview.
- (line 16)
+ (line 24)
* tex-glyph.c: Glyph lookup. (line 26)
* tex-glyph.h: Programming overview.
- (line 16)
-* tex-k-request@mail.tug.org: Mailing lists. (line 7)
-* tex-k@mail.tug.org (bug address): Reporting bugs. (line 8)
+ (line 24)
+* tex-k-request@tug.org: Mailing lists. (line 7)
+* tex-k@tug.org (bug address): Reporting bugs. (line 8)
* TEX_HUSH <1>: Suppressing warnings.
(line 6)
* TEX_HUSH: Searching overview. (line 56)
@@ -4615,18 +4652,18 @@ Index
* TEXCONFIG: Supported file formats.
(line 47)
* TEXDOCS: Supported file formats.
- (line 158)
+ (line 173)
* TEXFONTMAPS: Supported file formats.
- (line 77)
+ (line 84)
* TEXFONTS: Supported file formats.
- (line 58)
+ (line 65)
* texfonts.map: Fontmap. (line 6)
* TEXFORMATS: Supported file formats.
(line 54)
* TEXINDEXSTYLE: Supported file formats.
- (line 67)
+ (line 74)
* TEXINPUTS: Supported file formats.
- (line 62)
+ (line 69)
* TEXMF: TeX directory structure.
(line 6)
* texmf.cnf: Specially-recognized files.
@@ -4648,29 +4685,29 @@ Index
(line 39)
* TEXMFCNF: Config files. (line 6)
* TEXMFDBS <1>: Supported file formats.
- (line 74)
+ (line 81)
* TEXMFDBS: ls-R. (line 6)
* TEXMFINI: Supported file formats.
(line 24)
* TEXMFLOG: Logging. (line 10)
* TEXMFOUTPUT: mktex script names. (line 40)
* TEXMFSCRIPTS: Supported file formats.
- (line 164)
+ (line 179)
* TEXMFVAR: mktex configuration. (line 124)
* texmfvar: mktex configuration. (line 123)
* TEXPICTS: Supported file formats.
- (line 62)
+ (line 69)
* TEXPKS: Supported file formats.
- (line 139)
+ (line 154)
* TEXPOOL: Supported file formats.
- (line 168)
+ (line 183)
* TEXPSHEADERS: Supported file formats.
- (line 145)
+ (line 160)
* TEXSIZES: Fallback font. (line 6)
* TEXSOURCES: Supported file formats.
- (line 161)
+ (line 176)
* TFMFONTS: Supported file formats.
- (line 172)
+ (line 187)
* tilde expansion: Tilde expansion. (line 6)
* tilde.c: Tilde expansion. (line 25)
* time system call: Logging. (line 15)
@@ -4679,15 +4716,14 @@ Index
* trailing / in home directory: Tilde expansion. (line 19)
* trailing colons: Default expansion. (line 6)
* TRFONTS: Supported file formats.
- (line 177)
+ (line 192)
* trick for detecting leaf directories: Subdirectory expansion.
(line 22)
* trojan horse attack: Security. (line 10)
* try_std_extension_first: File lookup. (line 24)
* TTFONTS: Supported file formats.
- (line 181)
+ (line 196)
* tug.org: unixtex.ftp. (line 6)
-* tug@tug.org: Introduction. (line 46)
* typeface directory, omitting: mktex configuration. (line 106)
* ucbinclude, avoiding: Running make. (line 44)
* Ultrix shells and configure: configure shells. (line 25)
@@ -4695,10 +4731,8 @@ Index
(line 6)
* unable to generate fonts: Unable to generate fonts.
(line 6)
-* uname: Bug checklist. (line 21)
+* uname: Bug checklist. (line 20)
* universe, BSD vs. system V: Running make. (line 44)
-* UNIX_ST_LINK: Subdirectory expansion.
- (line 38)
* unixtex.ftp: unixtex.ftp. (line 6)
* unknown special warnings: Suppressing warnings.
(line 31)
@@ -4709,7 +4743,7 @@ Index
* usage patterns, finding: Logging. (line 6)
* USE_TEXMFVAR: mktex configuration. (line 129)
* USE_VARTEXFONTS: mktex configuration. (line 119)
-* Usenet TeX newsgroup: Mailing lists. (line 29)
+* Usenet TeX newsgroup: Mailing lists. (line 25)
* USERPROFILE, as ~ expansion: Tilde expansion. (line 6)
* varfonts: mktex configuration. (line 113)
* variable expansion: Variable expansion. (line 6)
@@ -4720,10 +4754,10 @@ Index
* VAX 11/750: History. (line 12)
* version number, of Kpathsea: Kpathsea application distributions.
(line 6)
-* version numbers, determining: Bug checklist. (line 16)
+* version numbers, determining: Bug checklist. (line 15)
* VF files, not found: Searching overview. (line 31)
* VFFONTS: Supported file formats.
- (line 192)
+ (line 207)
* VMS support: Custom installation. (line 19)
* VMS TeX implementations: Other TeX packages. (line 6)
* Vojta, Paul: History. (line 30)
@@ -4737,10 +4771,10 @@ Index
(line 6)
* wcstombs: dlopen. (line 6)
* WEB2C: Supported file formats.
- (line 200)
+ (line 215)
* Weber, Olaf: History. (line 74)
* WEBINPUTS: Supported file formats.
- (line 196)
+ (line 211)
* whitespace, in fontmap files: Fontmap. (line 28)
* whitespace, not ignored on continuation lines: Config files.
(line 31)
@@ -4755,8 +4789,10 @@ Index
* XCFLAGS: Running make. (line 26)
* XCPPFLAGS: Running make. (line 22)
* XDEFS: Running make. (line 23)
+* XDvi: Specially-recognized files.
+ (line 41)
* XDVIFONTS: Supported file formats.
- (line 227)
+ (line 242)
* XDVIMAKEPK: mktex script names. (line 32)
* XDVISIZES: Fallback font. (line 6)
* XLDFLAGS: Running make. (line 29)
@@ -4771,86 +4807,86 @@ Index

Tag Table:
-Node: Top1552
-Node: Introduction2195
-Node: History4171
-Node: Installation8263
-Node: Simple installation9053
-Node: Custom installation12636
-Node: Disk space13810
-Node: Kpathsea application distributions14694
-Node: Changing search paths15809
-Node: Default path features16991
-Node: Default path generation19127
-Node: Running configure20570
-Node: configure shells21621
-Node: configure options22673
-Node: configure environment24180
-Node: configure scenarios25982
-Node: Shared library27568
-Node: Running make28582
-Node: Installing files30629
-Node: Cleaning up32576
-Node: Filename database generation33624
-Node: mktex scripts34191
-Node: mktex configuration35468
-Node: mktex script names41287
-Node: mktex script arguments42678
-Node: Installation testing43568
-Node: Security43932
-Node: TeX directory structure46499
-Node: unixtex.ftp50921
-Node: Electronic distribution52936
-Node: CD-ROM distribution55701
-Node: Other TeX packages56671
-Node: Reporting bugs57967
-Node: Bug checklist58707
-Node: Mailing lists62409
-Node: Debugging63768
-Node: Logging68840
-Node: Common problems70710
-Node: Unable to find files71541
-Node: Slow path searching73952
-Node: Unable to generate fonts75329
-Node: TeX or Metafont failing77838
-Node: Empty Makefiles79716
-Node: XtStrings80946
-Node: dlopen81782
-Node: ShellWidgetClass82600
-Node: Pointer combination warnings84232
-Node: Path searching84621
-Node: Searching overview85268
-Node: Path sources88664
-Node: Config files89735
-Node: Path expansion93380
-Node: Default expansion94329
-Node: Variable expansion96399
-Node: Tilde expansion97802
-Node: Brace expansion98782
-Node: KPSE_DOT expansion99887
-Node: Subdirectory expansion100400
-Node: Filename database102749
-Node: ls-R103803
-Node: Filename aliases106697
-Node: Database format107875
-Node: Invoking kpsewhich108888
-Node: Path searching options109833
-Node: Specially-recognized files116853
-Node: Auxiliary tasks118177
-Node: Standard options120002
-Node: TeX support120322
-Node: Supported file formats121613
-Node: File lookup128761
-Node: Glyph lookup130489
-Node: Basic glyph lookup131616
-Node: Fontmap132495
-Node: Fallback font135112
-Node: Suppressing warnings136077
-Node: Programming137182
-Node: Programming overview137695
-Node: Calling sequence139971
-Node: Program-specific files144963
-Node: Programming with config files146001
-Node: Index147301
+Node: Top1549
+Node: Introduction2192
+Node: History4014
+Node: Installation8106
+Node: Simple installation8896
+Node: Custom installation12479
+Node: Disk space13653
+Node: Kpathsea application distributions14537
+Node: Changing search paths15652
+Node: Default path features16834
+Node: Default path generation18970
+Node: Running configure20413
+Node: configure shells21464
+Node: configure options22516
+Node: configure environment24023
+Node: configure scenarios25825
+Node: Shared library27411
+Node: Running make28425
+Node: Installing files30472
+Node: Cleaning up32419
+Node: Filename database generation33467
+Node: mktex scripts34034
+Node: mktex configuration35311
+Node: mktex script names41130
+Node: mktex script arguments42521
+Node: Installation testing43411
+Node: Security43775
+Node: TeX directory structure46342
+Node: unixtex.ftp50764
+Node: Electronic distribution52774
+Node: CD-ROM distribution55539
+Node: Other TeX packages56354
+Node: Reporting bugs57650
+Node: Bug checklist58385
+Node: Mailing lists62082
+Node: Debugging63291
+Node: Logging68369
+Node: Common problems70239
+Node: Unable to find files71070
+Node: Slow path searching73481
+Node: Unable to generate fonts74858
+Node: TeX or Metafont failing77367
+Node: Empty Makefiles79245
+Node: XtStrings80475
+Node: dlopen81311
+Node: ShellWidgetClass82129
+Node: Pointer combination warnings83761
+Node: Path searching84150
+Node: Searching overview84797
+Node: Path sources88193
+Node: Config files89264
+Node: Path expansion92909
+Node: Default expansion93858
+Node: Variable expansion95928
+Node: Tilde expansion97331
+Node: Brace expansion98311
+Node: KPSE_DOT expansion99416
+Node: Subdirectory expansion99929
+Node: Filename database102280
+Node: ls-R103334
+Node: Filename aliases106228
+Node: Database format107406
+Node: Invoking kpsewhich108419
+Node: Path searching options109364
+Node: Specially-recognized files116639
+Node: Auxiliary tasks117995
+Node: Standard options119820
+Node: TeX support120140
+Node: Supported file formats121431
+Node: File lookup128947
+Node: Glyph lookup130679
+Node: Basic glyph lookup131803
+Node: Fontmap132682
+Node: Fallback font135299
+Node: Suppressing warnings136212
+Node: Programming137317
+Node: Programming overview137830
+Node: Calling sequence140524
+Node: Program-specific files145492
+Node: Programming with config files146534
+Node: Index147846

End Tag Table
diff --git a/Master/texmf/doc/info/web2c.info b/Master/texmf/doc/info/web2c.info
index c10f40efd81..708cb6e1ad1 100644
--- a/Master/texmf/doc/info/web2c.info
+++ b/Master/texmf/doc/info/web2c.info
@@ -1,4 +1,5 @@
-This is web2c.info, produced by makeinfo version 4.12 from web2c.texi.
+This is ../../../../texk/web2c/doc/web2c.info, produced by makeinfo
+version 4.13 from ../../../../texk/web2c/doc/web2c.texi.
INFO-DIR-SECTION TeX
START-INFO-DIR-ENTRY
@@ -7,20 +8,16 @@ END-INFO-DIR-ENTRY
INFO-DIR-SECTION Individual utilities
START-INFO-DIR-ENTRY
* bibtex: (web2c)bibtex invocation. Maintaining bibliographies.
-* dmp: (web2c)dmp invocation. Troff->MPX (MetaPost pictures).
* dvicopy: (web2c)dvicopy invocation. Virtual font expansion
* dvitomp: (web2c)dvitomp invocation. DVI to MPX (MetaPost pictures).
* dvitype: (web2c)dvitype invocation. DVI to human-readable text.
* gftodvi: (web2c)gftodvi invocation. Generic font proofsheets.
* gftopk: (web2c)gftopk invocation. Generic to packed fonts.
* gftype: (web2c)gftype invocation. GF to human-readable text.
-* makempx: (web2c)makempx invocation. MetaPost label typesetting.
* mf: (web2c)mf invocation. Creating typeface families.
* mft: (web2c)mft invocation. Prettyprinting Metafont source.
* mltex: (web2c)MLTeX. Multi-lingual TeX.
* mpost: (web2c)mpost invocation. Creating technical diagrams.
-* mpto: (web2c)mpto invocation. MetaPost label extraction.
-* newer: (web2c)newer invocation. Compare modification times.
* patgen: (web2c)patgen invocation. Creating hyphenation patterns.
* pktogf: (web2c)pktogf invocation. Packed to generic fonts.
* pktype: (web2c)pktype invocation. PK to human-readable text.
@@ -38,7 +35,7 @@ END-INFO-DIR-ENTRY
Web2c, an implementation of Donald Knuth's TeX system.
Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
-2005, 2007 Karl Berry & Olaf Weber.
+2005, 2007, 2008, 2009 Karl Berry & Olaf Weber.
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@@ -62,7 +59,7 @@ Web2c
This document describes how to install and use the programs in the Web2c
implementation of the TeX system, especially for Unix systems. It
-corresponds to Web2c version 7.5.7, released in July 2008.
+corresponds to Web2c version 2009, released in July 2009.
* Menu:
@@ -86,8 +83,7 @@ File: web2c.info, Node: Introduction, Next: Installation, Prev: Top, Up: Top
1 Introduction
**************
-This manual corresponds to version 7.5.7 of Web2c, released in
-July 2008.
+This manual corresponds to version 2009 of Web2c, released in July 2009.
"Web2c" is the name of a TeX implementation, originally for Unix,
but now also running under DOS, Amiga, and other operating systems. By
@@ -132,7 +128,7 @@ other people have contributed; their names are listed in the
`ChangeLog' files.
Other acknowledgements: The University of Massachusetts at Boston
-(particularly Rick Martin and Bob Morris) has provided computers and ftp
+(particularly Rick Martin and Bob Morris) provided computers and ftp
access to me for many years. Richard Stallman at the Free Software
Foundation employed me while I wrote the original path searching library
(for the GNU font utilities). (rms also gave us Emacs, GDB, and GCC,
@@ -934,6 +930,7 @@ are available.
* Initial TeX:: Making format files.
* Formats:: Major TeX macro packages.
* Languages and hyphenation:: TeX supports many human languages.
+* Shell escapes:: DVI output to a socket.
* IPC and TeX:: DVI output to a socket.
* TeX extensions:: Changes to the TeX language.
@@ -1048,8 +1045,9 @@ suffice.)
`-mktex=FILETYPE'
`-no-mktex=FILETYPE'
- Turn on or off the `mktex' script associated with FILETYPE. The
- only values that make sense for FILETYPE are `tex' and `tfm'.
+ Turn on or off the `mktex' script associated with FILETYPE. For
+ TeX proper, FILETYPE can only be `tex' and `tfm', but for pdfTeX
+ and luaTeX, it can also be `pk'.
`-mltex'
If we are `INITEX' (*note Initial and virgin::), enable MLTeX
@@ -1065,21 +1063,16 @@ suffice.)
`-shell-escape'
`-no-shell-escape'
- Enable (or disable) the `\write18{SHELL-COMMAND}' feature. This
- is also enabled if the environment variable or config file value
- `shell_escape' is set to `t' (but the `-no-shell-escape' command
- line option overrides this). (For backwards compatibility, `y'
- and `1' are accepted as synonyms of `t'). It is disabled by
- default to avoid security problems. When enabled, the
- SHELL-COMMAND string (which first undergoes the usual TeX
- expansions, just as in `\special') is passed to the command shell
- (via the C library function `system'). The output of
- SHELL-COMMAND is not diverted anywhere, so it will not appear in
- the log file. The system call either happens at `\output' time or
- right away, according to the absence or presence of the
- `\immediate' prefix, as usual for `\write'. (If you as a TeX
- administrator wish to implement more stringent rules on what can
- be executed, you will need to modify `tex.ch'.)
+`-shell-restricted'
+ Enable, or disable, or enable with restrictions the
+ `\write18{SHELL-COMMAND}' feature for external executing shell
+ commands. *Note Shell escapes::.
+
+`-enable-write18'
+`-disable-write18'
+ Synonyms for `-shell-escape' and `-no-shell-escape', for
+ compatibility with MiKTeX. (MiKTeX also accepts both pairs of
+ options.) *Note Shell escapes::.
`-src-specials'
`-src-specials=STRING'
@@ -1214,7 +1207,7 @@ slitex

-File: web2c.info, Node: Languages and hyphenation, Next: IPC and TeX, Prev: Formats, Up: TeX
+File: web2c.info, Node: Languages and hyphenation, Next: Shell escapes, Prev: Formats, Up: TeX
4.4 Languages and hyphenation
=============================
@@ -1472,13 +1465,89 @@ Frank Liang (*note References::), and also the `patgen.web' source file.
The only options are `-help' and `-version' (*note Common options::).

-File: web2c.info, Node: IPC and TeX, Next: TeX extensions, Prev: Languages and hyphenation, Up: TeX
+File: web2c.info, Node: Shell escapes, Next: IPC and TeX, Prev: Languages and hyphenation, Up: TeX
+
+4.5 Shell escapes
+=================
+
+TeX can execute "shell escapes", that is, arbitrary shell commands.
+Although tremendously useful, this also has obvious security
+implications. Therefore, as of TeX Live 2009, a "restricted" mode for
+shell escapes is the default mode of operation, which allows executing
+only certain commands, as specified in the `texmf.cnf' configuration
+file.
-4.5 IPC and TeX
+ * Unrestricted shell escapes are allowed if the option
+ `--shell-escape' is specified, or if the environment variable or
+ config file value `shell_escape' is set to `t' or `y' and `1'.
+
+ * Restricted shell escapes are allowed if `shell_escape' is set to
+ `p'. This is the default.
+
+ * Shell escapes are completely disabled if `--no-shell-escape' is
+ specified, or if `shell_escape' is set to anything else.
+
+ When enabled, the TeX construct to execute a system command is
+`\write18{SHELL-COMMAND}'; for example:
+
+ \write18{echo "hello, world"}
+
+ From TeX's point of view, this is a normal `\write' command, and is
+therefore subject to the usual TeX expansions. Also, the system call
+either happens during the `\output' routine or right away, according to
+the absence or presence of the `\immediate' prefix, as usual for
+`\write'.
+
+ The SHELL-COMMAND string is passed to the command shell (via the C
+library function `system'). The output of SHELL-COMMAND is not
+diverted anywhere, so it will not appear in the log file, or anywhere
+but the terminal output. The exit status of the system call is also
+not available to TeX.
+
+ In unrestricted mode, the argument is simply passed straight to
+`system' unaltered.
+
+ In restricted mode, ASCII double quote characters (") should always
+be used in the argument to `\write18' where quoting of arguments is
+needed, as in the example above. This is to achieve some measure of
+system independence. On Unix systems, these are replaced with single
+quote (') characters to avoid insecure further expansion. Care is also
+taken on Windows to avoid additional expansions (from, e.g., `...`).
+Mismatched quotation marks in the command string result in a diagnostic
+message in the log file; no execution is performed.
+
+ After quotation processing, if the first word (delimited by a space
+or tab) of the command is in the list specified by the
+`shell_escape_commands' configuration value, the command is executed.
+Otherwise it is not. In any case, a message is written to the log file.
+
+ The `shell_escape_commands' value is a comma-separated list of
+words. Whitespace is significant, and typically should not be present.
+The default definition looks like this, but with more commands included:
+
+ shell_escape_commands = bibtex,dvips,epstopdf,...,tex
+
+ pdfTeX and luaTeX support reading (via `\input' and `\openin') and
+writing (via `\openout') from pipes if the first character is `|'. The
+following command is then treated exactly the same as the argument to
+`\write18'. In these engines, the primitive variable `\pdfshellescape'
+is set to 0 if shell escapes are disabled, 1 if they are enabled, and 2
+if they are enabled with restrictions.
+
+ The purpose of this feature is to make it possible for TeX documents
+to perform useful external actions in the common case of an individual
+user running a known document on his or her own machine. In such
+environments as CGI scripts or wikis where the input has to be
+considered untrustworthy, shell escapes should be completely disabled.
+
+
+File: web2c.info, Node: IPC and TeX, Next: TeX extensions, Prev: Shell escapes, Up: TeX
+
+4.6 IPC and TeX
===============
-(Sorry, but I'm not going to write this unless someone actually uses
-this feature. Let me know.)
+(If anyone uses this feature and needs documentation, write
+<tex-k@tug.org>.)
This functionality is available only if the `--enable-ipc' option
was specified to `configure' during installation of Web2c (*note
@@ -1491,38 +1560,34 @@ its socket operations. This may be helpful if you are, well, debugging.

File: web2c.info, Node: TeX extensions, Prev: IPC and TeX, Up: TeX
-4.6 TeX extensions
+4.7 TeX extensions
==================
The base TeX program has been extended in many ways. Here's a partial
-list. Please send information on extensions not listed here to the
-address in *note Reporting bugs: (kpathsea)Reporting bugs.
+list.
e-TeX
- Adds many new primitives, including right-to-left typesetting.
- Available from `http://www.vms.rhbnc.ac.uk/e-TeX/' and
- `CTAN:/systems/e-tex'.
+ Adds many new primitives, including right-to-left typesetting and
+ more registers. Now frozen.
Omega
- Adds Unicode support, right-to-left typesetting, and more.
- Available from `http://www.ens.fr/omega' and `CTAN:/systems/omega'.
+Aleph
+ These add Unicode support, right-to-left typesetting, and more.
+ Omega was the original program. Aleph is an updated version with
+ a variety of bug fixes, and includes e-TeX. Neither is actively
+ maintained.
pdfTeX
- A variant of TeX that produces PDF instead of DVI files. It also
- includes primitives for hypertext and micro-typography. Available
- from `CTAN:/systems/pdftex'.
-
-`TeX--XeT'
- Adds primitives and DVI opcodes for right-to-left typesetting (as
- used in Arabic, for example). An old version for TeX 3.1415 is
- available from `CTAN:/systems/knuth/tex--xet'. A newer version is
- included in e-TeX.
-
-File-handling TeX
- Adds primitives for creating multiple DVI files in a single run;
- and appending to output files as well as overwriting. Web2c
- implementation available in the distribution file
- `web2c/contrib/file-handling-tex'.
+ Can produce PDF as well as DVI files. It also incorporates the
+ e-TeX extensions, new primitives for hypertext and
+ micro-typography, reading/writing from pipes, and much more. Home
+ page: `http://pdftex.org'.
+
+luaTeX
+ Based on pdfTeX, this also embeds the Lua programming language
+ (`http://lua.org') and opens up the TeX typesetting engine to
+ control from Lua. Home page: `http://luatex.org'.
+

File: web2c.info, Node: Metafont, Next: MetaPost, Prev: TeX, Up: Top
@@ -1705,7 +1770,7 @@ of memory used is approximately four times the total length of the
If you have a device not included in `modes.mf', please see comments
in that file for how to create the new definition, and please send the
-definition to <tex-fonts@mail.tug.org> to get it included in the next
+definition to <tex-fonts@math.utah.edu> to get it included in the next
release of `modes.mf'.
Usually, when you run Metafont you must supply the name of a mode
@@ -1985,11 +2050,7 @@ supported) and a number of other subsidiary programs, described below.
* mpost invocation:: Invoking MetaPost.
* Initial MetaPost:: Making mems.
-* makempx invocation:: Create MPX files for labels.
* dvitomp invocation:: DVI-to-MPX translation.
-* dmp invocation:: Ditroff-to-MPX translation.
-* mpto invocation:: Extracting labels from MetaPost programs.
-* newer invocation:: Is one file newer than another?

File: web2c.info, Node: mpost invocation, Next: Initial MetaPost, Up: MetaPost
@@ -2043,17 +2104,15 @@ with any other PostScript figures. For example, with this TeX command:
The MetaPost construct
btex ... TEX-INPUT ... etex
- calls MakeMPX to generate a MPX file containing a MetaPost picture
-expression corresponding to TEX-INPUT (*note makempx invocation::).
+ generates a MetaPost picture expression corresponding to TEX-INPUT.
The construct
verbatimtex ... TEX-INPUT ... etex
- simply passes the TEX-INPUT through to MakeMPX and thus to TeX. For
-example, if you are using LaTeX, your MetaPost input file must start
-with a `verbatimtex' block that gives the necessary `\documentclass'
-(or `\documentstyle') `\begin{document}' command. You will also need
-to set the enviroment variable `TEX' to `latex' (*note makempx
-invocation::).
+ simply passes the TEX-INPUT through to TeX. For example, if you are
+using LaTeX, your MetaPost input file must start with a `verbatimtex'
+block that gives the necessary `\documentclass' (or `\documentstyle')
+`\begin{document}' command. You will also need to set the enviroment
+variable `TEX' to `latex'.
TEX-INPUT need not be specifically TeX input; it could also be
Troff. In that case, you will need the `-m pictures' Troff macro
@@ -2061,9 +2120,6 @@ package (unfortunately absent from many Troff implementations), or an
equivalent such as the `-m pspic' macros from GNU groff described in
grops(1).
- Other typesetters can be supported with no change to MetaPost itself;
-only MakeMPX needs to be updated.
-
Naturally, you must use fonts that are supported by the typesetter;
specifically, you'll probably want to use standard PostScript fonts with
Troff. And only the TeX system understands Computer Modern or other
@@ -2108,8 +2164,7 @@ opens a security hole. *Note tex invocation::.
`-T'
`-troff'
- Set the `prologues' internal variable to `1', and use `makempx
- -troff' to generate MPX files.
+ Set the `prologues' internal variable to `1'.
`-tex=TEXPROGRAM'
When this option is given, the program TEXPROGRAM is used to
@@ -2117,7 +2172,7 @@ opens a security hole. *Note tex invocation::.

-File: web2c.info, Node: Initial MetaPost, Next: makempx invocation, Prev: mpost invocation, Up: MetaPost
+File: web2c.info, Node: Initial MetaPost, Next: dvitomp invocation, Prev: mpost invocation, Up: MetaPost
6.2 Initial MetaPost
====================
@@ -2155,113 +2210,13 @@ page for MetaFun, other MetaPost-related things, and lots more from
Pragma: `http://www.pragma-ade.com/'.

-File: web2c.info, Node: makempx invocation, Next: dvitomp invocation, Prev: Initial MetaPost, Up: MetaPost
-
-6.3 MakeMPX: Support MetaPost labels
-====================================
-
-In MetaPost, labels can be typeset using any document processor; the
-Web2c implementation supports TeX and Troff. MakeMPX translates the
-labels from the typesetting language back into low-level MetaPost
-commands in a so-called "mpx file", so text can be manipulated like
-other graphic objects. It is invoked automatically by MetaPost.
-Synopsis:
-
- makempx [-troff] MPFILE MPXFILE
-
-The input comes from MPFILE (no path searching is done), and the output
-goes to MPXFILE. However, if the file MPXFILE already exists, and is
-newer than MPFILE, then nothing is done (presumably the file is
-up-to-date).
-
- Otherwise:
- 1. MPto is run to extract the label text from the MetaPost source
- file MPFILE (*note mpto invocation::).
-
- 2. The typesetting program itself is run, either TeX or Troff (see
- below). If TeX, and the file named by the `MPTEXPRE' environment
- variable exists (`mptexpre.tex' by default), that file is
- prepended to the input from the MetaPost file.
-
- 3. The typesetter output (a DVI file in the case of TeX, Ditroff
- output for Troff) is translated back to MetaPost, by DVItoMP
- (*note dvitomp invocation::) or DMP (*note dmp invocation::)
- respectively.
-
- If any of the above steps fail, for example if there was a
-typesetting mistake in the original MPFILE, output may be left in files
-named `mpxerr.{log,tex,dvi}' (TeX) or `mpxerr{,.t}' (Troff), so you can
-diagnose the problem.
-
- The `-troff' option to MPto selects the Troff commands, rather than
-TeX. MetaPost supplies this automatically if the `-T' or `-troff'
-option was specified to MetaPost.
-
- The MPX file created by MakeMPX is a sequence of MetaPost picture
-expressions, one for every label in the original MetaPost input file.
-
- The names of the commands run by MakeMPX, and the directory added to
-the shell search `PATH' for the commands' location, are overridden by
-environment variables. Here is a list:
-
-`MAKEMPX_BINDIR'
- The directory added to the `PATH'. Default is the `$(bindir)'
- Make directory, which in turn is set from the configure-time
- `--bindir', `--exec-prefix' and `--prefix' options; if nothing
- else is specified, the default is file `/usr/local'.
-
-`NEWER'
- The command run to determine if MPXFILE is out of date with respect
- to MPFILE; default is `newer'.
-
-`MPTOTEX'
- The command run to extract MetaPost labels in TeX format; default
- is `mpto -tex'.
-
-`MPTOTR'
- Likewise, for Troff; default is `mpto -troff'.
-
-`DVITOMP'
- The command run to convert TeX output back to MetaPost; default is
- `dvitomp'.
-
-`DMP'
- Likewise, for Troff; default is `dmp'.
-
-`TEX'
- The command run to typeset the labels in TeX; the default is
- `etex', set in `texmf.cnf'. If you use LaTeX, set this to
- `latex', and supply an appropriate `verbatimtex' header in the MP
- source (*note mpost invocation::). Or put `%&latex' as the first
- line of your LaTeX source.
-
-`TROFF'
- Likewise, for Troff; default is `'eqn -d\$\$ | troff -Tpost''. You
- may need to replace `-Tpost' by `-TTERM', where TERM is the
- PostScript device name for your Troff implementation, e.g., `ps'
- or `psc'; see troff(1).
-
- If you change this, you will also need to set the `TRFONTS'
- environment variable or configuration value to point to the
- appropriate font directory, traditionally `/usr/lib/font/devTERM'.
-
- One more complication is whether the troff programs have a `g'
- prefix. On Windows, TeX Live supports both ways: `makempx.exe' is
- built to use `gsoelim.exe', `geqn.exe', and `gtroff.exe', while
- `makempx-without-g-prefix.exe' is built to use `soelim.exe',
- `eqn.exe', and `troff.exe'. MetaPost users on Windows using troff
- for their labels should arrange to run the proper binary.
-
-
-
-File: web2c.info, Node: dvitomp invocation, Next: dmp invocation, Prev: makempx invocation, Up: MetaPost
+File: web2c.info, Node: dvitomp invocation, Prev: Initial MetaPost, Up: MetaPost
-6.4 DVItoMP: DVI to MPX conversion
+6.3 DVItoMP: DVI to MPX conversion
==================================
DVItoMP converts DVI files into low-level MetaPost commands in a
-so-called MPX file. This program is generally invoked only by MakeMPX
-(*note makempx invocation::). Synopsis:
+so-called MPX file. Synopsis:
dvitomp DVIFILE[.dvi] [MPXFILE[.mpx]]
@@ -2275,148 +2230,6 @@ NAME' and `color pop', outputting them as `withcolor' MetaPost commands.
The only options are `-help' and `-version' (*note Common options::).

-File: web2c.info, Node: dmp invocation, Next: mpto invocation, Prev: dvitomp invocation, Up: MetaPost
-
-6.5 DMP: Ditroff to MPX conversion
-==================================
-
-DMP converts device-independent Troff (ditroff) output files into
-low-level MetaPost commands in a so-called MPX file. This program is
-generally invoked by MakeMPX (*note makempx invocation::). Synopsis:
-
- dmp [DITROFF-FILE [MPXFILE]]
-
-If DITROFF-FILE is not specified, input comes from standard input; and
-if MPXFILE is not specified, output goes to standard output.
-
- DMP was written to process the output of a Troff pipeline fed the
-output of `mpto -troff' (*note mpto invocation::). DMP understands all
-the `DC' graphics functions that `dpost' does, but it ignores `x X'
-device control functions such as `x X SetColor:...', `x X BeginPath:',
-and `x X DrawPath:...'.
-
- The available font names are defined in the support file
-`trfonts.map', which DMP looks for along the `MPSUPPORT' path.
-
- Another support file `trchars.adj', also looked for along the
-`MPSUPPORT' path, contains a character adjustment table which should
-reflect the shift amounts found in the standard PostScript prologue for
-Troff and dpost found in the `TRFONTS' directory. Such an adjustment
-table is unnecessary for some Troff implementations, in which case
-`trchars.adj' should be replaced by an empty file--but it must still
-exist.
-
- DMP was written for one particular Troff implementation, and it
-unfortunately has many built-in assumptions about the output and fonts
-file formats used by Troff, which may not be satisfied in other
-environments. In particular, GNU groff uses some extensions in its file
-formats described in groff_font(5) and groff_out(5) which make its
-output completely unusable for DMP. On the other hand, the Troff
-version found in Sun Solaris 2.x, and perhaps other systems derived from
-System V R4, works fine with the default settings.
-
- If you run into trouble and want to adapt DMP to other systems, you
-might have to try the following (this is primarily for hackers):
-
- * If DMP complains about a missing font table (e.g., `Cannot find
- TR'), your Troff may not support the device `post'.
-
- Check troff(1) for the devices supported by your Troff and set the
- `TROFF' environment variable appropriately (see above). Also,
- locate the appropriate font directory and set the `TRFONTS'
- variable as needed.
-
- * If DMP complains about a missing font description file (e.g., `Font
- TR was not in map file'), your version of Troff may be using
- internal font names different from those in the distributed
- `trfonts.map'; e.g., TR and TI instead of R and I for Times-Roman
- and Times-Italic.
-
- In this case, you may have to adapt `trfonts.map' and perhaps also
- `trchars.adj' in the MetaPost support directory
- (`texmf/metapost/support' by default).
-
- * If DMP still complains that it cannot parse the font description
- files or the Troff output (e.g., `TR has a bad line in its
- description file', you are probably out of luck and have to hack
- the DMP program (in `web2c/mpware/dmp.c').
-
- Such problems may be caused by subtle differences in the file
- formats, such as use of tabs vs. spaces as field separators or
- decimal vs. octal vs. hex format for font metric data.
-
- A reasonably good description of the expected Troff file formats
- can be found in AT&T technical report CSTR-54 (`Troff User's
- Manual', Revised 1992). Documentation on the subtle differences
- in other Troff implementation is harder to find except for GNU
- groff, where it's all documented in the above-mentioned
- groff_font(5) and groff_out(5).
-
- Any contributions to improve the portability of DMP or to make it
- work with GNU groff are welcome, of course.
-
-
- (Some of the above description was edited from the `dmp.c' source
-file, written by John Hobby.)
-
- The only options are `--help' and `--version' (*note Common
-options::).
-
-
-File: web2c.info, Node: mpto invocation, Next: newer invocation, Prev: dmp invocation, Up: MetaPost
-
-6.6 MPto: Extract labels from MetaPost input
-============================================
-
-MPto extracts the labels from a MetaPost input file; this is the
-contents of any `btex...etex' and `verbatimtex...etex' sections. This
-program is generally invoked by MakeMPX (*note makempx invocation::).
-Synopsis:
-
- mpto [OPTION]... MPFILE
-
-The input comes from MPFILE; no path searching is done. The output
-goes to standard output. Leading and trailing spaces and tabs are
-removed, and various predefined typesetter commands are included at the
-beginning of and end of the file and of each section.
-
- The program accepts the following options, as well as the standard
-`-help' and `-version' (*note Common options::):
-`-troff'
- Surround the MetaPost sections with Troff commands.
-
-`-tex'
- Surround the MetaPost sections with TeX commands. This is the
- default.
-
-
-File: web2c.info, Node: newer invocation, Prev: mpto invocation, Up: MetaPost
-
-6.7 Newer: Compare file modification times
-==========================================
-
-Newer compares file modification times. Synopsis:
-
- newer SRC1 [ SRC2 ... SRCN ] TARGET
-
-Newer exits successfully if the files SRC1 ... SRCN exist and at least
-one of them is not older than DEPENDENT, i.e., the modification time
-(mtime) of at least one of the source files is greater than or the same
-as that of DEPENDENT. Newer also exits successfully if the file
-DEPENDENT doesn't exist. *Note Attribute Meanings: (libc)Attribute
-Meanings.
-
- The program accepts the following option, as well as the standard
-`--help' and `--version' (*note Common options::):
-`--quiet'
- Return result only, do not print any output.
-
-`--verbose'
- List missing source files to STDERR. This is the default.
-
- This is used by MakeMPX (*note makempx invocation::).
-
-
File: web2c.info, Node: BibTeX, Next: WEB, Prev: MetaPost, Up: Top
7 BibTeX: Bibliographies
@@ -2543,9 +2356,8 @@ File: web2c.info, Node: WEB, Next: DVI utilities, Prev: BibTeX, Up: Top
produce both a compilable program and a well-formatted document
describing the program in as much detail as you wish to prepare.
Writing in this kind of dual-purpose language is called "literate
-programming". (The Usenet newsgroup `comp.programming.literate' and
-the mailing list <litprog@shsu.edu> are devoted to this subject; they
-are gatewayed to each other.)
+programming". (The Usenet newsgroup `comp.programming.literate' is
+devoted to this subject.)
WEB-like languages have been implemented with many pairs of base
languages: Cweb provides C and Troff (*note References::); CWEB provides
@@ -3635,7 +3447,7 @@ Appendix B References
21. [Knu89] Donald E. Knuth. The errors of TeX. `Software--Practice
and Experience', 19(7):607-681, July 1989. This is an updated
- version of iteKnuth:1988:ET.
+ version of Knuth:1988:ET.
22. [Knu90] Donald Knuth. Virtual Fonts: More Fun for Grand Wizards.
`TUGboat', 11(1):13-23, April 1990.
@@ -3689,8 +3501,6 @@ Index
(line 6)
* --enable-ipc configure option: tex invocation. (line 101)
* --help common option: Common options. (line 11)
-* --quiet (newer): newer invocation. (line 20)
-* --verbose (newer): newer invocation. (line 23)
* --verbose common option: Common options. (line 15)
* --version common option: Common options. (line 18)
* --with-editor=CMD: Editor invocation. (line 10)
@@ -3727,7 +3537,9 @@ Index
* -charcode-format=TYPE: tftopl invocation. (line 28)
* -D compiler options: Compile-time options.
(line 6)
+* -disable-write18: tex invocation. (line 136)
* -dpi=REAL: dvitype invocation. (line 24)
+* -enable-write18: tex invocation. (line 135)
* -enc: tex invocation. (line 95)
* -file-line-error: Common options. (line 25)
* -file-line-error-style: Common options. (line 26)
@@ -3759,15 +3571,15 @@ Index
* -mixedcase: tangle invocation. (line 35)
* -mktex=FILETYPE <1>: mf invocation. (line 87)
* -mktex=FILETYPE: tex invocation. (line 111)
-* -mltex: tex invocation. (line 115)
+* -mltex: tex invocation. (line 116)
* -mnemonics: gftype invocation. (line 29)
* -no-file-line-error: Common options. (line 26)
* -no-mktex=FILETYPE <1>: mf invocation. (line 87)
* -no-mktex=FILETYPE: tex invocation. (line 111)
* -no-parse-first-line: Common options. (line 78)
-* -no-shell-escape: tex invocation. (line 128)
+* -no-shell-escape: tex invocation. (line 129)
* -oem: Common options. (line 108)
-* -output-comment=STRING: tex invocation. (line 120)
+* -output-comment=STRING: tex invocation. (line 121)
* -output-directory <1>: Output file location.
(line 15)
* -output-directory: Common options. (line 67)
@@ -3780,18 +3592,16 @@ Index
(line 18)
* -progname=STRING: Common options. (line 83)
* -recorder: Common options. (line 90)
-* -shell-escape: tex invocation. (line 127)
+* -shell-escape: tex invocation. (line 128)
+* -shell-restricted: tex invocation. (line 130)
* -show-opcodes: dvitype invocation. (line 56)
* -strict: tangle invocation. (line 46)
* -style=MFTFILE: mft invocation. (line 68)
-* -T: mpost invocation. (line 117)
+* -T: mpost invocation. (line 112)
* -terse: bibtex invocation. (line 28)
-* -tex: mpto invocation. (line 24)
-* -tex=TEXPROGRAM: mpost invocation. (line 121)
+* -tex=TEXPROGRAM: mpost invocation. (line 115)
* -translate-file=TCXFILE: Common options. (line 96)
-* -troff <1>: mpto invocation. (line 21)
-* -troff <2>: makempx invocation. (line 39)
-* -troff: mpost invocation. (line 117)
+* -troff: mpost invocation. (line 112)
* -underline: tangle invocation. (line 41)
* -uppercase: tangle invocation. (line 35)
* -x: weave invocation. (line 22)
@@ -3829,25 +3639,30 @@ Index
* \countN: dvicopy invocation. (line 28)
* \font and dynamic generation: tex invocation. (line 44)
* \fontdimen: tftopl invocation. (line 100)
-* \immediate\write18: tex invocation. (line 128)
+* \immediate\write18: Shell escapes. (line 6)
* \input filenames: \input filenames. (line 6)
+* \input, and pipes: Shell escapes. (line 63)
* \mag <1>: dvitype invocation. (line 28)
* \mag: dvicopy invocation. (line 20)
+* \openin, and pipes: Shell escapes. (line 63)
* \openout and security: tex invocation. (line 51)
+* \openout, and pipes: Shell escapes. (line 63)
+* \output routine, and \write: Shell escapes. (line 28)
+* \pdfshellescape: Shell escapes. (line 63)
* \string: \input filenames. (line 60)
* \tracingcharsubdef and MLTeX: \tracingcharsubdef. (line 6)
* \tracinglostchars and MLTeX: \tracingcharsubdef. (line 11)
-* \write18 shell escape extension: tex invocation. (line 128)
+* \write18 shell escape extension: Shell escapes. (line 6)
* ^^ notation, avoiding: TCX files. (line 88)
* `Computer Modern Typefaces', production of: mft invocation. (line 75)
* abbrv.bst: Basic BibTeX style files.
(line 16)
* accented character: TCX files. (line 6)
* accents, hyphenating words with: MLTeX. (line 6)
-* acknowledgements: Introduction. (line 51)
+* acknowledgements: Introduction. (line 50)
* acm.bst: Basic BibTeX style files.
(line 19)
-* Ada, WEB for: WEB. (line 14)
+* Ada, WEB for: WEB. (line 13)
* additional Make targets: Additional targets. (line 6)
* AFM to TFM conversion: Font utilities available elsewhere.
(line 12)
@@ -3862,7 +3677,6 @@ Index
* AMSTeX: Formats. (line 39)
* apalike.bst: Basic BibTeX style files.
(line 25)
-* Arabic typesetting: TeX extensions. (line 25)
* architecture dependencies: Hardware and memory dumps.
(line 6)
* array limit, fixed: Runtime options. (line 36)
@@ -3871,7 +3685,7 @@ Index
(line 22)
* autotrace: Font utilities available elsewhere.
(line 46)
-* Awk, WEB for: WEB. (line 14)
+* Awk, WEB for: WEB. (line 13)
* base file, determining: Determining the memory dump to use.
(line 6)
* base files: Initial Metafont. (line 6)
@@ -3887,8 +3701,7 @@ Index
* BDF and GF conversion: Font utilities available elsewhere.
(line 15)
* beginfig: mpost invocation. (line 37)
-* BeginPath ditroff command: dmp invocation. (line 15)
-* Berry, Karl: Introduction. (line 41)
+* Berry, Karl: Introduction. (line 40)
* BIBINPUTS, search path for bib files: bibtex invocation. (line 18)
* bibliographies, creating: BibTeX. (line 6)
* bibliography: References. (line 6)
@@ -3902,12 +3715,10 @@ Index
(line 6)
* binaries, linking: Common options. (line 83)
* blank lines, in TCX files: TCX files. (line 67)
-* Bourne shell commands in TeX: tex invocation. (line 128)
* boxes, memory for: Runtime options. (line 20)
* breakpoints, memory for: Runtime options. (line 20)
-* Breitenlohner, Peter: Introduction. (line 9)
+* Breitenlohner, Peter: Introduction. (line 8)
* BSTINPUTS, search path for bst files: bibtex invocation. (line 18)
-* btex and label extraction: mpto invocation. (line 6)
* btex for MetaPost labels: mpost invocation. (line 50)
* btxdoc.bib: bibtex invocation. (line 48)
* btxdoc.tex: bibtex invocation. (line 42)
@@ -3917,8 +3728,6 @@ Index
* byte swapping: Hardware and memory dumps.
(line 13)
* c-sources Makefile target: Additional targets. (line 12)
-* captions, extracting from MetaPost input: mpto invocation. (line 6)
-* captions, for MetaPost: makempx invocation. (line 6)
* change files, and MFT: mft invocation. (line 64)
* change files, and Tangle: tangle invocation. (line 11)
* change files, and Weave: weave invocation. (line 14)
@@ -3941,17 +3750,16 @@ Index
* cmbase.mf: Initial Metafont. (line 28)
* cmbase.mft: mft invocation. (line 75)
* cmmf.base not recommended: Initial Metafont. (line 28)
-* color, in DVItoMP: dvitomp invocation. (line 16)
+* color, in DVItoMP: dvitomp invocation. (line 15)
* comments, in TCX files: TCX files. (line 71)
* comments, MFT control: mft invocation. (line 24)
* common options: Common options. (line 6)
* commonalities: Commonalities. (line 6)
-* comparing file modification times: newer invocation. (line 6)
* compilation: Installation. (line 6)
* compile-time options <1>: Compile-time options.
(line 6)
* compile-time options: configure options. (line 6)
-* Computer Modern fonts, and Troff: mpost invocation. (line 73)
+* Computer Modern fonts, and Troff: mpost invocation. (line 68)
* Computer Modern macros: Initial Metafont. (line 28)
* configuration: Installation. (line 6)
* configuration file reading: Path searching. (line 6)
@@ -3978,10 +3786,9 @@ Index
* cross-references, omitting: weave invocation. (line 22)
* current directory, used for output: Output file location.
(line 6)
-* Curtis, Pavel: Introduction. (line 41)
-* CWEB: WEB. (line 14)
-* Cweb: WEB. (line 14)
-* D C ditroff graphics: dmp invocation. (line 15)
+* Curtis, Pavel: Introduction. (line 40)
+* CWEB: WEB. (line 13)
+* Cweb: WEB. (line 13)
* date and time, in memory dumps: Hardware and memory dumps.
(line 30)
* debugging DVI utilities: dvitype invocation. (line 56)
@@ -3996,30 +3803,20 @@ Index
* directory structure: Installation. (line 34)
* DISPLAY: Online Metafont graphics.
(line 73)
-* ditroff output, converting to MPX: dmp invocation. (line 6)
-* DMP <1>: dmp invocation. (line 6)
-* DMP: makempx invocation. (line 71)
-* DMP, invoked by MakeMPX: makempx invocation. (line 29)
-* dmp.c: dmp invocation. (line 82)
* dot files, written by TeX programs: tex invocation. (line 51)
-* downloading of fonts for MetaPost labels: mpost invocation. (line 78)
-* dpost: dmp invocation. (line 15)
+* downloading of fonts for MetaPost labels: mpost invocation. (line 73)
* DrawingServant: Online Metafont graphics.
(line 35)
-* DrawPath ditroff command: dmp invocation. (line 15)
* dump file: Common options. (line 34)
* dumping memory: Memory dumps. (line 6)
-* DVI comment, specifying: tex invocation. (line 120)
+* DVI comment, specifying: tex invocation. (line 121)
* DVI files, converting to MPX: dvitomp invocation. (line 6)
-* DVI files, creating multiple: TeX extensions. (line 31)
* DVI files, explained: Font file formats. (line 30)
* DVI format definition: DVI utilities. (line 14)
* DVI opcodes, showing: dvitype invocation. (line 56)
* DVI utilities: DVI utilities. (line 6)
* dvicopy: dvicopy invocation. (line 6)
* dvitomp: dvitomp invocation. (line 6)
-* DVITOMP: makempx invocation. (line 67)
-* DVItoMP, invoked by MakeMPX: makempx invocation. (line 29)
* dvitype DVI validation: dvitype invocation. (line 6)
* dvitype output example: dvitype output example.
(line 6)
@@ -4032,7 +3829,7 @@ Index
* dynamic packing variable: pktype invocation. (line 44)
* e response at error prompt: Editor invocation. (line 6)
* e-circumflex: \charsubdef. (line 21)
-* e-TeX: TeX extensions. (line 11)
+* e-TeX: TeX extensions. (line 10)
* e.mft: mft invocation. (line 75)
* EC fonts <1>: mf invocation. (line 24)
* EC fonts: tex invocation. (line 44)
@@ -4051,9 +3848,9 @@ Index
* escapement, horizontal <1>: gftype invocation. (line 107)
* escapement, horizontal: pktype invocation. (line 57)
* escapement, vertical: gftype invocation. (line 107)
-* etex and label extraction: mpto invocation. (line 6)
* etex for MetaPost labels: mpost invocation. (line 50)
* executables, shared initial and virgin: Initial and virgin. (line 6)
+* exit status, of shell escape: Shell escapes. (line 34)
* expanded plain format: Formats. (line 54)
* extensions to TeX: TeX extensions. (line 6)
* extra_mem_bot: Runtime options. (line 19)
@@ -4061,9 +3858,7 @@ Index
* FAMILY property: tftopl invocation. (line 96)
* Ferguson, Michael: MLTeX. (line 6)
* file formats for fonts: Font file formats. (line 6)
-* file mtimes, comparing: newer invocation. (line 6)
* file recorder: Common options. (line 90)
-* File-handling TeX: TeX extensions. (line 31)
* filename conventions, in input files: \input filenames. (line 6)
* filenames starting with -: Option conventions. (line 19)
* first line of the main input file: Common options. (line 96)
@@ -4085,7 +3880,7 @@ Index
* font aliases: Path searching. (line 15)
* font character code, translating: TCX files. (line 102)
* font design: Metafont. (line 6)
-* font downloading for MetaPost labels: mpost invocation. (line 78)
+* font downloading for MetaPost labels: mpost invocation. (line 73)
* font file formats: Font file formats. (line 6)
* font proofs: gftodvi invocation. (line 6)
* font utilities: Font utilities. (line 6)
@@ -4105,9 +3900,9 @@ Index
* fraction routines: Compile-time options.
(line 22)
* Free Software Foundation documentation system: Formats. (line 47)
-* freedom of Web2c: Introduction. (line 23)
+* freedom of Web2c: Introduction. (line 22)
* ftp.math.utah.edu: bibtex invocation. (line 54)
-* generating source specials: tex invocation. (line 146)
+* generating source specials: tex invocation. (line 142)
* geometric designs: Metafont. (line 6)
* geometric font scaling: Font file formats. (line 22)
* geometry for Metafont: Online Metafont graphics.
@@ -4142,13 +3937,12 @@ Index
* headerbyte information: tftopl invocation. (line 96)
* height, in pixels: pktype invocation. (line 62)
* help, online: Common options. (line 11)
-* Henry, Patrick: Introduction. (line 23)
+* Henry, Patrick: Introduction. (line 22)
* Herberts, Mathias: Online Metafont graphics.
(line 20)
* hex character codes, in TCX files: TCX files. (line 78)
-* history: Introduction. (line 41)
-* Hobby, John <1>: dmp invocation. (line 82)
-* Hobby, John: Introduction. (line 9)
+* history: Introduction. (line 40)
+* Hobby, John: Introduction. (line 8)
* horizontal escapement <1>: gftype invocation. (line 107)
* horizontal escapement: pktype invocation. (line 57)
* hp2627: Online Metafont graphics.
@@ -4160,10 +3954,11 @@ Index
* human-readable text, converting PK to: pktype invocation. (line 6)
* human-readable text, converting TFM to: tftopl invocation. (line 6)
* human-readable text, converting VF to: vftovp invocation. (line 6)
+* hypertext: TeX extensions. (line 21)
* hyphenation and languages: Languages and hyphenation.
(line 6)
* hyphenation patterns, creating: patgen invocation. (line 6)
-* ice cream: Introduction. (line 23)
+* ice cream: Introduction. (line 22)
* identifier case: tangle invocation. (line 35)
* identifier collisions: tangle invocation. (line 46)
* identifier length: tangle invocation. (line 27)
@@ -4197,13 +3992,11 @@ Index
* kerning table, in TFM files: tftopl invocation. (line 102)
* keyboard character code, translating: TCX files. (line 102)
* Knuth, Donald E. <1>: mft invocation. (line 58)
-* Knuth, Donald E.: Introduction. (line 9)
+* Knuth, Donald E.: Introduction. (line 8)
* KPATHSEA_DEBUG: Common options. (line 60)
* KRN property: tftopl invocation. (line 102)
* label font: gftodvi invocation. (line 36)
* LABEL property: tftopl invocation. (line 102)
-* labels, extracting from MetaPost input: mpto invocation. (line 6)
-* labels, for MetaPost: makempx invocation. (line 6)
* language support in TeX: Languages and hyphenation.
(line 6)
* languages, hyphenation rules for: patgen invocation. (line 6)
@@ -4213,7 +4006,7 @@ Index
* left side bearing <1>: gftype invocation. (line 82)
* left side bearing: pktype invocation. (line 66)
* legalisms: Legalisms. (line 6)
-* licensing terms: Introduction. (line 23)
+* licensing terms: Introduction. (line 22)
* LIG property: tftopl invocation. (line 102)
* ligature table, in TFM files: tftopl invocation. (line 102)
* LIGTABLE property: tftopl invocation. (line 102)
@@ -4221,10 +4014,11 @@ Index
* links to binaries: Determining the memory dump to use.
(line 32)
* literate programming: WEB. (line 6)
-* litprog@shsu.edu: WEB. (line 6)
* LittleEndian machines: Hardware and memory dumps.
(line 6)
* log file, BibTeX: bibtex invocation. (line 14)
+* Lua: TeX extensions. (line 27)
+* luaTeX: TeX extensions. (line 27)
* machine dependencies: Hardware and memory dumps.
(line 6)
* machine-readable, converting property lists to <1>: vptovf invocation.
@@ -4239,9 +4033,7 @@ Index
* magnification: dvicopy invocation. (line 20)
* main_memory: Runtime options. (line 15)
* Make targets, additional: Additional targets. (line 6)
-* makempx: makempx invocation. (line 6)
-* MAKEMPX_BINDIR: makempx invocation. (line 50)
-* Martin, Rick: Introduction. (line 51)
+* Martin, Rick: Introduction. (line 50)
* Mathematical Reviews: Formats. (line 39)
* mathematical typesetting: TeX. (line 6)
* mem file, determining: Determining the memory dump to use.
@@ -4281,9 +4073,7 @@ Index
* MetaPost and plain Metafont compatibility: Initial MetaPost.
(line 25)
* MetaPost input files: mpost invocation. (line 31)
-* MetaPost input, extracting labels from: mpto invocation. (line 6)
* MetaPost invocation: mpost invocation. (line 6)
-* MetaPost labels: makempx invocation. (line 6)
* MetaPost source, prettyprinting: mft invocation. (line 80)
* MetaPost, initial: Initial MetaPost. (line 6)
* MetaPost, TeX, and Metafont: Three programs. (line 6)
@@ -4300,17 +4090,18 @@ Index
* MFTERM: Online Metafont graphics.
(line 11)
* mftmac.tex: mft invocation. (line 6)
+* micro-typography: TeX extensions. (line 21)
* mktexmf, disabling: mf invocation. (line 24)
* mktextfM, disabling: tex invocation. (line 44)
* mltex: MLTeX. (line 6)
-* MLTeX, enabling: tex invocation. (line 115)
+* MLTeX, enabling: tex invocation. (line 116)
* mode needed to run Metafont: mf invocation. (line 48)
* mode_def: Modes. (line 15)
* mode_setup: Modes. (line 15)
* modes file needed for Metafont: Modes. (line 6)
* modes.mf recommended modes file: Modes. (line 10)
-* Morgan, Tim: Introduction. (line 41)
-* Morris, Bob: Introduction. (line 51)
+* Morgan, Tim: Introduction. (line 40)
+* Morris, Bob: Introduction. (line 50)
* MPEDIT: Editor invocation. (line 10)
* mpgraph.ps: mpost invocation. (line 19)
* mpman.ps: mpost invocation. (line 6)
@@ -4318,31 +4109,15 @@ Index
* mpost, reason for name change: Installation. (line 19)
* mpost.mem: Initial MetaPost. (line 16)
* mpout: mpost invocation. (line 37)
-* mproof.tex: mpost invocation. (line 78)
-* MPSUPPORT: dmp invocation. (line 21)
-* MPto: mpto invocation. (line 6)
-* MPto, invoked by MakeMPX: makempx invocation. (line 21)
-* MPTOTEX: makempx invocation. (line 60)
-* MPTOTR: makempx invocation. (line 64)
+* mproof.tex: mpost invocation. (line 73)
* mptrap Make target: Additional targets. (line 41)
* mptrap test: Triptrap. (line 6)
* mptrap.readme: Triptrap. (line 6)
-* mpx file, defined: makempx invocation. (line 43)
* MPX files, converting from DVI files: dvitomp invocation. (line 6)
-* MPX files, creating from ditroff output: dmp invocation. (line 6)
-* mpxerr: makempx invocation. (line 34)
-* mpxerr.dvi: makempx invocation. (line 34)
-* mpxerr.log: makempx invocation. (line 34)
-* mpxerr.t: makempx invocation. (line 34)
-* mpxerr.tex: makempx invocation. (line 34)
-* mtimes of files, comparing: newer invocation. (line 6)
* Multi-lingual TeX: MLTeX. (line 6)
-* multiple DVI files, creating: TeX extensions. (line 31)
* N tilde: \charsubdef. (line 37)
* new graphics support for Metafont: Online Metafont graphics.
(line 77)
-* NEWER: makempx invocation. (line 56)
-* newer file comparison: newer invocation. (line 6)
* newrow GF command: gftype invocation. (line 93)
* next: Online Metafont graphics.
(line 34)
@@ -4352,8 +4127,7 @@ Index
* NUL, not allowed in filenames: \input filenames. (line 35)
* octal character codes, in TCX files: TCX files. (line 78)
* offset for overflow labels: gftodvi invocation. (line 59)
-* older-than, file comparisons: newer invocation. (line 6)
-* Omega: TeX extensions. (line 16)
+* Omega: TeX extensions. (line 15)
* online Metafont graphics: Online Metafont graphics.
(line 6)
* opcodes, showing DVI: dvitype invocation. (line 56)
@@ -4366,7 +4140,7 @@ Index
* output file location: Output file location.
(line 6)
* output files, written by TeX programs: tex invocation. (line 51)
-* output_comment for DVI files: tex invocation. (line 120)
+* output_comment for DVI files: tex invocation. (line 121)
* overflow label offset: gftodvi invocation. (line 59)
* packet length: pktype invocation. (line 50)
* page, starting <1>: dvitype invocation. (line 50)
@@ -4376,15 +4150,15 @@ Index
* patgen: patgen invocation. (line 6)
* path searching: Path searching. (line 6)
* path searching debugging: Common options. (line 60)
-* PDF: TeX extensions. (line 20)
-* pdfTeX: TeX extensions. (line 20)
+* PDF: TeX extensions. (line 21)
+* pdfTeX: TeX extensions. (line 21)
* permissions, legal: Legalisms. (line 6)
* PFA and PFB conversion: Font utilities available elsewhere.
(line 39)
* pfaedit: Font utilities available elsewhere.
(line 30)
* PiCTeX, increasing memory for: Runtime options. (line 20)
-* picture expressions: makempx invocation. (line 43)
+* pipes, reading and writing: Shell escapes. (line 63)
* pixel height: pktype invocation. (line 62)
* pixel width: pktype invocation. (line 62)
* PK bitmaps from PostScript: Font utilities available elsewhere.
@@ -4417,7 +4191,7 @@ Index
(line 50)
* pooltype: pooltype invocation. (line 6)
* portable filenames: \input filenames. (line 41)
-* PostScript fonts, and Troff: mpost invocation. (line 73)
+* PostScript fonts, and Troff: mpost invocation. (line 68)
* PostScript meets Metafont: MetaPost. (line 6)
* PostScript output: mpost invocation. (line 37)
* PostScript to PK bitmaps: Font utilities available elsewhere.
@@ -4431,17 +4205,16 @@ Index
* predefined macros and memory dumps: Memory dumps. (line 6)
* prettyprinting Metafont source: mft invocation. (line 6)
* prettyprinting WEB programs: weave invocation. (line 6)
-* primitives, new: TeX extensions. (line 11)
+* primitives, new: TeX extensions. (line 10)
* printable characters, specifying: TCX files. (line 88)
* printer characteristics, for Metafont: Modes. (line 6)
* production use: Initial and virgin. (line 20)
* program name, determines memory dump: Determining the memory dump to use.
(line 32)
-* program names, special <1>: tex invocation. (line 115)
+* program names, special <1>: tex invocation. (line 116)
* program names, special: Common options. (line 45)
-* prologues: mpost invocation. (line 117)
-* prologues and Troff in MetaPost: makempx invocation. (line 39)
-* prologues, and EPSF output: mpost invocation. (line 88)
+* prologues: mpost invocation. (line 112)
+* prologues, and EPSF output: mpost invocation. (line 83)
* proof mode: mf invocation. (line 48)
* proof sheets, of fonts: gftodvi invocation. (line 6)
* property list format: tftopl invocation. (line 44)
@@ -4449,12 +4222,12 @@ Index
* property list, converting VF to virtual: vftovp invocation. (line 6)
* ps2pk: Font utilities available elsewhere.
(line 35)
-* psfonts.map, read by MetaPost: mpost invocation. (line 88)
+* psfonts.map, read by MetaPost: mpost invocation. (line 83)
* PXL files, explained: Font file formats. (line 40)
* pxtoch: Font utilities available elsewhere.
(line 23)
* Raichle, Bernd: MLTeX. (line 6)
-* reading, additional: Introduction. (line 59)
+* reading, additional: Introduction. (line 58)
* readonly directory, running TeX in: Output file location.
(line 15)
* reallocation of arrays: Runtime options. (line 36)
@@ -4465,13 +4238,13 @@ Index
(line 39)
* Regis graphics support: Online Metafont graphics.
(line 40)
-* regression testing: tex invocation. (line 120)
+* regression testing: tex invocation. (line 121)
* repeated rows: pktype invocation. (line 76)
* representation of strings: pooltype invocation. (line 30)
+* restricted shell escapes: Shell escapes. (line 6)
* right side bearing <1>: gftype invocation. (line 82)
* right side bearing: pktype invocation. (line 66)
-* right-to-left typesetting: TeX extensions. (line 25)
-* Rokicki, Tomas: Introduction. (line 41)
+* Rokicki, Tomas: Introduction. (line 40)
* run length encoded bitmaps <1>: gftype invocation. (line 89)
* run length encoded bitmaps: pktype invocation. (line 76)
* runtime options: Runtime options. (line 6)
@@ -4482,13 +4255,13 @@ Index
(line 42)
* security, and \openout: tex invocation. (line 51)
* security, and output files: tex invocation. (line 51)
-* security, and shell escapes: tex invocation. (line 128)
-* SetColor ditroff command: dmp invocation. (line 15)
+* security, and shell escapes: Shell escapes. (line 6)
* shapes: Metafont. (line 6)
* sharing memory dumps: Hardware and memory dumps.
(line 6)
-* shell commands in TeX: tex invocation. (line 128)
-* shell_escape enabling in TeX: tex invocation. (line 128)
+* shell commands in TeX: Shell escapes. (line 6)
+* shell_escape enabling in TeX: Shell escapes. (line 6)
+* shell_escape_commands: Shell escapes. (line 52)
* siam.bst: Basic BibTeX style files.
(line 35)
* side bearings <1>: gftype invocation. (line 82)
@@ -4500,14 +4273,14 @@ Index
* smode and dynamic Metafont mode definition: Modes. (line 28)
* sockets: IPC and TeX. (line 6)
* space-terminated filenames: \input filenames. (line 10)
-* Spiderweb: WEB. (line 14)
-* Stallman, Richard: Introduction. (line 51)
+* Spiderweb: WEB. (line 13)
+* Stallman, Richard: Introduction. (line 50)
* starting page <1>: dvitype invocation. (line 50)
* starting page: dvicopy invocation. (line 28)
* Steele Jr., Guy L.: Hardware and memory dumps.
(line 34)
* stopping at the first error: Common options. (line 41)
-* strategy, overall: Introduction. (line 17)
+* strategy, overall: Introduction. (line 16)
* string numbers, displaying: pooltype invocation. (line 6)
* string pool, writing: tangle invocation. (line 16)
* string representation: pooltype invocation. (line 30)
@@ -4526,7 +4299,8 @@ Index
* swapping bytes: Hardware and memory dumps.
(line 13)
* syntax of TCX files: TCX files. (line 66)
-* system C library function: tex invocation. (line 128)
+* system C library function: Shell escapes. (line 6)
+* system command: Shell escapes. (line 6)
* T1 encoding and ISO input: TCX files. (line 49)
* Tachikawa, Elizabeth: Font file formats. (line 63)
* tangle: tangle invocation. (line 6)
@@ -4542,7 +4316,6 @@ Index
(line 11)
* terminator for filenames: \input filenames. (line 10)
* terse output: bibtex invocation. (line 28)
-* TEX: makempx invocation. (line 74)
* tex: tex invocation. (line 6)
* TeX, bibliographies for: bibtex invocation. (line 54)
* TeX, creating from Metafont: mft invocation. (line 6)
@@ -4554,8 +4327,7 @@ Index
* TeX, input files found: tex invocation. (line 20)
* TeX, invocation: tex invocation. (line 6)
* TeX, Metafont, and MetaPost: Three programs. (line 6)
-* TeX, Web2c implementation of: Introduction. (line 9)
-* TeX--XeT: TeX extensions. (line 25)
+* TeX, Web2c implementation of: Introduction. (line 8)
* tex.fmt: Initial TeX. (line 15)
* TEXBIB, search path for bib files: bibtex invocation. (line 18)
* TEXEDIT: Editor invocation. (line 10)
@@ -4568,7 +4340,6 @@ Index
* TEXMFOUTPUT, used if . unwritable: Output file location.
(line 19)
* texput: tex invocation. (line 35)
-* text, extracting from MetaPost input: mpto invocation. (line 6)
* TFM files, converting property lists to: pltotf invocation. (line 6)
* TFM files, explained: Font file formats. (line 13)
* TFM files, memory for: Runtime options. (line 25)
@@ -4585,19 +4356,17 @@ Index
(line 60)
* torture tests: Triptrap. (line 6)
* translation file for TeX, specifying: Common options. (line 96)
-* translation from WEB to C: Introduction. (line 17)
+* translation from WEB to C: Introduction. (line 16)
* trap Make target: Additional targets. (line 41)
* trap test: Triptrap. (line 6)
* trapman.tex: Triptrap. (line 6)
-* trchars.adj: dmp invocation. (line 24)
-* Trickey, Howard: Introduction. (line 41)
+* Trickey, Howard: Introduction. (line 40)
* trip Make target: Additional targets. (line 41)
* trip test: Triptrap. (line 6)
* tripman.tex: Triptrap. (line 6)
* triptrap Make target: Additional targets. (line 41)
-* TROFF: makempx invocation. (line 81)
-* Troff, and MetaPost: mpost invocation. (line 73)
-* Troff, WEB for: WEB. (line 14)
+* Troff, and MetaPost: mpost invocation. (line 68)
+* Troff, WEB for: WEB. (line 13)
* Trojan horses and TeX programs: tex invocation. (line 51)
* TUGboat bibliography: bibtex invocation. (line 54)
* Type 1 conversion: Font utilities available elsewhere.
@@ -4611,7 +4380,7 @@ Index
* typeface specimen sheets: Font utilities available elsewhere.
(line 42)
* typesetting: TeX. (line 6)
-* Unicode: TeX extensions. (line 16)
+* Unicode: TeX extensions. (line 15)
* Unicode input: tex invocation. (line 95)
* uniterm: Online Metafont graphics.
(line 50)
@@ -4624,7 +4393,6 @@ Index
* validation, of PK files: pktype invocation. (line 6)
* validation, of TFM files: tftopl invocation. (line 6)
* validation, of VF files: vftovp invocation. (line 6)
-* verbatimtex MetaPost command: mpto invocation. (line 6)
* verbose BibTeX output, suppressing: bibtex invocation. (line 28)
* verbosity, enabling: Common options. (line 15)
* version number, finding: Common options. (line 18)
@@ -4640,13 +4408,14 @@ Index
* vptovf: vptovf invocation. (line 6)
* weave: weave invocation. (line 6)
* WEB: WEB. (line 6)
+* web environments, and security: Shell escapes. (line 70)
* WEB pool files, displaying: pooltype invocation. (line 6)
* WEB programs, compiling: tangle invocation. (line 6)
* WEB programs, typesetting: weave invocation. (line 6)
* WEB2C, search path for TCX files: TCX files. (line 36)
-* Weber, Olaf: Introduction. (line 41)
+* Weber, Olaf: Introduction. (line 40)
* webmac.tex: weave invocation. (line 22)
-* webman.tex: WEB. (line 14)
+* webman.tex: WEB. (line 13)
* whitespace, in TCX files: TCX files. (line 69)
* whitespace-terminated filenames: \input filenames. (line 10)
* width, device-independent <1>: gftype invocation. (line 113)
@@ -4664,7 +4433,6 @@ Index
(line 66)
* X toolkits and Metafont: Online Metafont graphics.
(line 60)
-* x X ditroff device control: dmp invocation. (line 15)
* xampl.bib: bibtex invocation. (line 51)
* xbfe, bitmap font editor: Font utilities available elsewhere.
(line 23)
@@ -4688,78 +4456,75 @@ Index

Tag Table:
-Node: Top3053
-Node: Introduction4048
-Node: Installation7225
-Node: configure options9389
-Node: Compile-time options11471
-Node: Additional targets12597
-Node: Triptrap13878
-Node: Runtime options15407
-Node: Commonalities17179
-Node: Option conventions17784
-Node: Common options19008
-Node: Path searching23520
-Node: Output file location24542
-Node: Three programs25582
-Node: Initial and virgin26341
-Node: Memory dumps27441
-Node: Creating memory dumps27908
-Node: Determining the memory dump to use29169
-Node: Hardware and memory dumps30793
-Node: Editor invocation33262
-Node: \input filenames33992
-Node: TeX36985
-Node: tex invocation38075
-Node: Initial TeX46007
-Node: Formats47496
-Node: Languages and hyphenation50435
-Node: MLTeX50863
-Node: \charsubdef52358
-Node: \tracingcharsubdef54684
-Node: TCX files55259
-Node: patgen invocation60683
-Node: IPC and TeX61400
-Node: TeX extensions62001
-Node: Metafont63302
-Node: mf invocation64590
-Node: Initial Metafont68473
-Node: Modes70226
-Node: Online Metafont graphics72481
-Node: gftodvi invocation75754
-Node: mft invocation78576
-Node: MetaPost82631
-Node: mpost invocation83652
-Node: Initial MetaPost88837
-Node: makempx invocation90648
-Node: dvitomp invocation94653
-Node: dmp invocation95424
-Node: mpto invocation99445
-Node: newer invocation100427
-Node: BibTeX101364
-Node: bibtex invocation101725
-Node: Basic BibTeX style files104050
-Node: WEB105392
-Node: tangle invocation106675
-Node: weave invocation108798
-Node: pooltype invocation110206
-Node: DVI utilities111336
-Node: dvicopy invocation112280
-Node: dvitype invocation113578
-Node: dvitype output example115933
-Node: Font utilities118984
-Node: Font file formats120164
-Node: gftopk invocation123463
-Node: pktogf invocation124667
-Node: pktype invocation125846
-Node: gftype invocation128681
-Node: tftopl invocation133197
-Node: pltotf invocation137831
-Node: vftovp invocation138896
-Node: vptovf invocation141180
-Node: Font utilities available elsewhere142234
-Node: Legalisms144642
-Node: References146813
-Node: Index151198
+Node: Top2812
+Node: Introduction3806
+Node: Installation6978
+Node: configure options9142
+Node: Compile-time options11224
+Node: Additional targets12350
+Node: Triptrap13631
+Node: Runtime options15160
+Node: Commonalities16932
+Node: Option conventions17537
+Node: Common options18761
+Node: Path searching23273
+Node: Output file location24295
+Node: Three programs25335
+Node: Initial and virgin26094
+Node: Memory dumps27194
+Node: Creating memory dumps27661
+Node: Determining the memory dump to use28922
+Node: Hardware and memory dumps30546
+Node: Editor invocation33015
+Node: \input filenames33745
+Node: TeX36738
+Node: tex invocation37884
+Node: Initial TeX45257
+Node: Formats46746
+Node: Languages and hyphenation49685
+Node: MLTeX50115
+Node: \charsubdef51610
+Node: \tracingcharsubdef53936
+Node: TCX files54511
+Node: patgen invocation59935
+Node: Shell escapes60652
+Node: IPC and TeX64216
+Node: TeX extensions64786
+Node: Metafont65765
+Node: mf invocation67053
+Node: Initial Metafont70936
+Node: Modes72689
+Node: Online Metafont graphics74945
+Node: gftodvi invocation78218
+Node: mft invocation81040
+Node: MetaPost85095
+Node: mpost invocation85857
+Node: Initial MetaPost90765
+Node: dvitomp invocation92576
+Node: BibTeX93241
+Node: bibtex invocation93602
+Node: Basic BibTeX style files95927
+Node: WEB97269
+Node: tangle invocation98477
+Node: weave invocation100600
+Node: pooltype invocation102008
+Node: DVI utilities103138
+Node: dvicopy invocation104082
+Node: dvitype invocation105380
+Node: dvitype output example107735
+Node: Font utilities110786
+Node: Font file formats111966
+Node: gftopk invocation115265
+Node: pktogf invocation116469
+Node: pktype invocation117648
+Node: gftype invocation120483
+Node: tftopl invocation124999
+Node: pltotf invocation129633
+Node: vftovp invocation130698
+Node: vptovf invocation132982
+Node: Font utilities available elsewhere134036
+Node: Legalisms136444
+Node: References138615
+Node: Index142997

End Tag Table