summaryrefslogtreecommitdiff
path: root/Build/source/texk/kpathsea/doc/kpathsea.info
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2010-06-13 18:05:48 +0000
committerKarl Berry <karl@freefriends.org>2010-06-13 18:05:48 +0000
commit43702a7e72ffe67628b405129a6241ce2d971f44 (patch)
tree2ae34931b2683493cabd178a0f12a22a7ee10412 /Build/source/texk/kpathsea/doc/kpathsea.info
parent777df80e1aa24131060f34bcf95fa4676644b945 (diff)
doc updates for 2010
git-svn-id: svn://tug.org/texlive/trunk@18938 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/texk/kpathsea/doc/kpathsea.info')
-rw-r--r--Build/source/texk/kpathsea/doc/kpathsea.info381
1 files changed, 98 insertions, 283 deletions
diff --git a/Build/source/texk/kpathsea/doc/kpathsea.info b/Build/source/texk/kpathsea/doc/kpathsea.info
index c8c68550638..def0252034c 100644
--- a/Build/source/texk/kpathsea/doc/kpathsea.info
+++ b/Build/source/texk/kpathsea/doc/kpathsea.info
@@ -40,7 +40,7 @@ Kpathsea library
This manual documents how to install and use the Kpathsea library for
filename lookup. It corresponds to version 6.0.0, released in
-April 2010.
+July 2010.
* Menu:
@@ -61,7 +61,7 @@ File: kpathsea.info, Node: Introduction, Next: Installation, Prev: Top, Up:
**************
This manual corresponds to version 6.0.0 of the Kpathsea library,
-released in April 2010.
+released in July 2010.
The library's fundamental purpose is to return a filename from a
list of directories specified by the user, similar to what shells do
@@ -1237,166 +1237,27 @@ File: kpathsea.info, Node: unixtex.ftp, Next: Reporting bugs, Prev: TeX direc
2.5 `unixtex.ftp': Obtaining TeX
================================
-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@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,
-Metafont, MetaPost, DVI processors for the X window system, PostScript,
-the PCL language in the HP LaserJet, and related programs. They are
-oriented towards building from the original sources, though some
-information on alternative packages is included in the last section.
-See also `http://www.tug.org/web2c/', the Web2c and Kpathsea home page.
-
- Please note that the Web2c distribution is a bare-bones distribution
-in source form, and building a complete installation from it is a
-non-trivial matter. For most uses, it is a better idea to install a
-distribution with pre-packaged binaries for your platform. The
-principal example of such a distribution is TeX Live
-(`http://www.tug.org/texlive/'), which is based on the Web2c sources.
-
- Please consider joining the TeX Users Group (TUG) or another user
-group of your choice to help support the maintenance and development of
-the programs you retrieve. See `http://www.tug.org/join.html' for
-information and the membership registration form, and
-`http://www.tug.org/usergroups.html' for a listing of all user groups.
-
- For actual installation instructions after obtaining the necessary
-sources, see *note Installation::. A copy is in the distribution file
-`kpathsea/INSTALL'.
+This is `ftp://ftp.tug.org/tex/unixtex.ftp', last updated 13 June 2010.
+Also available as `http://www.tug.org/unixtex.ftp'. Email
+<tex-k@tug.org> with comments or questions.
-* Menu:
-
-* Electronic distribution:: CTAN and so forth.
-* CD-ROM distribution::
-* Other TeX packages::
-
-
-File: kpathsea.info, Node: Electronic distribution, Next: CD-ROM distribution, Up: unixtex.ftp
-
-2.5.1 Electronic distribution
------------------------------
-
-In many places we refer to CTAN:. This is _both_ a host name and a
-directory name. Here are the primary locations:
-
- `ftp://ctan.tug.org/tex-archive/' (Vermont, USA)
- `ftp://ftp.dante.de/tex-archive/' (Germany)
- `ftp://ftp.tex.ac.uk/tex-archive/' (England)
-
-CTAN has many mirrors worldwide; see the top-level file
-`README.mirrors' from one of the sites above or see
-`http://www.tug.org/CTAN.sites'.
-
- You can also access CTAN via the World Wide Web, electronic mail, or
-NFS. The same `README.mirrors' file explains how.
-
- You will need to retrieve some or all of the following archives,
-depending on your needs (don't forget to set binary mode for file
-transfers):
-
-`CTAN:/systems/web2c/web.tar.gz'
- The original WEB source files, written primarily by Don Knuth.
- Required unless you already have this `web' version. (The WEB
- sources change irregularly with respect to Web2c itself.) Unpacks
- into `web2c-VERSION'.
-
-`CTAN:/systems/web2c/web2c.tar.gz'
- The Web2c system. Required. Also unpacks into `web2c-VERSION'.
-
-`CTAN:/systems/web2c/web2c-etex.tar.gz'
- Additions to the Web2c system for building e-TeX. Optional.
- Unpacks into `web2c-VERSION'.
+ The principal free TeX distribution for Unix-like systems is TeX
+Live, `http://tug.org/texlive'. Its web pages describe many ways to
+acquire TeX, over the Internet or on physical media, both the sources
+and precompiled binaries for many systems, either standalone or as part
+of various operating system distributions.
-`CTAN:/systems/web2c/etexlib.tar.gz'
- Additions to the texmf tree needed to build e-TeX. Optional.
- Unpacks into `texmf/'.
-
-`CTAN:/systems/web2c/etexdoc.tar.gz'
- Documentation for e-TeX as an addition to the texmf tree.
- Optional. Unpacks into `texmf/'.
-
-`CTAN:/systems/web2c/web2c-omega.tar.gz'
- Additions to the Web2c system for building Omega. Optional.
- Unpacks into `web2c-VERSION'.
-
-`CTAN:/systems/web2c/omegalib.tar.gz'
- Additions to the texmf tree needed to build Omega. Optional.
- Unpacks into `texmf/'.
-
-`CTAN:/systems/web2c/omegadoc.tar.gz'
- Documentation for Omega as an addition to the texmf tree.
- Optional. Unpacks into `texmf/'.
-
-`CTAN:/systems/web2c/web2c-pdftex.tar.gz'
- Additions to the Web2c system for building pdfTeX. Optional.
- Unpacks into `web2c-VERSION'.
-
-`CTAN:/systems/web2c/pdftexlib.tar.gz'
- Additions to the texmf tree needed to build pdfTeX. Optional.
- Unpacks into `texmf/'.
-
-`CTAN:/dviware/xdvik/xdvik.tar.gz'
- X window system DVI previewer. Unpacks into `xdvik-VERSION'.
- Optional.
-
- Additional drivers, macro files, and other support are needed to
-build a working system. These are available in teTeX.
-
- All that said, the originating host for the software above is
-`ftp.tug.org'. You can retrieve these distributions (but not much
-else) from the `tex/' directory on that host.
-
-
-File: kpathsea.info, Node: CD-ROM distribution, Next: Other TeX packages, Prev: Electronic distribution, Up: unixtex.ftp
-
-2.5.2 CD-ROM distribution
--------------------------
+ Web2C, Kpathsea, Dvips, and Dviljk are no longer released as a
+separate packages. Their sources are now maintained as part of TeX
+Live.
-Numerous organizations distribute various TeX CD-ROM's (and DVD's):
-
- * Virtually all the TeX user groups collaborate to produce the `TeX
- Live' distribution once a year; see `http://www.tug.org/texlive/'
- for more information.
-
- * The Free Software Foundation's `Source Code CD-ROM' contains the
- minimal TeX source distribution described in the previous section
- (i.e., enough to print GNU documentation); email <gnu@gnu.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@tug.org>.
-
-
-File: kpathsea.info, Node: Other TeX packages, Prev: CD-ROM distribution, Up: unixtex.ftp
-
-2.5.3 Other TeX packages
-------------------------
-
-Many other TeX implementations are available in `CTAN:/systems',
-including ready-to-run distributions for Unix, Amiga, Acorn, VMS,
-Macintosh, DOS, and Windows (in various forms). Although Web2c has
-support in the source code for many operating systems, and in fact some
-of the other distributions are based on it, it's unlikely to work as
-distributed on anything but Unix. (Please contribute improvements!)
-
- The principal user-oriented Unix distribution based on Web2c is the
-teTeX distribution. It includes complete sources, and runs on all
-modern Unix variants, including Linux. It contains many TeX-related
-programs besides those in the core Web2c.
-
- The host labrea.stanford.edu is the original source for the files
+ The host ftp.cs.stanford.edu is the original source for the files
for which Donald Knuth is directly responsible: `tex.web', `plain.tex',
etc. However, unless you want to build your TeX library tree ab initio,
-it is more reliable and less work to retrieve these files as part of
-the above packages. In any case, labrea is not the canonical source for
-anything except what was created by Stanford TeX project, so do not
-rely on all the files available at that ftp site being up-to-date.
+it is more reliable and less work to retrieve these files as part of a
+larger package. In any case, that ftp site is not the canonical source
+for anything except what was created as part of Stanford TeX project,
+so do not rely on the other files available there being up-to-date.

File: kpathsea.info, Node: Reporting bugs, Prev: unixtex.ftp, Up: Installation
@@ -3891,7 +3752,6 @@ Index
* absolute filenames: Searching overview. (line 52)
* ac_include, Autoconf extension: Running configure. (line 6)
* access warnings: Searching overview. (line 56)
-* Acorn TeX implementations: Other TeX packages. (line 6)
* AFMFONTS: Supported file formats.
(line 20)
* AFS: Installing files. (line 32)
@@ -3906,7 +3766,6 @@ Index
* alphabetical order, not: Subdirectory expansion.
(line 6)
* Amiga support: Custom installation. (line 19)
-* Amiga TeX implementations: Other TeX packages. (line 6)
* Andrew File System, installing with: Installing files. (line 32)
* announcement mailing list: Mailing lists. (line 6)
* ANSI C: TeX or Metafont failing.
@@ -3930,16 +3789,12 @@ Index
* Babel: Kpathsea application distributions.
(line 28)
* Bach, Johann Sebastian: Default expansion. (line 41)
-* backbone of CTAN: Electronic distribution.
- (line 6)
* backslash-newline: Config files. (line 31)
* bash, recommended for running configure: configure shells. (line 6)
* basic glyph lookup: Basic glyph lookup. (line 6)
* Berry, Karl: History. (line 12)
* BIBINPUTS: Supported file formats.
(line 28)
-* binary mode, for file transfers: Electronic distribution.
- (line 20)
* blank lines, in texmf.cnf: Config files. (line 29)
* brace expansion: Brace expansion. (line 6)
* BSD universe: Running make. (line 44)
@@ -3962,7 +3817,6 @@ Index
(line 6)
* cc, compiling with: configure environment.
(line 11)
-* CD-ROM distributions: CD-ROM distribution. (line 6)
* CFLAGS: configure environment.
(line 14)
* ChangeLog entry: Bug checklist. (line 55)
@@ -4032,10 +3886,6 @@ Index
* CPPFLAGS: configure environment.
(line 22)
* crashes, reporting: Bug checklist. (line 61)
-* CTAN, defined: Electronic distribution.
- (line 6)
-* CTAN.sites: Electronic distribution.
- (line 13)
* custom installation: Custom installation. (line 6)
* CWEBINPUTS: Supported file formats.
(line 43)
@@ -4079,9 +3929,6 @@ Index
(line 6)
* distributions, not compiling: Kpathsea application distributions.
(line 6)
-* distributions, on CD-ROM: CD-ROM distribution. (line 6)
-* distributions, via ftp: Electronic distribution.
- (line 6)
* dlclose: dlopen. (line 6)
* dlopen: dlopen. (line 6)
* dlsym: dlopen. (line 6)
@@ -4090,7 +3937,6 @@ Index
(line 173)
* DOS compatible names: mktex configuration. (line 69)
* DOS support: Custom installation. (line 19)
-* DOS TeX implementations: Other TeX packages. (line 6)
* dosnames: mktex configuration. (line 68)
* dot files: ls-R. (line 33)
* doubled colons: Default expansion. (line 6)
@@ -4113,8 +3959,6 @@ Index
* EC fonts, and dynamic source creation: mktex scripts. (line 6)
* elt-dirs.c: Subdirectory expansion.
(line 41)
-* email CTAN access: Electronic distribution.
- (line 17)
* enabling mktex scripts: mktex configuration. (line 6)
* ENCFONTS: Supported file formats.
(line 51)
@@ -4191,12 +4035,9 @@ Index
(line 224)
* fopen, redefined: Debugging. (line 54)
* format of external database: Database format. (line 6)
-* Free Software Foundation: CD-ROM distribution. (line 12)
* FreeBSD configure error: Empty Makefiles. (line 6)
* FreeBSD shells and configure: configure shells. (line 19)
-* FSF Source Code CD-ROM: CD-ROM distribution. (line 12)
-* ftp retrieval: Electronic distribution.
- (line 6)
+* ftp.cs.stanford.edu: unixtex.ftp. (line 20)
* ftp.tug.org: unixtex.ftp. (line 6)
* fundamental purpose of Kpathsea: Introduction. (line 6)
* gcc, compiling with: configure environment.
@@ -4260,10 +4101,7 @@ Index
* kdebug:: Debugging. (line 105)
* kdefault.c: Default expansion. (line 48)
* Knuth, Donald E.: History. (line 6)
-* Knuth, Donald E., archive of programs by: Other TeX packages.
- (line 18)
-* Knuth, Donald E., original author: Electronic distribution.
- (line 25)
+* Knuth, Donald E., archive of programs by: unixtex.ftp. (line 20)
* Korn shell, losing with configure: configure shells. (line 14)
* kpathsae_var_value: Programming with config files.
(line 10)
@@ -4310,7 +4148,6 @@ Index
* kpsewhich: Invoking kpsewhich. (line 6)
* Kpsewhich, and debugging: Debugging. (line 31)
* ksh, losing with configure: configure shells. (line 14)
-* labrea.stanford.edu: Other TeX packages. (line 18)
* LaserJet drive: Kpathsea application distributions.
(line 13)
* last-resort font: Fallback font. (line 6)
@@ -4336,7 +4173,6 @@ Index
* lines, reading arbitrary-length: Calling sequence. (line 112)
* Linux File System Standard: mktex configuration. (line 114)
* Linux shells and configure: configure shells. (line 19)
-* Linux, using Web2c: CD-ROM distribution. (line 16)
* lndir for building symlink trees: configure scenarios. (line 18)
* loader options: configure environment.
(line 39)
@@ -4354,7 +4190,6 @@ Index
* ls-R database file: ls-R. (line 6)
* ls-R, simplest build: ls-R. (line 18)
* Mach10 configure error: Empty Makefiles. (line 6)
-* Macintosh TeX implementations: Other TeX packages. (line 6)
* MacKenzie, David <1>: Subdirectory expansion.
(line 22)
* MacKenzie, David: History. (line 45)
@@ -4387,8 +4222,6 @@ Index
(line 99)
* MFTINPUTS: Supported file formats.
(line 103)
-* mirrors, FTP: Electronic distribution.
- (line 13)
* MISCFONTS: Supported file formats.
(line 107)
* mismatched checksum warnings: Suppressing warnings.
@@ -4446,8 +4279,6 @@ Index
* NeXT, lacking X11: Kpathsea application distributions.
(line 6)
* NFS and ls-R: ls-R. (line 40)
-* NFS CTAN access: Electronic distribution.
- (line 17)
* nomfdrivers: mktex configuration. (line 93)
* nomode: mktex configuration. (line 98)
* non-English typesetting: Kpathsea application distributions.
@@ -4458,9 +4289,6 @@ Index
* 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 127)
* OFMFONTS: Supported file formats.
@@ -4477,7 +4305,6 @@ Index
* options for debugging: Debugging. (line 6)
* options to configure: configure options. (line 16)
* OS/2 support: Custom installation. (line 19)
-* other TeX distributions: Other TeX packages. (line 6)
* OTPINPUTS: Supported file formats.
(line 141)
* overview of path searching: Searching overview. (line 6)
@@ -4533,7 +4360,6 @@ Index
* PostScript fonts, additional: Simple installation. (line 60)
* precompiled executables, instead of installation: Simple installation.
(line 6)
-* precompiled Unix binaries: Other TeX packages. (line 13)
* preprocessor options: configure environment.
(line 32)
* preprocessor options, additional: Running make. (line 24)
@@ -4563,8 +4389,6 @@ Index
(line 26)
* reading arbitrary-length lines: Calling sequence. (line 112)
* README.CONFIGURE: Running configure. (line 15)
-* README.mirrors: Electronic distribution.
- (line 13)
* recording successful searches: Logging. (line 6)
* relative filenames: Searching overview. (line 52)
* relative filenames in ls-R: Installing files. (line 40)
@@ -4668,12 +4492,10 @@ Index
* testing, post-installation: Installation testing.
(line 6)
* tests, simple: Simple installation. (line 79)
-* teTeX: Other TeX packages. (line 13)
* TeX directory structure <1>: TeX directory structure.
(line 6)
* TeX directory structure: Default path features.
(line 41)
-* TeX distributions besides Web2c: Other TeX packages. (line 6)
* TeX environment variables: Supported file formats.
(line 6)
* TeX failures: TeX or Metafont failing.
@@ -4682,7 +4504,6 @@ Index
* TeX glyph lookup: Glyph lookup. (line 6)
* 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-file.c: File lookup. (line 37)
@@ -4693,6 +4514,7 @@ Index
(line 24)
* tex-k-request@tug.org: Mailing lists. (line 7)
* tex-k@tug.org (bug address): Reporting bugs. (line 8)
+* tex.web: unixtex.ftp. (line 20)
* TEX_HUSH <1>: Suppressing warnings.
(line 6)
* TEX_HUSH: Searching overview. (line 56)
@@ -4808,7 +4630,6 @@ Index
* VFFONTS: Supported file formats.
(line 207)
* VMS support: Custom installation. (line 19)
-* VMS TeX implementations: Other TeX packages. (line 6)
* Vojta, Paul: History. (line 30)
* Walsh, Norman: History. (line 57)
* warning about unusable ls-R: ls-R. (line 45)
@@ -4827,9 +4648,6 @@ Index
* whitespace, in fontmap files: Fontmap. (line 28)
* whitespace, not ignored on continuation lines: Config files.
(line 31)
-* Windows TeX implementations: Other TeX packages. (line 6)
-* World Wide Web CTAN access: Electronic distribution.
- (line 17)
* www.tug.org: unixtex.ftp. (line 6)
* X11 previewer: Kpathsea application distributions.
(line 25)
@@ -4857,85 +4675,82 @@ Index

Tag Table:
Node: Top1615
-Node: Introduction2259
-Node: History4082
-Node: Installation8174
-Node: Simple installation8964
-Node: Custom installation12547
-Node: Disk space13721
-Node: Kpathsea application distributions14605
-Node: Changing search paths15720
-Node: Default path features16902
-Node: Default path generation18985
-Node: Running configure20428
-Node: configure shells21479
-Node: configure options22531
-Node: configure environment24038
-Node: configure scenarios25840
-Node: Shared library27426
-Node: Running make28440
-Node: Installing files30487
-Node: Cleaning up32434
-Node: Filename database generation33482
-Node: mktex scripts34049
-Node: mktex configuration35326
-Node: mktex script names41145
-Node: mktex script arguments42536
-Node: Installation testing43426
-Node: Security43790
-Node: TeX directory structure46357
-Node: unixtex.ftp50779
-Node: Electronic distribution52789
-Node: CD-ROM distribution55554
-Node: Other TeX packages56369
-Node: Reporting bugs57665
-Node: Bug checklist58400
-Node: Mailing lists62097
-Node: Debugging63306
-Node: Logging68384
-Node: Common problems70254
-Node: Unable to find files71085
-Node: Slow path searching73496
-Node: Unable to generate fonts74873
-Node: TeX or Metafont failing77382
-Node: Empty Makefiles79261
-Node: XtStrings80498
-Node: dlopen81334
-Node: ShellWidgetClass82152
-Node: Pointer combination warnings83784
-Node: Path searching84173
-Node: Searching overview84820
-Node: Path sources88216
-Node: Config files89287
-Node: Path expansion92932
-Node: Default expansion93881
-Node: Variable expansion95951
-Node: Tilde expansion97354
-Node: Brace expansion98334
-Node: KPSE_DOT expansion99439
-Node: Subdirectory expansion99952
-Node: Filename database102303
-Node: ls-R103357
-Node: Filename aliases106251
-Node: Database format107429
-Node: Invoking kpsewhich108442
-Node: Path searching options109388
-Node: Specially-recognized files117552
-Node: Auxiliary tasks118908
-Node: Standard options120733
-Node: TeX support121089
-Node: Supported file formats122380
-Node: File lookup129897
-Node: Glyph lookup131646
-Node: Basic glyph lookup132770
-Node: Fontmap133649
-Node: Fallback font136266
-Node: Suppressing warnings137179
-Node: Programming138284
-Node: Programming overview138797
-Node: Calling sequence141491
-Node: Program-specific files148014
-Node: Programming with config files149037
-Node: Index150349
+Node: Introduction2258
+Node: History4080
+Node: Installation8172
+Node: Simple installation8962
+Node: Custom installation12545
+Node: Disk space13719
+Node: Kpathsea application distributions14603
+Node: Changing search paths15718
+Node: Default path features16900
+Node: Default path generation18983
+Node: Running configure20426
+Node: configure shells21477
+Node: configure options22529
+Node: configure environment24036
+Node: configure scenarios25838
+Node: Shared library27424
+Node: Running make28438
+Node: Installing files30485
+Node: Cleaning up32432
+Node: Filename database generation33480
+Node: mktex scripts34047
+Node: mktex configuration35324
+Node: mktex script names41143
+Node: mktex script arguments42534
+Node: Installation testing43424
+Node: Security43788
+Node: TeX directory structure46355
+Node: unixtex.ftp50777
+Node: Reporting bugs52095
+Node: Bug checklist52830
+Node: Mailing lists56527
+Node: Debugging57736
+Node: Logging62814
+Node: Common problems64684
+Node: Unable to find files65515
+Node: Slow path searching67926
+Node: Unable to generate fonts69303
+Node: TeX or Metafont failing71812
+Node: Empty Makefiles73691
+Node: XtStrings74928
+Node: dlopen75764
+Node: ShellWidgetClass76582
+Node: Pointer combination warnings78214
+Node: Path searching78603
+Node: Searching overview79250
+Node: Path sources82646
+Node: Config files83717
+Node: Path expansion87362
+Node: Default expansion88311
+Node: Variable expansion90381
+Node: Tilde expansion91784
+Node: Brace expansion92764
+Node: KPSE_DOT expansion93869
+Node: Subdirectory expansion94382
+Node: Filename database96733
+Node: ls-R97787
+Node: Filename aliases100681
+Node: Database format101859
+Node: Invoking kpsewhich102872
+Node: Path searching options103818
+Node: Specially-recognized files111982
+Node: Auxiliary tasks113338
+Node: Standard options115163
+Node: TeX support115519
+Node: Supported file formats116810
+Node: File lookup124327
+Node: Glyph lookup126076
+Node: Basic glyph lookup127200
+Node: Fontmap128079
+Node: Fallback font130696
+Node: Suppressing warnings131609
+Node: Programming132714
+Node: Programming overview133227
+Node: Calling sequence135921
+Node: Program-specific files142444
+Node: Programming with config files143467
+Node: Index144779

End Tag Table