diff options
author | Karl Berry <karl@freefriends.org> | 2006-01-17 21:41:51 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2006-01-17 21:41:51 +0000 |
commit | 487ca4806cc046076293cf6cc5fbba0db282bac7 (patch) | |
tree | 847b412ab5158dd7bdd7ed7e5a4cc3fbca94be32 /Build/source/texk/web2c/man | |
parent | a3d3111bfe26b8e5f5bc6049dfb2a4ca2edc7881 (diff) |
texk 1
git-svn-id: svn://tug.org/texlive/trunk@1485 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/texk/web2c/man')
45 files changed, 8502 insertions, 0 deletions
diff --git a/Build/source/texk/web2c/man/ChangeLog b/Build/source/texk/web2c/man/ChangeLog new file mode 100644 index 00000000000..90e1fa08ee3 --- /dev/null +++ b/Build/source/texk/web2c/man/ChangeLog @@ -0,0 +1,641 @@ +2005-08-03 Olaf Weber <olaf@infovore.xs4all.nl> + + * etex.man: Document -etex switch. + + * pdfetex.man: Document -etex switch. + +2005-07-27 Olaf Weber <olaf@infovore.xs4all.nl> + + * Makefile.in: Remove references to pdfxtex. + +2005-06-26 Olaf Weber <olaf@infovore.xs4all.nl> + + * Makefile.in: Replace ac_include with kpse_include. From Peter + Breitenlohner. + +2005-06-21 Olaf Weber <olaf@infovore.xs4all.nl> + + * newer.man: Update manual page for new interface of newer. + +2005-01-21 Olaf Weber <olaf@infovore.xs4all.nl> + + * mf.man: Omitted a man page correction. From Eric S. Raymond + <esr@thyrsus.com>. + + * amstex.man, bibtex.man, dmp.man, dvitype.man, eplain.man, + etex.man, gftodvi.man, gftopk.man, gftype.man, makempx.man, + mf.man, mft.man, mpost.man, mpto.man, newer.man, omega.man, + patgen.man, pdfetex.man, pdftex.man, pdfxtex.man, pktogf.man, + pktype.man, pltotf.man, pooltype.man, tangle.man, tex.man, + tftopl.man, vftovp.man, vptovf.man, weave.man: Man page + corrections from Eric S. Raymond <esr@thyrsus.com>. + +2004-12-19 Olaf Weber <olaf@infovore.xs4all.nl> + + * Makefile.in [manfiles]: Add cweb.1. + + * cweb.man: Remove absolute path from FILES section. Remove + references to files that we don't install. Add reference to Web2C + to footer. + + * cweb.man: Manual page for cweb programs, copied from cwebdir so + it can be modified. + +2004-10-03 Olaf Weber <olaf@infovore.xs4all.nl> + + * tex.man: Clarify option handling a bit and reorganize some text. + + * pdfxtex.man: Clarify option handling a bit and reorganize some + text. + + * pdfetex.man: Clarify option handling a bit and reorganize some + text. + + * pdftex.man: Clarify option handling a bit and reorganize some + text. + + * etex.man: Clarify option handling a bit and reorganize some + text. + + * omega.man: Clarify option handling a bit and reorganize some + text. + + * mf.man: Clarify option handling a bit and reorganize some text. + + * mpost.man: Clarify option handling a bit and reorganize some + text. + + * pdfxtex.man: Correct mailing list info. + + * pdfetex.man: Correct mailing list info. + + * pdftex.man: Correct mailing list info. + +2004-09-07 Olaf Weber <olaf@infovore.xs4all.nl> + + * pdfetex.man: .efmt -> .fmt Found by Hartmut Henkel + <hartmut_henkel@gmx.de>. + + * pdfxtex.man: .efmt -> .fmt Found by Hartmut Henkel + <hartmut_henkel@gmx.de>. + + * etex.man: .efmt -> .fmt Found by Hartmut Henkel + <hartmut_henkel@gmx.de>. + +2004-08-27 Peter Breitenlohner <peb@mppmu.mpg.de> + + * etex.man: Fixed a typo. + + * mf.man: Fixed a typo. + + * mpost.man: Fixed a typo. + + * omega.man: Fixed a typo. + + * pdfetex.man: Fixed a typo. + + * pdftex.man: Fixed a typo. + + * pdfxtex.man: Fixed a typo. + + * tex.man: Fixed a typo. + +2004-08-28 Olaf Weber <olaf@infovore.xs4all.nl> + + * pdfxtex.man: Document -output-directory. + + * pdftex.man: Document -output-directory. + + * pdfetex.man: Document -output-directory. + + * tex.man: Document -output-directory. + + * mpost.man: Document -output-directory. + + * mf.man: Document -output-directory. + + * omega.man: Document -output-directory. + + * etex.man: Document -output-directory. + +2004-08-23 Peter Breitenlohner <peb@mppmu.mpg.de> + + * patgen.man: Major rewrite. + + * weave.man: Fixed a typo. + +2004-08-21 Peter Breitenlohner <peb@mppmu.mpg.de> + + * etex.man: Update author. + + * etex.man, pdfetex.man: Change -efmt to -fmt. + + * etex.man, tex.man: Remove references to PDF mode. + +2004-07-21 Olaf Weber <olaf@infovore.xs4all.nl> + + * mpost.man: Misspelt \*(MP macro. From Peter Breitenlohner + <peb@mppmu.mpg.de>. + +2004-07-04 Olaf Weber <olaf@infovore.xs4all.nl> + + * pdfxtex.man: Change -efmt to -fmt. + +2004-06-22 Olaf Weber <olaf@infovore.xs4all.nl> + + * pdfetex.man: Correct title to refer to pdfetex. + + * pdfxtex.man: The pdfxtex manual page is based on the pdfetex + manual page. + +2004-05-08 Olaf Weber <olaf@infovore.xs4all.nl> + + * omega.man: Document -halt-on-error. + + * pdftex.man: Document -halt-on-error. + + * pdfetex.man: Document -halt-on-error. + + * etex.man: Document -halt-on-error. + + * tex.man: Document -halt-on-error. + + * mf.man: Document -halt-on-error. + + * mpost.man: Document -halt-on-error. + +2004-05-04 Olaf Weber <olaf@infovore.xs4all.nl> + + * mf.man: Remove mention of mfw, document mf-nowin instead. + +2004-03-28 Olaf Weber <olaf@infovore.xs4all.nl> + + * tex.man: Document -no-shell-escape, -no-parse-first-line, + -no-file-line-error. + + * etex.man: Document -no-shell-escape, -no-parse-first-line, + -no-file-line-error. + + * pdftex.man: Document -no-shell-escape, -no-parse-first-line, + -no-file-line-error. + + * pdfetex.man: Document -no-shell-escape, -no-parse-first-line, + -no-file-line-error. + + * mf.man: Document -no-parse-first-line, -no-file-line-error. + + * mpost.man: Document -no-parse-first-line, -no-file-line-error. + +2004-03-25 Olaf Weber <olaf@infovore.xs4all.nl> + + * tex.man: Update for new/previously undocumented options. + + * etex.man: Update for new/previously undocumented options. + + * pdftex.man: Update for new/previously undocumented options. + + * pdfetex.man: Update for new/previously undocumented options. + +2004-02-26 Olaf Weber <olaf@infovore.xs4all.nl> + + * Makefile.in [manfiles]: Add pdfxtex.1. + +2003-12-14 Olaf Weber <olaf@infovore.xs4all.nl> + + * latex.man: Misspelt \*(TX macro, found by Eric S. Raymond + <esr@thyrsus.com>. + +2002-12-14 Olaf Weber <olaf@infovore.xs4all.nl> + + * tex.man: Clarify notes of first-line parsing. + +2002-11-30 Olaf Weber <olaf@infovore.xs4all.nl> + + * mpost.man: Replace references to 'mp' with references to + 'mpost'. + +2002-11-11 Olaf Weber <olaf@infovore.xs4all.nl> + + * tex.man: Document -parse-first-line; document TeX vs TeXk. + + * pdftex.man: Document -parse-first-line; document pdfTeX vs + pdfTeXk. + + * pdfetex.man: Document -parse-first-line; document pdfeTeX vs + pdfeTeXk. + + * omega.man: Document -parse-first-line; document Omega vs Omegak. + + * mpost.man: Document -parse-first-line. + + * mf.man: Document -parse-first-line. + + * etex.man: Document -parse-first-line; document e-TeX vs e-TeXk. + +2002-10-23 Olaf Weber <olaf@infovore.xs4all.nl> + + * omega.man: Updated mailing list info (badly of out date now) -- + replaced with a reference to the web site. + +2002-10-22 Olaf Weber <olaf@infovore.xs4all.nl> + + * omega.man: Document oft extension instead of fmt. + +2002-10-20 Olaf Weber <olaf@infovore.xs4all.nl> + + * tex.man: Document -jobname option. + + * pdfetex.man: Document -jobname option. + + * pdftex.man: Document -jobname option. + + * mpost.man: Document -jobname option. + + * mf.man: Document -jobname option. + + * etex.man: Document -jobname option. + + * tangle.man: Document new options. + +2002-07-26 Olaf Weber <olaf@infovore.xs4all.nl> + + * mpost.man: No such thing as .F macro... Found by "Eric + S. Raymond" <esr@golux.thyrsus.com>. + +2001-11-27 Olaf Weber <olaf@infovore.xs4all.nl> + + * mf.man: Mention mfw. + +2001-11-18 Olaf Weber <olaf@infovore.xs4all.nl> + + * tex.man: Document --recorder option. + + * pdftex.man: Document --recorder option. + + * omega.man: Document --recorder option. + + * mpost.man: Document --recorder option. + + * mf.man: Document --recorder option. + + * etex.man: Document --recorder option. + +2001-11-10 Olaf Weber <olaf@infovore.xs4all.nl> + + * tex.man: Document -file-line-error-style. + + * pdftex.man: Document -file-line-error-style. + + * pdfetex.man: Document -file-line-error-style. + + * mpost.man: Document -file-line-error-style. + + * mf.man: Document -file-line-error-style. + + * etex.man: Document -file-line-error-style. + +2001-10-24 Olaf Weber <olaf@infovore.xs4all.nl> + + * tex.man: Typos. + + * pdftex.man: Typo. + + * etex.man: Typo. + + * Makefile.in: Add pdfetex manual page. + +2001-10-14 Olaf Weber <olaf@infovore.xs4all.nl> + + * mf.man: Change /usr/ucb/vi to vi in example, as the path given + is system-dependent. + +2001-09-26 Olaf Weber <olaf@infovore.xs4all.nl> + + * newer.man: Correct description of the exit conditions. After + Oliver Moeller <omoeller@csd.uu.se>. + +2000-04-13 Olaf Weber <olaf@infovore.xs4all.nl> + + * etex.man, omega.man, pdftex.man, tex.man: + Remove references to undump. + +2000-04-03 Olaf Weber <olaf@infovore.xs4all.nl> + + * dvitomp.man: New file by Jim Van Zandt <jrv@vanzandt.mv.com>. + + * Makefile.in: Add dvitomp manual page. + +1999-06-28 Olaf Weber <olaf@infovore.xs4all.nl> + + * omega.man: Mention the empty-path-component trick. + + * tex.man: Mention the empty-path-component trick. + + * pdftex.man: Mention the empty-path-component trick. + + * etex.man: Mention the empty-path-component trick. + +1999-05-29 Olaf Weber <olaf@infovore.xs4all.nl> + + * tex.man, pdftex.man, mpost.man, mf.man, latex.man, etex.man: + Correct date. + +1999-03-23 Olaf Weber <olaf@infovore.xs4all.nl> + + * tex.man: Account for --translate-file option, %& + --translate-file tcxname construct. + + * pdftex.man, mpost.man, mf.man, etex.man: Account for + --translate-file option. + +1999-01-27 Olaf Weber <olaf@infovore.xs4all.nl> + + * latex.man: Correct typography of pdfTeX. + +1999-01-24 Olaf Weber <olaf@infovore.xs4all.nl> + + * dvicopy.man: Update page; description is still incomplete. + +1999-01-13 Olaf Weber <olaf@infovore.xs4all.nl> + + * Makefile.in: Rename kpathsea.make to kpathsea.mk. + +1999-01-10 Olaf Weber <olaf@infovore.xs4all.nl> + + * pdftex.man: Add definition of MF macro. + + * Makefile.in: Change of ../make/*.make to ../make/*.mk. + +Fri Apr 10 06:24:25 1998 Olaf Weber <olaf@infovore.xs4all.nl> + + * etex.man: Definition of MF macro added. + + * omega.man: Defnition of MF macro was missing. + + * pdftex.man: Definition of MF macro was missing. + +Sat Mar 7 18:16:40 1998 Olaf Weber <olaf@infovore.xs4all.nl> + + * omega.man: Add authors list. + + * pdftex.man: Add authors list. + +Tue Mar 3 09:07:10 1998 Olaf Weber <olaf@infovore.xs4all.nl> + + * omega.man: Corrected instructions for subscribing to the omega + list. + +Fri Jan 9 21:14:37 1998 Olaf Weber <infovore@xs4all.nl> + + * Makefile.in: Include clean.make, add a default target. + +Sun Jan 4 15:57:34 1998 Olaf Weber <infovore@xs4all.nl> + + * Makefile.in: Use man.make to supply rules for manual pages. + + * Makefile.in: Changes to cope with new manual pages. + +Tue Dec 30 17:46:24 1997 Olaf Weber <infovore@xs4all.nl> + + * Changes to all pages in an attempt to get them up-to-date. Some + pages (amslatex, lamstex, slitex, initex, virtex) have been + removed. Some renamed (etex -> eplain). Some added (etex, + pdftex, omega). + +Tue Dec 12 16:52:12 1995 Karl Berry <karl@cs.umb.edu> + + * Makefile.in (sedscript): Correct path for c-auto.h. From Ulrik. + +Tue Jun 13 11:31:35 1995 Karl Berry <karl@cs.umb.edu> + + * Makefile.in: Use ../web2c, not /w. + +Mon Dec 19 13:07:24 1994 Karl Berry <karl@cs.umb.edu> + + * dvitype.man: The .dvi file extended if necessary. + * vftovp.man: Similarly. + +Sat Dec 17 16:44:49 1994 Karl Berry <karl@cs.umb.edu> + + * tftopl.man: Both the .tfm and .pl files are extended if + necessary now. + * vptovf.man: Similarly. + +Thu Nov 24 13:42:16 1994 Karl Berry <karl@cs.umb.edu> + + * bibtex.man: We don't use TEXINPUTS to look for .bst files now. + +Mon Feb 21 14:50:51 1994 Karl Berry (karl@cs.umb.edu) + + * Makefile.in: srcdir changes from simon. + +Wed Feb 2 11:00:09 1994 Karl Berry (karl@cs.umb.edu) + + * Version 6.1. + +Mon Jan 24 07:31:37 1994 Karl Berry (karl@cs.umb.edu) + + * Version 6.0. + +Sat Jan 22 06:48:27 1994 Karl Berry (karl@cs.umb.edu) + + * *.man: Remove ==== line after NAME section, since Sun's + makewhatis doesn't ignore it. + +Tue Dec 14 20:02:06 1993 Karl Berry (karl@cs.umb.edu) + + * *.man: Update for new path variables, etc. + * Makefile.in (sedscript): Likewise. + +Sun Dec 12 19:14:19 1993 Karl Berry (karl@cs.umb.edu) + + * mf.man: Don't mention cmsources. + * Makefile.in (cmsources): Don't bother with this. + (sedscript): Don't substitute for this, and rm the dependency on + lib/paths.h, since it doesn't exist any more. + +Sun Dec 5 16:04:51 1993 Karl Berry (karl@cs.umb.edu) + + * tex.man: Document the envvars MAKETEXTEX, USE_MAKETEXTEX, etc. + * mf.man: Likewise. + +Sun Nov 14 11:58:01 1993 Karl Berry (karl@cs.umb.edu) + + * Makefile.in: texfontdir => fontdir. + +Thu Oct 7 10:04:22 1993 Karl Berry (karl@cs.umb.edu) + + * latex.man: Mention the LaTeX manual and the local guide. From + tuttle@crl.dec.com. + +Sat Jul 10 09:24:56 1993 Karl Berry (karl@cs.umb.edu) + + * mf.man: The word `facilitates' bothers me. + +Tue May 18 14:03:49 1993 Karl Berry (karl@cs.umb.edu) + + * Makefile.in (install-*): mkdirchain on install dirs. + +Sun May 9 13:22:00 1993 Karl Berry (karl@cs.umb.edu) + + * Makefile.in: Use ! instead of %, which loses on the EDITOR string. + +Tue May 4 10:23:33 1993 Karl Berry (karl@cs.umb.edu) + + * weave.man: Correct date, other miscellany. + +Mon Mar 29 08:57:19 1993 Karl Berry (karl@cs.umb.edu) + + * bibtex.man: System default for BSTINPUTS is BSTINPUTS, not + TEXINPUTS. + +Sat Mar 13 10:38:14 1993 Karl Berry (karl@cs.umb.edu) + + * bibtex.man: Had stdout sentence end in wrong place. + + * Makefile.in (sedscript): Use % instead of ; to delimit sed + arguments, since ; might occur in the yytext declaration. (From + ilan343@violet.berkeley.edu.) + +Sun Feb 28 10:52:01 1993 Karl Berry (karl@cs.umb.edu) + + * Makefile.in: Separate clean targets. + + * Makefile.in (clean): Don't remove Makefile here. + +Sun Feb 21 08:28:14 1993 Karl Berry (karl@cs.umb.edu) + + * Version 5.851d. + +Tue Feb 16 17:54:04 1993 Karl Berry (karl@cs.umb.edu) + + * Makefile.in (install-exec, install-data): New targets. + +Fri Feb 12 12:43:04 1993 Karl Berry (karl@cs.umb.edu) + + * tangle.man, weave.man: Separate. + +Fri Jan 29 12:07:08 1993 Karl Berry (karl@cs.umb.edu) + + * tex.man: Describe texfonts.map. + +Mon Jan 25 13:55:40 1993 Karl Berry (karl@cs.umb.edu) + + * Makefile.in (sedscript): Don't use $@; get definitions from + c-auto.h as well as paths.h. + +Thu Jan 14 08:08:20 1993 Karl Berry (karl@cs.umb.edu) + + * bibtex.man: Mention that DEK's bibtex doesn't have some of our + features. + +Sun Jan 3 13:35:05 1993 Karl Berry (karl@cs.umb.edu) + + * etex.man: The listed features aren't the only ones. + + * Makefile.in (distclean): Remove Makefile. + +Sat Jan 2 15:58:52 1993 Karl Berry (karl@cs.umb.edu) + + * Makefile.in (dw, spell, check, .ps, .txt): New targets from beebe. + * *.man: Likewise. + +Fri Dec 18 13:32:01 1992 Karl Berry (karl@cs.umb.edu) + + * tftopl.man: .tfm is now added if necessary. + +Mon Dec 14 07:40:07 1992 Karl Berry (karl@cs.umb.edu) + + * <many>.man: Remove end-of-sentence periods after paths. + +Sun Dec 13 15:00:23 1992 Karl Berry (karl@cs.umb.edu) + + * bibtex.man: Document BSTINPUTS. + +Sat Dec 12 13:16:25 1992 Karl Berry (karl@cs.umb.edu) + + * Makefile.in: Rewrite from Makefile. + + * mf.man: Missing quotes in MFTERM line. + +Tue Oct 6 08:18:48 1992 Karl Berry (karl@cs.umb.edu) + + * {mf,tex}.man: Use ~me instead of /usr/me. + + * {gftodvi,gftopk,gftype,pktogf,pktype,vftovp}.man: Current + directory is not searched first. + +Fri Sep 4 09:02:22 1992 Karl Berry (karl@hayley) + + * Makefile (extraclean): new target. + +Sun Jul 5 07:26:14 1992 Karl Berry (karl@hayley) + + * tex.man: avoid lines >= 80 chars. + + * Makefile (*clean): remove *.dvi and *.log; have `mostlyclean' do + nothing. + +Tue Jun 23 09:14:07 1992 Karl Berry (karl@hayley) + + * Makefile (manext): default to `1', not `l'. + +Fri May 29 16:54:43 1992 Karl Berry (karl@hayley) + + * bibtex.man: more paragraphs, etc. + +Sat May 23 12:26:53 1992 Karl Berry (karl@hayley) + + * tex.man: document slightly different path searching. + +Thu May 14 19:21:49 1992 Karl Berry (karl@claude.cs.umb.edu) + + * Version 5.851c. + +Thu Apr 23 12:06:30 1992 Karl Berry (karl@hayley) + + * tex.man, mf.man: fix nroff quote problems. + * Makefile (sedscript): toss trailing comments. + These changes from Andreas. + +Thu Apr 16 13:49:36 1992 Karl Berry (karl@ra.cs.umb.edu) + + * Version 5.851b. + +Sun Apr 12 11:51:58 1992 Karl Berry (karl@hayley) + + * tex.man: . not searched first anymore. + +Fri Apr 3 09:55:14 1992 Karl Berry (karl at hayley) + + * Version 5.851a. + +Sat Mar 21 09:14:20 1992 Karl Berry (karl at hayley) + + * patgen.man: update for patgen2. + + * *.man: (ENVIRONMENT VARIABLES): rename to `ENVIRONMENT'; remove + references to TEXFONTS_SUBDIR. + + * tex.man (ENVIRONMENT): mention ~. + + * Makefile (sedscript): depend using srcdir, not SITEDIR. + +Fri Mar 20 16:43:23 1992 Karl Berry (karl at hayley) + + * Makefile (mostlyclean): new name for `clean'. + (clean): what `realclean' used to be. + (realclean): nothing to do anymore. + (install): install the stuff. + +Sat Feb 1 16:45:54 1992 Karl Berry (karl at hayley) + + * tex.man: update path searching info. + +Sat Jan 11 08:47:26 1992 Karl Berry (karl at hayley) + + * Makefile (initex.1, virtex.1): new targets. + +Tue Jan 7 16:04:29 1992 Karl Berry (karl at hayley) + + * Use `1 Jan 1992' date format. diff --git a/Build/source/texk/web2c/man/Makefile.in b/Build/source/texk/web2c/man/Makefile.in new file mode 100644 index 00000000000..5b8d0d230e9 --- /dev/null +++ b/Build/source/texk/web2c/man/Makefile.in @@ -0,0 +1,80 @@ +# Makefile for web2c manual pages. +# +# You need to change the variables and the pathnames only if this +# Makefile is invoked on its own, instead of from `../Makefile'. + +version = @WEB2CVERSION@ + +SHELL = /bin/sh +top_srcdir = @top_srcdir@ +srcdir = @srcdir@ +VPATH = @srcdir@ + +kpse_include ../make/common.mk +kpse_include kpathsea.mk + +INSTALL = @INSTALL@ +INSTALL_DATA = @INSTALL_DATA@ + +DITROFF = ditroff +DITROFF = groff + +# These pathnames are used to customize the manual pages with local +# directory names. They should match the system directories so the +# documentation and the programs will be consistent. They are overridden +# by make from web2c/Makefile. +kpse_include ../make/paths.mk + +localmodes = modes + +# If you like, delete the man pages for programs you aren't installing. +# The programs are listed in alphabetical order. +# +manfiles= \ + amstex.1 \ + bibtex.1 \ + cweb.1 \ + dmp.1 \ + dvicopy.1 \ + dvitomp.1 \ + dvitype.1 \ + eplain.1 \ + etex.1 \ + gftodvi.1 \ + gftopk.1 \ + gftype.1 \ + latex.1 \ + makempx.1 \ + mf.1 \ + mft.1 \ + mpost.1 \ + mpto.1 \ + newer.1 \ + omega.1 \ + patgen.1 \ + pdfetex.1 \ + pdftex.1 \ + pktogf.1 \ + pktype.1 \ + pltotf.1 \ + pooltype.1 \ + tangle.1 \ + tex.1 \ + tftopl.1 \ + vftovp.1 \ + vptovf.1 \ + weave.1 + +default all: manfiles + +kpse_include ../make/man.mk + +install install-data: install-man + +Makefile: Makefile.in ../config.status + (cd ..; $(SHELL) config.status) + +kpse_include ../make/clean.mk + +# Prevent GNU make 3 from overflowing arg limit on system V. +.NOEXPORT: diff --git a/Build/source/texk/web2c/man/README b/Build/source/texk/web2c/man/README new file mode 100644 index 00000000000..7f11613a67b --- /dev/null +++ b/Build/source/texk/web2c/man/README @@ -0,0 +1,260 @@ +(This file written by Nelson H. F. Beebe <beebe@math.utah.edu>.) + +This directory contains UNIX manual pages for TeXware and MFware. + +Here are some guidelines for writing UNIX manual page files, based on +the standards used by Sun Microsystems. The manual pages in this +directory have been revised to conform to these guidelines. + +*** The sections of a manual page are identified by these headings: + +.TH PROGRAM 1 "dd month yyyy" +.SH NAME +.SH SYNOPSIS +.SH DESCRIPTION +.SH OPTIONS +.SH ENVIRONMENT +.SH FILES +.SH "SEE ALSO" +.SH AUTHOR + +Additional sections may be supplied, but the above section order +should be preserved. If you are adding a new section, try to find +several examples in existing UNIX manual pages to justify the header +name you choose. + +To improve readability of the [nt]roff man page files in this +directory, each section header has been prefixed by a comment line of +the form +.\"===================================================================== + + +------------------------------------------------------------------------ + +*** The + +.TH PROGRAM 1 "dd month yyyy" + +line should be the first [nt]roff dotted command in the .man file, +other than comments, which begin with the 3-character sequence .\". + +The PROGRAM name should be spelled entirely in uppercase letters. + +The single character following PROGRAM is the manual page section, +generally 1 for user commands. Any character from the set [1-8nl] is +recognized by the UNIX man command, but the sections have specific +meanings (1=user commands, 2=system calls, 3=library routines, 4=special +files, 5=file formats and conventions, 6=games, 7=macro packages and +language conventions, 8=maintenance, l=local, and n=new). + +Historically, man page files were stored in /usr/man/man[1-8nl], with +local additions to /usr/man/manl. That approach offered no +subdivision of local additions into sections, so the trend today is to +leave the /usr/man tree in the state supplied by the vendor, and to +maintain a separate tree, /usr/man/man[1-8nl], to hold local +additions. Most UNIX man implementations support a MANPATH variable +to specify a search path, such as /usr/man:/usr/local/man. + +If your man command doesn't support a MANPATH variable, get the +freely-available man implementation man-1.0.tar.Z available on several +Internet archive sites, including gatekeeper.dec.com in +/.8/GNU/man-1.0.tar.Z. Some bugs exist in that version, and fixes were +supplied to the program's author on 12 December 1992, so look for a new +version, or ask Nelson Beebe <beebe@math.utah.edu> for a set of patches. +This new man implementation has some nice features, including support +for compressed files, and checking of formatted and raw file time stamps +to decide whether to reformat or not. Furthermore, it can be configured +to use either [nt]roff, or GNU groff; some UNIX vendors charge extra for +[nt]roff, so groff may offer a cheaper man page implementation. + +The last argument to .TH is the date in the form 01 December 1992; the +month is NOT abbreviated. + + +------------------------------------------------------------------------ + +*** Following +.SH NAME +should be a single line with NO macros, such as + +bibtex \- make a bibliography for (La)TeX + +This line is very important, because it is used by the "man -k" and +"apropos" commands to look up commands by keywords; every word in the +line is a potential keyword match. + + +------------------------------------------------------------------------ + +*** Following +.SH SYNOPSIS +there should be one or more lines in the form + +.B vftovp +[ +.B \-verbose +] +[ +.BI \-charcode-format =format +] +.I vf_file_name +.I tfm_file_name +[ +.I vpl_file_name +] + +Program names and option switches are typeset in bold type (.B), and +file names in italics (.I). Switch values are in italics. + +Give option switches in alphabetical order in the SYNOPSIS +section, and their descriptions in the same order in the OPTIONS +section. + + +------------------------------------------------------------------------ + +*** Here are some general [nt]roff hints for writing the +.SH DESCRIPTION +section. + + +*** Separate paragraphs by a .PP command, not by blank lines. + + +*** When using the multi-font selectors, like .BI (bold, then italic), +remember that fonts alternate in the following space-separated words: + +.BI aaa bbb ccc ddd + +will typeset aaa and cccc in bold, and bbb and ddd in italic, with NO +intervening spaces, so the result here will be aaabbbcccddd. If you +want spaces between the words, use quotation marks: + +.BI "aaa " "bbb " "ccc " ddd + +will produce aaa bbb ccc ddd. + +Use [nt]roff dotted font change sequences (.I, .B, .BI, .BR, ...) +instead of the \fX...\fP alternatives. The single exception is when +you need quotation marks in italics, such as \fIsetenv FOOBAR "foo +bar"\fP. + + +*** Represent en dashes by the current font minus (\-), and use the +same character in front of option switches. Hyphens in words, as +``multi-font'', are written with the ASCII minus sign. + + +*** Quotation marks are [nt]roff grouping commands, analogous to curly +braces in TeX files. They will NOT survive in the formatted output. +If you want typeset quotation marks, use ``phrase'', just as in TeX. + + +*** Ellipses (...) in [nt]roff are coded as .\|.\|., for the same +reason that \ldots{} is used in TeX instead of .... + + +*** UNIX is a trademark of AT&T Bell Laboratories and must be spelled +in uppercase letters. + + +*** Watch out for spaces. Unlike TeX, [nt]roff preserve ALL input +spaces. This means you cannot indent [nt]roff input for readability. +Two spaces should follow a sentence-ending period, and otherwise, only +one space should be used. Tabs are special in [nt]roff; they are used +to separate columns of tables, like & in TeX, and no other character +can be used for that purpose. The man page files in this directory +contain no tabs, and trailing blanks have been stripped from all +files. + + +*** Do not used fixed indentation dimensions for displayed material. +Instead, use .RS and .RE to mark the indented paragraphs, with .IP to +separate paragraphs: + +.RS +Blah blah blah blah blah blah blah blah blah. +Blah blah blah blah blah blah blah blah blah. +.IP +Blah blah blah blah blah blah blah blah blah. +Blah blah blah blah blah blah blah blah blah. +.RE + + +*** Use macros for phrases that require special typesetting, such as +the TeX logo, and provide both nroff and troff definitions: + +.if n .ds AB nroff-definition +.if t .ds AB troff-definition + +Macro names are exactly 2 characters long, and are referenced by \*( +prefixed to their names, e.g. \*(AB. + +If a macro expansion requires another macro, it must be given after +that macro. For example, the BibTeX and LaTeX macros follow the TeX +macro so they can use \*(TX in their definitions. + +Suitable macros have been provided for TeX, BibTeX, LaTeX, Metafont, +and Web, and adjusted for troff's default Times Roman typeface to +match their appearance with Computer Modern typefaces. + + +------------------------------------------------------------------------ + +*** The +.SH ENVIRONMENT +section should list all the relevant environment variables, with a brief +description and system defaults if appropriate. + + +*** Environment variables are spelled in uppercase letters, e.g., +TEXFONTS, and NO font size changes are made around them. When font +sizes were changed in the past, many inconsistencies were present, so +the practice has been abandoned. + + +*** Do not use fixed dimensions for indented labelled paragraphs. +Instead, use the width of the longest label, plus 2n, as follows: + +.TP \w'LONGESTLABEL'u+2n +LABEL +Blah blah blah blah blah blah blah blah blah. +.TP +LONGESTLABEL +Blah blah blah blah blah blah blah blah blah. +Blah blah blah blah blah blah blah blah blah. + +If the longest label is extremely long, pick a somewhat shorter one so +as to avoid having very short paragraph lines. + + +------------------------------------------------------------------------ + +*** Spell TeX control sequences in Roman letters, doubling the +backslash, e.g. \\input, or for better visibility, use italics +with the backslash represented as \e: + +.I \einput + +Although some [nt]roff implementations support a typewriter font which +is conventional for TeX control sequences, historically only roman, +bold, italic, and special fonts were available. + + +*** These manual pages in the *.man form are filtered by sedscript to +expand @XYZ@ into something else, producing corresponding *.1 files +which are installed in the system manual page directories. This is +used to insert local paths into the manual pages, so that for example +@TEXINPUTS@ is replaced by the local default TEXINPUTS search path. +Such paths are set at installation time in the top-level Makefile. + + +*** You can use the UNIX checknr utility to do a rudimentary validation of +your manual page files, e.g. + + checknr -c.BI.BR.IR.IB.RB.RI tex.man + +The -c.BI.BR.IR.IB.RB.RI is needed because checknr doesn't know about +the -man document style, and otherwise complains about those font +change commands. The command "make check" will run checknr with each +of the *.1 files. diff --git a/Build/source/texk/web2c/man/amslatex.min b/Build/source/texk/web2c/man/amslatex.min new file mode 100644 index 00000000000..9c756daa82e --- /dev/null +++ b/Build/source/texk/web2c/man/amslatex.min @@ -0,0 +1,108 @@ +.TH AMSLATEX 1 "23 January 1994" +.\"===================================================================== +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.if t .ds AX \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(TX +.if n .ds AX AmSTeX +.if t .ds AY \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(LX +.if n .ds AY AmSLaTeX +.if t .ds LZ \ +\fRL\ +\\h'-0.3m'\\v'-0.21v'\s-2A\s0\\v'0.21v'\ +\\h'-0.15m'\\v'0.188v'M\\v'-0.188v'\ +\\h'-0.125m'S\ +\fP-\*(TX +.if n .ds LZ LAmS-TeX +.if t .ds OZ \ +\fIL\ +\\h'-0.3m'\\v'-0.21v'\s-2A\s0\\v'0.21v'\ +\\h'-0.15m'\\v'0.188v'M\\v'-0.188v'\ +\\h'-0.125m'S\ +\fP-\*(OX +.if n .ds OZ LAmS-TeX +.\"===================================================================== +.SH NAME +amslatex \- structured text formatting and typesetting +.SH SYNOPSIS +.B amslatex +[ first-line ] +.\"===================================================================== +.SH DESCRIPTION +\*(AY is an extension of \*(LX (see +.IR "\*(LX \- A Document Preparation System" ) +that provides the powerful mathematical typesetting macros of +\*(AX (see +.IR "The Joy of \*(OX" ) +within the syntax of \*(LX. It should be contrasted with +\*(LZ +.RB ( lamstex (1)), +which extends \*(AX with \*(LX-like features. +.PP +\*(AY documents can be processed +by +.BR latex (1), +so a separate executable program named +.B amslatex +is not usually provided. +.PP +\*(AY is a \*(TX macro package, not a modification to the \*(TX source +program, so all the capabilities described in +.BR tex (1) +are present. +.PP +The \*(AY macros encourage writers to think about the content of their +documents, rather than the form. The ideal, not always realized, is to +have no formatting commands (like ``switch to italic'' or ``skip 2 +picas'') in the document at all; instead, everything is done +by specific markup instructions: ``emphasize'', ``start a section''. +.PP +\*(AX is the official typesetting system of the American Mathematical +Society, and nearly all of its publications are typeset using \*(AX. The +online version of AMS Math Reviews uses \*(AX input syntax for display of +mathematical material. AMS authors can provide editors with +computer-readable \*(AX or \*(AY files. +.PP +\*(AY will become deprecated in favor of \*(LX 2e, when the latter is +released. +.\"===================================================================== +.SH FILES +.TP \w'@@'u+2n +.I "@DEFAULT_TEXMF@/doc/ams/amslatex/amsldoc.tex" +Documentation for \*(AY, typesettable by \*(LX. +This supersedes +.IR "The Joy of \*(OX" , +but \*(AY users may still find that book a convenient supplement. +.TP +.I "@TEXINPUTDIR@/doc/ams/amslatex/testart.tex" +Sample \*(LA document illustrating the +.I amsart +document style. +.TP +.I "@TEXINPUTDIR@/doc/ams/amslatex/testbook.tex" +Sample \*(LA document illustrating the +.I amsbook +document style. +.\"===================================================================== +.SH "SEE ALSO" +.BR amstex (1), +.BR lamstex (1), +.BR latex (1), +.BR tex (1), +.BR slitex (1). +.br +Leslie Lamport, +.IR "\*(LX \- A Document Preparation System" , +Addison-Wesley, 1985, ISBN 0-201-15790-X. +.br +Michael Spivak, +.IR "The Joy of \*(OX" , +2nd edition, Addison-Wesley, 1990, ISBN 0-8218-2997-1. diff --git a/Build/source/texk/web2c/man/amstex.man b/Build/source/texk/web2c/man/amstex.man new file mode 100644 index 00000000000..3119c898ee8 --- /dev/null +++ b/Build/source/texk/web2c/man/amstex.man @@ -0,0 +1,69 @@ +.TH AMSTEX 1 "27 December 1992" "Web2C @VERSION@" +.\"===================================================================== +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.if t .ds AX \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(TX +.if n .ds AX AmSTeX +.if t .ds AY \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(LX +.if n .ds AY AmSLaTeX +.\"===================================================================== +.SH NAME +amstex \- structured text formatting and typesetting +.SH SYNOPSIS +.B amstex +[ first line ] +.\"===================================================================== +.SH DESCRIPTION +This manual page is not meant to be exhaustive. The complete +documentation for this version of \*(TX can be found in the info file +or manual +.IR "Web2C: A TeX implementation" . +.PP +The \*(AX language is described in the book +.IR "The Joy of \*(OX" . +\*(AX is a \*(TX macro package, not a modification to the \*(TX source +program, so all the capabilities described in +.BR tex (1) +are present. +.PP +The \*(AX macros encourage writers to think about the content of their +documents, rather than the form. The ideal, not always realized, is to +have no formatting commands (like ``switch to italic'' or ``skip 2 +picas'') in the document at all; instead, everything is done +by specific markup instructions: ``emphasize'', ``start a section''. +.PP +\*(AX is the official typesetting system of the American Mathematical +Society, and nearly all of its publications are typeset using \*(AX. The +online version of AMS Math Reviews uses \*(AX input syntax for display of +mathematical material. AMS authors can provide editors with +computer-readable \*(AX files. +.PP +For authors more familiar with \*(LX, an AMS-supported package called +.I amsmath.sty +is is available. +.\"===================================================================== +.SH FILES +.TP +.I amsguide.tex" +Documentation for \*(AX, typesettable by \*(TX. +.TP +.I amfndoc.tex" +Documentation for AMS fonts, typesettable by \*(TX. +.\"===================================================================== +.SH "SEE ALSO" +.BR latex (1), +.BR tex (1), +.BR slitex (1). +.br +Michael Spivak, +.IR "The Joy of \*(OX" , +2nd edition, Addison-Wesley, 1990, ISBN 0-8218-2997-1. diff --git a/Build/source/texk/web2c/man/bibtex.man b/Build/source/texk/web2c/man/bibtex.man new file mode 100644 index 00000000000..59b4034a847 --- /dev/null +++ b/Build/source/texk/web2c/man/bibtex.man @@ -0,0 +1,146 @@ +.TH BIBTEX 1 "24 November 1994" "Web2C @VERSION@" +.\"===================================================================== +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\\s-2A\\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.\"===================================================================== +.SH NAME +bibtex \- make a bibliography for (La)TeX +.SH SYNOPSIS +.B bibtex +[ +.BI -min-crossrefs =number +] +[ +.B -terse +] +[ +.I auxname +] +.\"===================================================================== +.SH DESCRIPTION +This manual page is not meant to be exhaustive. The complete +documentation for this version of \*(TX can be found in the info file +or manual +.IR "Web2C: A TeX implementation" . +.PP +\*(BX reads the top-level auxiliary +.RI ( .aux ) +file that was output during the running of +.BR latex (1) +or +.BR tex (1) +and creates a bibliography +.RI ( .bbl ) +file that will be incorporated into the document on subsequent runs of +\*(LX or \*(TX. The +.I auxname +on the command line must be given without the +.I .aux +extension. If you don't give the +.IR auxname , +the program prompts you for it. +.PP +\*(BX looks up, in bibliographic database +.RI ( .bib ) +files specified by the \\bibliography command, +the entries specified by the \\cite and \\nocite commands +in the \*(LX or \*(TX source file. +It formats the information from those entries +according to instructions in a bibliography style +.RI ( .bst ) +file (specified by the \\bibliographystyle command, +and it outputs the results to the +.I .bbl +file. +.PP +The \*(LX manual +explains what a \*(LX source file must contain to work with \*(BX. +Appendix B of the manual describes the format of the +.I .bib +files. The `\*(BXing' document describes extensions and details of +this format, and it gives other useful hints for using \*(BX. +.\"===================================================================== +.SH OPTIONS +The +.B -min-crossrefs +option defines the minimum number of +.B crossref +required for automatic inclusion of the crossref'd entry on the citation +list; the default is two. +With the +.B -terse +option, \*(BX operates silently. Without it, a banner and progress +reports are printed on +.IR stdout . +.PP +.\"===================================================================== +.SH ENVIRONMENT +\*(BX searches the directories in the +path defined by the BSTINPUTS environment variable for +.I .bst +files. If BSTINPUTS is not set, it uses the system default. +For +.I .bib +files, it uses the BIBINPUTS environment variable if that is set, +otherwise the default. +See +.BR tex (1) +for the details of the searching. +.PP +If the environment variable +TEXMFOUTPUT is set, \*(BX attempts to put its output +files in it, if they cannot be put in the current directory. Again, see +.BR tex (1). +No special searching is done for the +.I .aux +file. +.\"===================================================================== +.SH FILES +.TP +.I *.bst +Bibliography style files. +.TP +.I btxdoc.tex +``\*(BXing'' \- \*(LXable documentation for general \*(BX users +.TP +.I btxhak.tex +``Designing \*(BX Styles'' \- \*(LXable documentation for style designers +.TP +.I btxdoc.bib +database file for those two documents +.TP +.I xampl.bib +database file giving examples of all standard entry types +.TP +.I btxbst.doc +template file and documentation for the standard styles +.PP +All those files should be available somewhere on your system. +.PP +The host math.utah.edu has a vast collection of +.I .bib +files available for anonymous ftp, including references for all the +standard \*(TX books and a complete bibliography for TUGboat. +.\"===================================================================== +.SH "SEE ALSO" +.BR latex (1), +.BR tex (1). +.br +Leslie Lamport, +.IR "\*(LX \- A Document Preparation System" , +Addison-Wesley, 1985, ISBN 0-201-15790-X. +.\"===================================================================== +.SH AUTHOR +Oren Patashnik, Stanford University. This man page describes the web2c +version of \*(BX. Other ports of \*(BX, such as Donald Knuth's version +using the Sun Pascal compiler, do not have the same path searching +implementation, or the command-line options. diff --git a/Build/source/texk/web2c/man/cweb.man b/Build/source/texk/web2c/man/cweb.man new file mode 100644 index 00000000000..0e0cbf5b382 --- /dev/null +++ b/Build/source/texk/web2c/man/cweb.man @@ -0,0 +1,133 @@ +.TH CWEB 1 "19 December 2004" "Web2C @VERSION@" +. +.SH NAME +ctangle, cweave \- translate CWEB to C and/or TeX +. +.SH SYNOPSIS +.na +.B ctangle +[ +.B \-bhp +] [ +.B +s +] webfile[.w] [changefile[.ch]] [outputfile[.c]] +.br +.B cweave +[ +.B \-befhpx +] [ +.B +s +] webfile[.w] [changefile[.ch]] [outputfile[.tex]] +.ad +. +.SH DESCRIPTION +The +.I ctangle +program converts a CWEB +source document into a C\ program that may be compiled in the usual way. +The output file includes #line specifications so that debugging can be +done in terms of the CWEB source file. +.PP +The +.I cweave +program converts the same CWEB file into a TeX file that may be +formatted and printed in the usual way. +It takes appropriate care of typographic details like page +layout and the use of indentation, italics, boldface, etc., and it supplies +extensive cross-index information that it gathers automatically. +.PP +CWEB allows you to prepare a single +document containing all the information that is needed both to produce +a compilable C\ program and to produce a well-formatted document +describing the program in as much detail as the writer may desire. +The user of CWEB ought to be familiar with TeX as well as\ C. +.PP +The command line should have one, two, or three names on it. +The first is taken as the CWEB file (and .w is added if there is no +extension). +If that file cannot be opened, the extension .web is tried instead. +(But .w is recommended, since .web usually implies Pascal.) +If there is a second name, it is a change file (and .ch is added if there is +no extension). +The change file overrides parts of the WEB file, +as described in the documentation. +If there is a third name, it overrides +the default name of the output file, which is ordinarily the same as +the name of the input file (but on the current directory) with the +extension .c or .tex. +.PP +Options in the command line may be either turned off with\ \- +(if they are on by default) or turned on with\ + (if they are off by +default). +In fact, the options are processed from left to right, +so a sequence like -f\ +f corresponds to +f (which is the default). +.PP +The +.B \-b +option suppresses the banner line that normally appears on your terminal +when ctangle or cweave begins. +The +.B \-h +option suppresses the happy message that normally appears if the processing +was successful. +The +.B \-p +option suppresses progress reports (starred module numbers) as the processing +takes place. +If you say -bhp, you get nothing but error messages. +.PP +The +.B +s +option prints statistics about memory usage at the end of a run +(assuming that the programs have been compiled with the -DSTAT switch). +.PP +There are three other options applicable to +.I cweave +only: +.B \-f +means do not force a newline after every statement in the formatted output. +.B \-e +inhibits the enclosure of C\ material formatted by +.I cweave +in brackets +\ePB{...}. +Such brackets are normally inserted so that special hooks +can be used by +.I cweb-latex +and similar programs. +.B \-x +means omit the index and table of contents. +. +.SH FILES +The location of the files mentioned below varies from system to +system. Use the +.B kpsewhich +utility to find their locations. +.TP +.I cwebmac.tex +TeX macros used by cweave output. +.TP +.I cwebman.tex +The user manual. +. +.SH "SEE ALSO" +.TP +.I Literate Programming +by D. E. Knuth +.TP +.I Weaving a Program +by Wayne Sewell +.TP +.I The CWEB System of Structured Documentation +by Donald E. Knuth and Silvio Levy (hardcopy version of cwebman.tex +and the source code listings) +.TP +tex(1), cc(1) +. +.SH AUTHORS +Don Knuth wrote WEB for TeX and Pascal. +Silvio Levy designed and developed CWEB +by adapting the WEB conventions to\ C and by recoding everything in CWEB. +Knuth began using CWEB and made further refinements. +Many other helpers are acknowledged in the CWEB manual. + diff --git a/Build/source/texk/web2c/man/dmp.man b/Build/source/texk/web2c/man/dmp.man new file mode 100644 index 00000000000..44544157615 --- /dev/null +++ b/Build/source/texk/web2c/man/dmp.man @@ -0,0 +1,60 @@ +.TH DMP 1 "4 January 1998" "Web2C @VERSION@" +.\"===================================================================== +.if n .ds MP MetaPost +.if t .ds MP MetaPost +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.\"===================================================================== +.SH NAME +dmp \- translate Troff output to low-level MetaPost input +.SH SYNOPSIS +.B dmp +.RI [ option ] +.I ditrofffile +.RI [ mpxfile ] +.\"===================================================================== +.SH DESCRIPTION +This manual page is not meant to be exhaustive. The complete +documentation for this version of \*(TX can be found in the info file +or manual +.IR "Web2C: A TeX implementation" . +.PP +The +.B dmp +program generates \*(MP source code from the +.IR ditrofffile . +The generated code is written in +.I mpxfile +if it is specified, and to standard output otherwise. +.PP +.B dmp +is typically called from scripts like +.BR makempx , +not from the command line. +.\"===================================================================== +.SH OPTIONS +.B dmp +accepts the following options: +.TP +.B --help +.rb +Print help message and exit. +.TP +.B --version +.rb +Print version information and exit. +.\"===================================================================== +.SH "SEE ALSO" +.BR mpost (1), +.BR makempx (1). diff --git a/Build/source/texk/web2c/man/dvicopy.man b/Build/source/texk/web2c/man/dvicopy.man new file mode 100644 index 00000000000..bca57924070 --- /dev/null +++ b/Build/source/texk/web2c/man/dvicopy.man @@ -0,0 +1,22 @@ +.TH DVICOPY 1 TeX "24 January 1999" "Web2C @VERSION@" +.SH NAME +dvicopy \- produce modified copy of DVI file +.SH SYNOPSIS +.B dvicopy +.RI [ options ] +.RI [ infile\ [ outfile ]] +.SH DESCRIPTION +This manual page is not meant to be exhaustive. The complete +documentation for this version of \*(TX can be found in the info file +or manual +.IR "Web2C: A TeX implementation" . +.PP +.B dvicopy +reads a DVI file, expands any references to virtual fonts to base +fonts, and writes the resulting DVI file. Thus you can use virtual +fonts even if your DVI processor does not support them, by passing the +documents through +.B dvicopy +first. +.SH "SEE ALSO" +dviselect(1) diff --git a/Build/source/texk/web2c/man/dvitomp.man b/Build/source/texk/web2c/man/dvitomp.man new file mode 100644 index 00000000000..a6b74030943 --- /dev/null +++ b/Build/source/texk/web2c/man/dvitomp.man @@ -0,0 +1,17 @@ +.TH DVITOMP 1 "October 30, 1999" +.\" man page by Jim Van Zandt <jrv@vanzandt.mv.com> -*- nroff -*- +.SH NAME +dvitomp \- convert a TeX DVI file to a MetaPost MPXFILE +.SH SYNOPSIS +\fBdvitomp\fP [\fIoptions\fP] \fIdvifile\fP[.dvi] [\fImpxfile\fP[.mpx]] +.SH DESCRIPTION +\fBdvitomp\fP translates the given \fIdvifile\fP to a MetaPost +MPXFILE. The default \fImpxfile\fP is the basename of \fIdvifile\fP +extended with ".mpx". +.SH OPTIONS +.IP \fB-help\fP +write usage summary and exit. +.IP \fB-version\fP +output version information and exit. +.SH BUGS +Email bug reports to tex-k@mail.tug.org. diff --git a/Build/source/texk/web2c/man/dvitype.man b/Build/source/texk/web2c/man/dvitype.man new file mode 100644 index 00000000000..cc93be28eea --- /dev/null +++ b/Build/source/texk/web2c/man/dvitype.man @@ -0,0 +1,74 @@ +.TH DVITYPE 1 "19 December 1994" "Web2C @VERSION@" +.\"===================================================================== +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.\"===================================================================== +.SH NAME +dvitype \- translate a dvi file for humans +.SH SYNOPSIS +.B dvitype +.I dvi_name[.dvi] +.\"===================================================================== +.SH DESCRIPTION +This manual page is not meant to be exhaustive. The complete +documentation for this version of \*(TX can be found in the info file +or manual +.IR "Web2C: A TeX implementation" . +.PP +The +.B dvitype +program translates a DVI (DeVice Independent) file output by (for example) +.BR tex (1) +or +.BR gftodvi (1), +to a file that humans can read. It also serves as a DVI file-validating +program (i.e., if +.B dvitype +can read it, it's correct) and as an example of a DVI-reading +program for future device drivers. +.PP +The output file can include all commands, just the important +ones, or none at all (in which case only errors are reported). +A subinterval of pages may be selected for transliteration; the +magnification and resolution of the ``output device'' may be +changed; and so on. All options are specified with an on-line dialog. +.PP +The +.I .dvi +extension is supplied if omitted from +.IR dvi_name . +The output goes to +.IR stdout . +.\"===================================================================== +.SH ENVIRONMENT +The environment variable TEXFONTS is used to search for the TFM files +used in the DVI file. See +.BR tex (1) +for the details of the searching. +If TEXFONTS is not set, it uses the system default. +.\"===================================================================== +.SH "SEE ALSO" +.BR gftype (1), +.BR pktype (1). +.br +Donald E. Knuth, +.IR \*(OXware . +.\"===================================================================== +.SH BUGS +The interactive dialog should be replaced by command-line options, as +with +.BR gftype . +.SH AUTHORS +Donald E. Knuth wrote the program. It was published as part of the +.I \*(OXware +technical report, available from the \*(TX Users Group. +Howard Trickey and Pavel Curtis originally ported it to Unix. diff --git a/Build/source/texk/web2c/man/eplain.man b/Build/source/texk/web2c/man/eplain.man new file mode 100644 index 00000000000..e9a1805e022 --- /dev/null +++ b/Build/source/texk/web2c/man/eplain.man @@ -0,0 +1,103 @@ +.TH EPLAIN 1 "14 December 1993" "Web2C @VERSION@" +.\"===================================================================== +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.if t .ds AX \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(TX +.if n .ds AX AmSTeX +.if t .ds AY \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(LX +.if n .ds AY AmSLaTeX +.\"===================================================================== +.SH NAME +eplain \- extended plain TeX +.SH SYNOPSIS +.B eplain +[ first-line ] +.\"===================================================================== +.SH DESCRIPTION +This manual page is not meant to be exhaustive. The complete +documentation for this version of \*(TX can be found in the info file +or manual +.IR "Web2C: A TeX implementation" . +.PP +.B eplain +is an extension of plain \*(TX described in the book +.IR "\*(OX for the Impatient" . +It adds these features (among others) to plain \*(TX: +.TP \w'\(bu'u+2n +\(bu +left-justified displays +.TP +\(bu +double-column output +.TP +\(bu +tables of contents +.TP +\(bu +.I \ehrule +and +.I \evrule +with a different default than 0.4pt +.TP +\(bu +time of day +.TP +\(bu +verbatim file listing +.TP +\(bu +generalized footnotes +.TP +\(bu +blank and black boxes +.TP +\(bu +citations using \*(BX +.\"===================================================================== +.SH FILES +.TP +.I eplain/doc/eplain.texi +\*(TXable documentation of +.B etex +macros in +.B texinfo +format. +.TP +.I eplain.info* +Online GNU Emacs +.BR info (1) +files produced from +.IR eplain.texi . +.PP +The complete +.I eplain +distribution is available via anonymous ftp to the Internet host +.I ftp.cs.umb.edu +from the file +.I pub/tex/eplain.tar.Z +which is linked to another file containing the most recent version of +the package. Major \*(TX archive sites should also have it. +.\"===================================================================== +.SH "SEE ALSO" +.BR emacs (1), +.BR info (1), +.BR initex (1), +.BR tex (1), +.BR xinfo (1). +.br +Karl Berry, +.IR eplain , +TUGboat 11(4), 571--572, 1990. +.br +Paul W. Abrahams with Karl Berry and Kathryn A. Hargreaves, +.IR "\*(OX for the Impatient" , +Addison-Wesley, 1990, ISBN 0-201-51375-7. diff --git a/Build/source/texk/web2c/man/etex.man b/Build/source/texk/web2c/man/etex.man new file mode 100644 index 00000000000..dd9ff8c06d8 --- /dev/null +++ b/Build/source/texk/web2c/man/etex.man @@ -0,0 +1,429 @@ +.TH ETEX 1 "21 August 2004" "Web2C @VERSION@" +.\"===================================================================== +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.if t .ds AX \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(TX +.if n .ds AX AmSTeX +.if t .ds AY \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(LX +.if n .ds AY AmSLaTeX +.\"===================================================================== +.SH NAME +etex, einitex, evirtex \- extended TeX +.SH SYNOPSIS +.B etex +.RI [ options ] +[\fB&\fR \fIformat\fR ] +[ \fIfile\fR | \fB\e\fR \fIcommands\fR ] +.\"===================================================================== +.SH DESCRIPTION +Run the e-\*(TX typesetter on +.IR file , +usually creating +.IR file.dvi . +If the file argument has no extension, ".tex" will be appended to it. +Instead of a filename, a set of e-\*(TX commands can be given, the first +of which must start with a backslash. +With a +.BI & format +argument e-\*(TX uses a different set of precompiled commands, +contained in +.IR format.fmt ; +it is usually better to use the +.B -fmt +.I format +option instead. +.PP +e-\*(TX is the first concrete result of an international research & +development project, the NTS Project, which was established under the +aegis of DANTE e.V. during 1992. The aims of the project are to +perpetuate and develop the spirit and philosophy of \*(TX, whilst +respecting Knuth's wish that \*(TX should remain frozen. +.PP +e-\*(TX can be used in two different modes: in +.I compatibility mode +it is supposed to be completely interchangable with standard \*(TX. +In +.I extended mode +several new primitives are added that facilitate (among other things) +bidirectional typesetting. +.PP +An extended mode format is generated by prefixing the name of the +source file for the format with an asterisk (*). Such formats are +often prefixed with an `e', hence +.B etex +as the extended version of +.B tex +and +.B elatex +as the extended version of +.BR latex . +However, +.B eplain +is an exception to this rule. +.PP +The +.B einitex +and +.B evirtex +commands are e-\*(TX's analogues to the +.B initex +and +.B virtex +commands. In this installation, they are symbolic links to the +.B etex +executable. These symbolic links may not exist at all. +.PP +e-\*(TX's handling of its command-line arguments is similar to that of +the other \*(TX programs in the +.I web2c +implementation. +.\"===================================================================== +.SH OPTIONS +This version of e-\*(TX understands the following command line options. +.TP +.BI -fmt \ format +.rb +Use +.I format +as the name of the format to be used, instead of the name by which +e-\*(TX was called or a +.I %& +line. +.TP +.B -enc +.rb +Enable the enc\*(TX extensions. This option is only effective in +combination with +.BR -ini . +For documentation of the enc\*(TX extensions see +.BR http://www.olsak.net/enctex.html . +.TP +.B -etex +.rb +Enable the e-\*(TX extensions. This option is only effective in +combination with +.BR -ini . +.TP +.B -file-line-error +.rb +Print error messages in the form +.I file:line:error +which is similar to the way many compilers format them. +.TP +.B -no-file-line-error +.rb +Disable printing error messages in the +.I file:line:error +style. +.TP +.B -file-line-error-style +.rb +This is the old name of the +.B -file-line-error +option. +.TP +.B -halt-on-error +.rb +Exit with an error code when an error is encountered during processing. +.TP +.B -help +.rb +Print help message and exit. +.TP +.B -ini +.rb +Start in +.I INI +mode, which is used to dump formats. The +.I INI +mode can be used for typesetting, but no format is preloaded, and +basic initializations like setting catcodes may be required. +.TP +.BI -interaction \ mode +.rb +Sets the interaction mode. The mode can be either +.IR batchmode , +.IR nonstopmode , +.IR scrollmode , +and +.IR errorstopmode . +The meaning of these modes is the same as that of the corresponding +\ecommands. +.TP +.B -ipc +.rb +Send DVI output to a socket as well as the usual output file. Whether +this option is available is the choice of the installer. +.TP +.B -ipc-start +.rb +As +.BR -ipc , +and starts the server at the other end as well. Whether this option +is available is the choice of the installer. +.TP +.BI -jobname \ name +.rb +Use +.I name +for the job name, instead of deriving it from the name of the input file. +.TP +.BI -kpathsea-debug \ bitmask +.rb +Sets path searching debugging flags according to the bitmask. See the +.I Kpathsea +manual for details. +.TP +.BI -mktex \ fmt +.rb +Enable +.RI mktex fmt , +where +.I fmt +must be either +.I tex +or +.IR tfm . +.TP +.B -mltex +.rb +Enable ML\*(TX extensions. Only effective in combination with +.BR -ini . +.TP +.BI -no-mktex \ fmt +.rb +Disable +.RI mktex fmt , +where +.I fmt +must be either +.I tex +or +.IR tfm . +.TP +.BI -output-comment \ string +.rb +Use +.I string +for the +.I DVI +file comment instead of the date. +.TP +.BI -output-directory \ directory +.rb Write output files in +.I directory +instead of the current directory. Look up input files in +.I directory +first, the along the normal search path. +.TP +.B -parse-first-line +.rb +If the first line of the main input file begins with +.I %& +parse it to look for a dump name or a +.B -translate-file +option. +.TP +.B -no-parse-first-line +.rb +Disable parsing of the first line of the main input file. +.TP +.BI -progname \ name +.rb +Pretend to be program +.IR name . +This affects both the format used and the search paths. +.TP +.B -recorder +.rb +Enable the filename recorder. This leaves a trace of the files opened +for input and output in a file with extension +.IR .fls . +.TP +.B -shell-escape +.rb +Enable the +.BI \ewrite18{ command } +construct. The +.I command +can be any shell command. This construct is normally +disallowed for security reasons. +.TP +.B -no-shell-escape +.rb +Disable the +.BI \ewrite18{ command } +construct, even if it is enabled in the +.I texmf.cnf +file. +.TP +.B -src-specials +.rb +Insert source specials into the +.I DVI +file. +.TP +.BI -src-specials \ where +.rb +Insert source specials in certain placed of the +.I DVI +file. +.I where +is a comma-separated value list: +.IR cr , +.IR display , +.IR hbox , +.IR math , +.IR par , +.IR parent , +or +.IR vbox . +.TP +.BI -translate-file \ tcxname +.rb +Use the +.I tcxname +translation table to set the mapping of input characters and +re-mapping of output characters. +.TP +.BI -default-translate-file \ tcxname +.rb +Like +.B -translate-file +except that a +.I %& +line can overrule this setting. +.TP +.B -version +.rb +Print version information and exit. +.\"===================================================================== +.SH ENVIRONMENT +See the Kpathsearch library documentation (the `Path specifications' +node) for precise details of how the environment variables are used. +The +.B kpsewhich +utility can be used to query the values of the variables. +.PP +One caveat: In most e-\*(TX formats, you cannot use ~ in a filename you +give directly to e-\*(TX, because ~ is an active character, and hence is +expanded, not taken as part of the filename. Other programs, such as +\*(MF, do not have this problem. +.PP +.TP +TEXMFOUTPUT +Normally, e-\*(TX puts its output files in the current directory. If +any output file cannot be opened there, it tries to open it in the +directory specified in the environment variable TEXMFOUTPUT. +There is no default value for that variable. For example, if you say +.I etex paper +and the current directory is not writable, if TEXMFOUTPUT has +the value +.IR /tmp , +e-\*(TX attempts to create +.I /tmp/paper.log +(and +.IR /tmp/paper.dvi , +if any output is produced.) +.TP +TEXINPUTS +Search path for +.I \einput +and +.I \eopenin +files. +This should probably start with ``.'', so +that user files are found before system files. An empty path +component will be replaced with the paths defined in the +.I texmf.cnf +file. For example, set TEXINPUTS to ".:/home/usr/tex:" to prepend the +current direcory and ``/home/user/tex'' to the standard search path. +.TP +TEXFORMATS +Search path for format files. +.TP +TEXPOOL +search path for +.B etex +internal strings. +.TP +TEXEDIT +Command template for switching to editor. The default, usually +.BR vi , +is set when e-\*(TX is compiled. +.TP +TFMFONTS +Search path for font metric +.RI ( .tfm ) +files. +.\"===================================================================== +.SH FILES +The location of the files mentioned below varies from system to +system. Use the +.B kpsewhich +utility to find their locations. +.TP +.I etex.pool +Text file containing e-\*(TX's internal strings. +.TP +.I texfonts.map +Filename mapping definitions. +.TP +.I *.tfm +Metric files for e-\*(TX's fonts. +.TP +.I *.fmt +Predigested e-\*(TX format (.\|fmt) files. +.br +.\"===================================================================== +.SH NOTES +This manual page is not meant to be exhaustive. The complete +documentation for this version of e-\*(TX can be found in the info +manual +.IR "Web2C: A TeX implementation" . +.\"===================================================================== +.SH BUGS +This version of e-\*(TX implements a number of optional extensions. +In fact, many of these extensions conflict to a greater or lesser +extent with the definition of e-\*(TX. When such extensions are +enabled, the banner printed when e-\*(TX starts is changed to print +.B e-TeXk +instead of +.BR e-TeX . +.PP +This version of e-\*(TX fails to trap arithmetic overflow when +dimensions are added or subtracted. Cases where this occurs are rare, +but when it does the generated +.I DVI +file will be invalid. +.\"===================================================================== +.SH "SEE ALSO" +.BR tex (1), +.BR mf (1). +.\"===================================================================== +.SH AUTHORS +e-\*(TX was developed by Peter Breitenlohner (and the NTS team). +.PP +\*(TX was designed by Donald E. Knuth, +who implemented it using his \*(WB system for Pascal programs. +It was ported to Unix at Stanford by Howard Trickey, and +at Cornell by Pavel Curtis. +The version now offered with the Unix \*(TX distribution is that +generated by the \*(WB to C system +.RB ( web2c ), +originally written by Tomas Rokicki and Tim Morgan. +.PP +The enc\*(TX extensions were written by Petr Olsak. diff --git a/Build/source/texk/web2c/man/gftodvi.man b/Build/source/texk/web2c/man/gftodvi.man new file mode 100644 index 00000000000..eb152fe5f99 --- /dev/null +++ b/Build/source/texk/web2c/man/gftodvi.man @@ -0,0 +1,167 @@ +.TH GFTODVI 1 "14 December 1993" "Web2C @VERSION@" +.\"===================================================================== +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.\"===================================================================== +.SH NAME +gftodvi \- make proof sheets from generic font files +.SH SYNOPSIS +.B gftodvi +[ +.BI \-overflow-label-offset =real +] +[ +.B \-verbose +] +[ +.I gf_file_name +] +.\"===================================================================== +.SH DESCRIPTION +This manual page is not meant to be exhaustive. The complete +documentation for this version of \*(TX can be found in the info file +or manual +.IR "Web2C: A TeX implementation" . +.PP +The +.B gftodvi +program converts a generic font +.RI ( gf ) +file output by, for example, +.BR mf (1), +to a device independent (DVI) file (that can then be typeset using the same +software that has already been written for \*(TX). The characters in the +.I gf +file will appear one per page, with labels, titles, and annotations +as specified in Appendix H (Hardcopy Proofs) of +.IR "The \*(MFbook" . +.PP +.B gftodvi +uses other fonts in addition to the main +.I gf +file. +A `gray' font is used to typeset the +pixels that actually make up the character. (We wouldn't +want all the pixels to be simply black, since then labels, +key points, and other information would be lost.) A `title' font +is used for the information at the top of the page. A `label' font +is used for the labels on key points of the figure. A `slant' +font is used to typeset diagonal lines, which +otherwise have to be simulated using horizontal and vertical rules. +The default gray, title, and label fonts are +.IR gray , +.IR cmr8 , +and +.IR cmtt10 , +respectively; there is no default slant font. +.PP +To change the default fonts, you can give +.BR special +commands in your +\*(MF source file, or you can change the fonts online. An online dialog +ensues if you end the +.I gf_file_name +with a `/'. For example, +.br +.ti +2 +gftodvi cmr10.300gf/ +.br +.ti +2 +Special font substitution: grayfont black +.br +.ti +2 +OK; any more? grayfontarea /home/art/don/ +.br +.ti +2 +OK; any more? slantfont /home/fonts/slantimagen6 +.br +.ti +2 +OK; any more? <RET> +.br +will use +.I /home/art/don/black +as the `gray' font and +.I /home/fonts/slantimagen6 +as the `slant' font (this name indicates +a font for lines with slope 1/6 at the resolution of an Imagen printer). +.PP +The +.I gf_file_name +on the command line must be complete. (The program prompts +you for it if you don't give it.) Because +the resolution is part of the extension, it would not make +sense to append a default extension as is done with \*(TX or +DVI-reading software. The output file name defaults to the same +root as the +.I gf +file, with the +.I dvi +extension added. For example, the input file +.I cmr10.2602gf +would become +.IR cmr10.dvi . +.\"===================================================================== +.SH OPTIONS +The argument to +.B \-overflow-label-offset +specifies the distance from the right edge of the character +bounding box at which the overflow equations (if any) are typeset. +The value is given in \*(TX points. The default is a little over two +inches. +.PP +Without the +.B \-verbose +option, +.B gftodvi +operates silently. With it, a banner and progress report are printed on +.IR stdout . +.\"===================================================================== +.SH ENVIRONMENT +.B gftodvi +looks for +.I gf_file_name +using the +environment variable GFFONTS. If that is not set, it uses the variable +TEXFONTS. If that is not set, it uses the system default. +.PP +See +.BR tex (1) +for the details of the searching. +.\"===================================================================== +.SH FILES +.TP +.I {gray.tfm,.\|.\|.} +The default fonts. +.TP +.I {gray.mf,.\|.\|.} +The \*(MF sources. +.\"===================================================================== +.SH "SEE ALSO" +.BR tex (1), +.BR mf (1). +.br +Donald E. Knuth, +.I "The \*(MFbook" +(Volume C of +.IR "Computers and Typesetting" ), +Addison-Wesley, 1986, ISBN 0-201-13445-4. +.br +Donald E. Knuth et al., +.IR \*(MFware . +.\"===================================================================== +.SH AUTHORS +Donald E. Knuth wrote the program. It was published as part of the +.I \*(MFware +technical report, available from the \*(TX Users Group. +Paul Richards ported it to Unix. diff --git a/Build/source/texk/web2c/man/gftopk.man b/Build/source/texk/web2c/man/gftopk.man new file mode 100644 index 00000000000..4ac55f79b67 --- /dev/null +++ b/Build/source/texk/web2c/man/gftopk.man @@ -0,0 +1,103 @@ +.TH GFTOPK 1 "14 December 1993" "Web2C @VERSION@" +.\"===================================================================== +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.\"===================================================================== +.SH NAME +gftopk \- convert generic font files to packed font files +.SH SYNOPSIS +.B gftopk +[ +.B \-v +] +.I gf_file_name +[ +.I pk_file_name +] +.\"===================================================================== +.SH DESCRIPTION +This manual page is not meant to be exhaustive. The complete +documentation for this version of \*(TX can be found in the info file +or manual +.IR "Web2C: A TeX implementation" . +.PP +The +.B gftopk +program converts a generic font file output by, for example, +.BR mf (1), +to a +packed font file for use by DVI-reading programs. Packed +font files +.RI ( pk " files)" +are much smaller than the corresponding +.I gf +files, +so they are generally the font format of choice. +.PP +The +.I gf_file_name +on the command line must be complete. Because +the resolution is part of the extension, it would not make +sense to append a default extension as is done with \*(TX or +DVI-reading software. The +.I pk_file_name +defaults to the same (stripped) name as +.IR gf_file_name , +and it is placed in the current +working directory with the +.I pk +suffix replacing +.IR gf . +For example, the input file +.I cmr10.300gf +would become +.IR cmr10.300pk . +.\"===================================================================== +.SH OPTIONS +Unless the +.B \-v +switch is given, +.B gftopk +operates silently. With +.BR \-v , +the version number of the program and statistics about the +packing are output to +.IR stdout . +.\"===================================================================== +.SH ENVIRONMENT +.B gftopk +looks for +.I gf_file_name +first in the current directory. If it is not present there, it uses the +environment variable GFFONTS. If that is not set, it uses the variable +TEXFONTS. If that is not set, it uses the system default. +.PP +See +.BR tex (1) +for the details of the searching. +.\"===================================================================== +.SH "SEE ALSO" +.BR gftype (1), +.BR pktogf (1), +.BR pktype (1). +.br +Donald E. Knuth et al., +.IR \*(MFware . +.\"===================================================================== +.SH AUTHORS +Tomas Rokicki wrote the program. It was published as +part of the +.I \*(MFware +technical report, available from the \*(TX Users Group. +Paul Richards originally ported it to Unix. diff --git a/Build/source/texk/web2c/man/gftype.man b/Build/source/texk/web2c/man/gftype.man new file mode 100644 index 00000000000..f88c5c08ebc --- /dev/null +++ b/Build/source/texk/web2c/man/gftype.man @@ -0,0 +1,97 @@ +.TH GFTYPE 1 "14 December 1993" "Web2C @VERSION@" +.\"===================================================================== +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.\"===================================================================== +.SH NAME +gftype \- translate a generic font file for humans to read +.SH SYNOPSIS +.B gftype +[ +.B \-i +] +[ +.B \-m +] +.I gf_file_name +[ +.I output_file_name +] +.\"===================================================================== +.SH DESCRIPTION +This manual page is not meant to be exhaustive. The complete +documentation for this version of \*(TX can be found in the info file +or manual +.IR "Web2C: A TeX implementation" . +.PP +The +.B gftype +program +translates a +.I gf +(generic font) file output by, for example, +.BR mf (1), +to a file that humans can read. +It also serves as a +.I gf +file-validating +program (i.e., if +.B gftype +can read it, it's correct) and as an example of a +.IR gf -reading +program for other software that wants to read +.I gf +files. +.PP +The +.I gf_file_name +on the command line must be complete. Because +the resolution is part of the extension, it would not make +sense to append a default extension as is done with \*(TX or +DVI-reading software. If no +.I output_file_name +is specified, the output goes to +.IR stdout . +.\"===================================================================== +.SH OPTIONS +The output file includes +bitmap images of the characters, if +.B \-i +is given on the command line, and a symbolic listing of the +.I gf +commands, if +.B \-m +is specified. +.\"===================================================================== +.SH ENVIRONMENT +.B gftype +looks for +.I gf_file_name +using the +environment variable GFFONTS. If that is not set, it uses the variable +TEXFONTS. If that is not set, it uses the system default. +.\"===================================================================== +.SH "SEE ALSO" +.BR dvitype (1), +.BR pktype (1). +.br +Donald E. Knuth et al., +.IR \*(MFware . +.\"===================================================================== +.SH AUTHORS +David Fuchs and Don Knuth wrote the program. It was published as +part of the +.I \*(MFware +technical report, available from the \*(TX Users Group. +Paul Richards originally ported it to Unix. diff --git a/Build/source/texk/web2c/man/initex.min b/Build/source/texk/web2c/man/initex.min new file mode 100644 index 00000000000..3fdff8763c0 --- /dev/null +++ b/Build/source/texk/web2c/man/initex.min @@ -0,0 +1,147 @@ +.TH INITEX 1 "27 December 1992" +.\"===================================================================== +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.\"===================================================================== +.SH NAME +initex \- initial TeX for making format (.fmt) files +.SH DESCRIPTION +.B initex +is a special version of the \*(TX program that has +no preloaded macro packages, but is capable of +converting a macro package into a special +preformatted binary file, called a +.I format +.RI ( .fmt ) +file. That format file can subsequently be read +at high speed by +.BR virtex . +.PP +Major macro packages may require \*(TX to process +many thousands of lines of macros, and open and +read scores of font files, all of which would +contribute to a sizable startup overhead if the +job had to be done every time \*(TX was run. +.B initex +allows \*(TX to do the job once, and then save the +results in a binary format file that can be later +loaded more rapidly by +.BR virtex . +.PP +.B initex +is normally required only at the time \*(TX is +installed, or whenever major macro packages are +updated. Thus, it will be rare for anyone but +system installers to invoke it. Nevertheless, it +is just a normal program without special +privileges, so ordinary users can use it to +prepare a private format file. +.PP +Here is how you can ask +.B initex +to prepare format files for several major +packages: +.PP +For plain +.BR tex : +.RS +.nf +.I "initex 'plain \\\\dump'" +.I "mv plain.fmt tex.fmt" +.fi +The single quotes are necessary to protect +the backslash from interpretation as a Unix shell +escape character. +.RE +.PP +For +.BR amstex : +.RS +.nf +.I "initex '&tex amstex \\\\dump'" +.fi +The single quotes around the first argument +protect the ampersand from interpretation as a +Unix shell background request. +.RE +.PP +For +.BR etex : +.RS +.nf +.I "initex '&tex eplain \\\\dump'" +.I "mv eplain.fmt etex.fmt" +.fi +.RE +.PP +For +.BR lamstex : +.RS +.nf +.I "initex '&tex amstexl \\\\input lamstex \\\\dump'" +.I "mv amstexl.fmt lamstex.fmt" +.fi +.RE +.PP +For +.BR latex : +.RS +.nf +.I "initex 'lplain \\\\dump'" +.I "mv lplain.fmt latex.fmt" +.fi +.RE +.PP +For +.BR slitex : +.RS +.nf +.I "initex 'splain \\\\dump'" +.I "mv splain.fmt slitex.fmt" +.fi +.RE +.PP +For +.BR texinfo : +.RS +.nf +.I "initex '&tex texinfo @dump'" +.fi +The last argument is different from the previous +examples because +.B texinfo +redefines the \*(TX escape character from +backslash to at-sign. As for +.BR amstex , +the file +.I tex.fmt +must already be available. +.RE +.PP +Note that several of these require that the format file for plain +\*(TX be available, since the first argument word +.I &tex +asks for the loading of the file +.IR tex.fmt . +.PP +It does not matter whether the command-line arguments are passed as a +single argument, or as separate arguments, since \*(TX reconstructs +the command line anyway. +.\"===================================================================== +.SH "SEE ALSO" +.BR amslatex (1), +.BR amstex (1), +.BR lamstex (1), +.BR latex (1), +.BR slitex (1), +.BR tex (1), +.BR virtex (1). diff --git a/Build/source/texk/web2c/man/lamstex.min b/Build/source/texk/web2c/man/lamstex.min new file mode 100644 index 00000000000..59abcb4747c --- /dev/null +++ b/Build/source/texk/web2c/man/lamstex.min @@ -0,0 +1,67 @@ +.TH LAMSTEX 1 "27 December 1992" +.\"===================================================================== +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.if t .ds AX \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(TX +.if n .ds AX AmSTeX +.if t .ds AY \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(LX +.if n .ds AY AmSLaTeX +.if t .ds LZ \ +\fRL\ +\\h'-0.3m'\\v'-0.21v'\s-2A\s0\\v'0.21v'\ +\\h'-0.15m'\\v'0.188v'M\\v'-0.188v'\ +\\h'-0.125m'S\ +\fP-\*(TX +.if n .ds LZ LAmS-TeX +.if t .ds OZ \ +\fIL\ +\\h'-0.3m'\\v'-0.21v'\s-2A\s0\\v'0.21v'\ +\\h'-0.15m'\\v'0.188v'M\\v'-0.188v'\ +\\h'-0.125m'S\ +\fP-\*(OX +.if n .ds OZ LAmS-TeX +.\"===================================================================== +.SH NAME +lamstex \- structured text formatting and typesetting +.SH SYNOPSIS +.B lamstex +[ first-line ] +.\"===================================================================== +.SH DESCRIPTION +The \*(LZ language is described in the book +.IR "\*(OZ: The Synthesis" . +\*(LZ is a new system that augments \*(AX with \*(LX-like features, +but retains the syntactical flavor of \*(AX. It can be compared with +\*(AY, which augments \*(LX with \*(AX-like features. +.PP +\*(LZ is a \*(TX macro package, not a modification to the \*(TX source +program, so all the capabilities described in +.BR tex (1) +are present. +.PP +The \*(LZ macros encourage writers to think about the content of their +documents, rather than the form. The ideal, not always realized, is to +have no formatting commands (like ``switch to italic'' or ``skip 2 +picas'') in the document at all; instead, everything is done +by specific markup instructions: ``emphasize'', ``start a section''. +.\"===================================================================== +.SH "SEE ALSO" +.BR amslatex (1), +.BR amstex (1), +.BR latex (1), +.BR tex (1), +.BR slitex (1). +.br +Michael Spivak, +.IR "\*(OZ: The Synthesis" , +The \*(TXplorators Corporation, 3701 W. Alabama, Suite 450-273, +Houston, TX 77027, USA, 1989. diff --git a/Build/source/texk/web2c/man/latex.man b/Build/source/texk/web2c/man/latex.man new file mode 100644 index 00000000000..73f4b5ad9e5 --- /dev/null +++ b/Build/source/texk/web2c/man/latex.man @@ -0,0 +1,70 @@ +.TH LATEX 1 "29 March 1999" "Web2C @VERSION@" +.\"===================================================================== +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP\" for troff +.el .ds OX TeX\" for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.\"===================================================================== +.SH NAME +latex, elatex, lambda, pdflatex \- structured text formatting and typesetting +.SH SYNOPSIS +.B latex +[ first line ] +.\"===================================================================== +.SH DESCRIPTION +This manual page is not meant to be exhaustive. The complete +documentation for this version of \*(TX can be found in the info file +or manual +.IR "Web2C: A TeX implementation" . +.PP +The \*(LX language is described in the book +.IR "\*(LX \- A Document Preparation System" . +\*(LX is a \*(TX macro package, not a modification to the \*(TX source +program, so all the capabilities described in +.BR tex (1) +are present. +.PP +The \*(LX macros encourage writers to think about the content of their +documents, rather than the form. The ideal, very difficult to realize, is to +have no formatting commands (like ``switch to italic'' or ``skip 2 +picas'') in the document at all; instead, everything is done +by specific markup instructions: ``emphasize'', ``start a section''. +.PP +The primary source of documentation for \*(LX is the \*(LX manual +referenced below, and the local guide in the file +.I local-guide.tex +or +.I local.tex +or some such. +.PP +.B elatex +is the e-\*(TX extended mode version of \*(LX format. +.PP +.B lambda +is the Omega version of the \*(LX format. +.PP +.B pdflatex +is the pdf\*(TX version of the \*(LX format. +.PP +On some systems +.B latex209 +and +.B slitex +are available for compatibility with older versions of \*(LX. These +should not be used for new texts. +.\"===================================================================== +.SH "SEE ALSO" +.BR amslatex (1), +.BR amstex (1), +.BR tex (1), +.br +Leslie Lamport, +.IR "\*(LX \- A Document Preparation System" , +Addison-Wesley, 1985, ISBN 0-201-15790-X. diff --git a/Build/source/texk/web2c/man/makempx.man b/Build/source/texk/web2c/man/makempx.man new file mode 100644 index 00000000000..193d6c42736 --- /dev/null +++ b/Build/source/texk/web2c/man/makempx.man @@ -0,0 +1,89 @@ +.TH MAKEMPX 1 "4 January 1998" "Web2C @VERSION@" +.\"===================================================================== +.if n .ds MP MetaPost +.if t .ds MP MetaPost +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.\"===================================================================== +.SH NAME +makempx \- typeset labels in MetaPost pictures with TeX or Troff +.SH SYNOPSIS +.B makempx +.RI [ --tex | --troff ] +.I mpfile mpxfile +.\"===================================================================== +.SH DESCRIPTION +This manual page is not meant to be exhaustive. The complete +documentation for this version of \*(TX can be found in the info file +or manual +.IR "Web2C: A TeX implementation" . +.PP +If +.I mpxfile +is older than +.IR mpfile , +translate the labels from the \*(MP input file +.I mpfile +to low-level commands in +.IR MPXFILE , +by running +.BR "mpto -tex" , +.BR tex , +and +.B dvitomp +by default; or, if +.B -troff +is specified, +.BR "mpto -troff" , +.BR "eqn -d\e$\e$ | troff -Tpost" , +and +.BR dmp . +.PP +The current directory is used for writing temporary files. Errors are +left in +.IR mpxerr.{tex,log,dvi} . +.PP +If the file named in +.I $MPTEXPRE +(mptexpre.tex by default) exists, it is prepended to the output in tex +mode. +.PP +.B makempx +is typically called by +.BR mpost , +not from the command line. +.\"===================================================================== +.SH OPTIONS +.B makempx +accepts the following options: +.TP +.B --help +.rb +Print help message and exit. +.TP +.B --tex +.rb +Assume input file contains \*(TX commands. +.TP +.B --troff +.rb +Assume input file contains Troff commands. +.TP +.B --version +.rb +Print version information and exit. +.\"===================================================================== +.SH "SEE ALSO" +.BR mpost (1), +.BR mpto (1). diff --git a/Build/source/texk/web2c/man/mf.man b/Build/source/texk/web2c/man/mf.man new file mode 100644 index 00000000000..f535a37252c --- /dev/null +++ b/Build/source/texk/web2c/man/mf.man @@ -0,0 +1,501 @@ +.\" t +.TH MF 1 "10 November 2001" "Web2C @VERSION@" +.\"===================================================================== +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.if n .ds WB Web +.if t .ds WB W\s-2EB\s0 +.\"===================================================================== +.SH NAME +mf, mf-nowin, inimf, virmf \- Metafont, a language for font and logo design +.SH SYNOPSIS +.B mf +.RI [ options ] +.RI [ commands ] +.\"===================================================================== +.SH DESCRIPTION +\*(MF reads the program in the specified files +and outputs font rasters (in +.I gf +format) and font metrics (in +.I tfm +format). The \*(MF +language is described in +.IR "The \*(MF\^book" . +.PP +Like +\*(TX, \*(MF +is normally used with a large body of precompiled macros, and font generation +in particular requires the support of several macro files. This +version of \*(MF looks at its command line to see what name it was +called under. Both +.B inimf +and +.B virmf +are symlinks to the +.B mf +executable. When called as +.BR inimf +(or when the +.B -ini +option is given) it can be used to precompile macros into a +.I .base +file. When called as +.B virmf +it will use the +.I plain +base. When called under any other name, \*(MF will use that name as +the name of the base to use. For example, when called as +.B mf +the +.I mf +base is used, which is identical to the +.I plain +base. Other bases than +.I plain +are rarely used. +.PP +The +.I commands +given on the command line to the \*(MF program are passed to it as the +first input line. (But it is often easier to type extended arguments +as the first input line, since UNIX shells tend to gobble up or +misinterpret \*(MF's favorite symbols, like semicolons, unless you +quote them.) As described in +.IR "The \*(MF\^book" , +that first line should begin with a filename, a +.RI \e controlsequence , +or a +.IR &basename . +.PP +The normal usage is to say +.IP +\fBmf\ \fP '\\\|mode=<printengine>\^;\^ [\^mag=magstep(\fI\^n\fP\^)\^;\^]' input\ \^\fI font \fP +.PP +to start processing +.IR font.mf . +The single quotes are the best way of keeping the Unix +shell from misinterpreting the semicolons and +from removing the \\ character, which is needed here to +keep \*(MF from thinking that you want to produce a font called +.IR mode . +(Or you can just say +.I mf +and give the other stuff on the next line, without quotes.) Other +control sequences, such as +.I batchmode +(for silent operation) can also appear. +The name +.I font +will be the ``jobname'', and is used in forming +output file names. +If \*(MF doesn't get a file name in the first line, +the jobname is +.IR mfput . +The default extension, +.IR .mf , +can be overridden by specifying an extension explicitly. +.PP +A log of error messages goes into the file \fIjobname\fP\fB\^.\^\fP\fIlog\fP. +The output files are \fIjobname\fP\fB\^.\^\fP\fItfm\fP and +\fIjobname\fP\fB\^.\^\fP\fI<\fP\^number\^\fI>gf\fP, where <number> depends on +the resolution and magnification of the font. The +.I mode +in this +example is shown generically as <printengine>, a symbolic term for which +the name of an actual device or, most commonly, the name +.I localfont +(see below) must +be substituted. If the mode is not specified or is not valid for your +site, \*(MF will default to +.I proof +mode which produces +large character images for use in font design and refinement. Proof +mode can be recognized by the suffix +.I .2602gf +after the jobname. Examples of proof mode output can be found +in +.I "Computer Modern Typefaces" +(Volume E of +.IR "Computers and Typesetting" ). +The system of +.I magsteps +is identical to the system used by +\*(TX, +with values generally in the range 0.5, 1.0, 2.0, 3.0, 4.0 and 5.0. +A listing of +.I gf +numbers for 118-dpi, 240-dpi and 300-dpi fonts +is shown below. +.TS +tab(:); +c c c c +l l l l. +MAGSTEP:118 dpi:240 dpi:300 dpi +mag=magstep(0):118:240:300 +mag=magstep(0.5):129:263:329 +mag=magstep(1):142:288:360 +mag=magstep(2):170:346:432 +mag=magstep(3):204:415:518 +mag=magstep(4):245:498:622 +mag=magstep(5):294:597:746 +.TE +.PP +Magnification can also be specified not as a magstep but as an +arbitrary value, such as 1.315, to create special character sizes. +.PP +Before font production can begin, it is necessary to set up the +appropriate base files. The minimum set of components for font +production for a given print-engine is the +.I plain.mf +macro file +and the local +.I mode_def +file. The macros in +.I plain.mf +can be +studied in an appendix to the +.IR "\*(MF\^book" ; +they were developed by Donald E. Knuth, and this file should never be +altered except when it is officially upgraded. +Each +.I mode_def +specification helps adapt fonts to a particular print-engine. +There is a regular discussion of +.IR mode_def s +in +.IR TUGboat , +the journal of the +\*(TX +Users Group. +The local ones in use on this computer should be in +.IR modes.mf . +.PP +The +.I e +response to \*(MF\|'s error-recovery mode invokes the +system default +editor at the erroneous line of the source file. +There is an environment variable, MFEDIT, +that overrides the default editor. +It should contain a string with "%s" indicating where the +filename goes and "%d" indicating where the decimal linenumber (if any) goes. +For example, an MFEDIT string for the +.B vi +editor can be set with the +.B csh +command +.RS +\fIsetenv MFEDIT "vi +%d %s"\fP +.RE +.PP +A convenient file in the library is +.IR null.mf , +containing nothing. +When +.B mf +can't find the file it thinks you want to input, it keeps +asking you for another file name; responding `null' gets you out +of the loop if you don't want to input anything. +.\"===================================================================== +.SH "ONLINE GRAPHICS OUTPUT" +\*(MF can use most modern displays, so you can see its output +without printing. Chapter 23 of +.I "The \*(MF\^book" +describes what you can do. This implementation of \*(MF uses +environment variables to determine which display device you want to use. +First it looks for a variable MFTERM, and then for TERM. +If it can't find either, you get no online output. Otherwise, the value +of the variable determines the device to use: +.BR hp2627 , +.B sun +(for old SunView), +.BR tek , +.B uniterm +(for an Atari ST Tek 4014 emulator), +.B xterm +(for either X10 or X11). +Some of these devices may not be supported in all \*(MF +executables; the choice is made at compilation time. +.PP +On some systems, there are two \*(MF binaries, +.B mf +and +.BR mf-nowin . +On those systems the +.B mf +binary supports graphics, while the +.B mf-nowin +binary does not. The +.B mf-nowin +binary is used by scripts like +.B mktexpk +where graphics support is a nuisance rather than something helpful. +.\"===================================================================== +.SH OPTIONS +This version of \*(MF understands the following command line options. +.TP +.BI -base \ base +.rb +Use +.I base +as the name of the base to be used, instead of the name by which +\*(MF was called or a +.I %& +line. +.TP +.B -file-line-error +.rb +Print error messages in the form +.I file:line:error +which is similar to the way many compilers format them. +.TP +.B -no-file-line-error +.rb +Disable printing error messages in the +.I file:line:error +style. +.TP +.B -file-line-error-style +.rb +This is the old name of the +.B -file-line-error +option. +.TP +.B -halt-on-error +.rb +Exit with an error code when an error is encountered during processing. +.TP +.B -help +.rb +Print help message and exit. +.TP +.B -ini +.rb +Be +.BR inimf , +for dumping bases; this is implicitly true if the program is called +as +.BR inimf . +.TP +.BI -interaction \ mode +.rb +Sets the interaction mode. The mode can be one of +.IR batchmode , +.IR nonstopmode , +.IR scrollmode , +and +.IR errorstopmode . +The meaning of these modes is the same as that of the corresponding +commands. +.TP +.BI -jobname \ name +.rb +Use +.I name +for the job name, instead of deriving it from the name of the input file. +.TP +.BI -kpathsea-debug \ bitmask +.rb +Sets path searching debugging flags according to the bitmask. See the +.I Kpathsea +manual for details. +.TP +.BI -maketex \ fmt +.rb +Enable +.RI mktex fmt , +where +.I fmt +must be +.IR mf . +.TP +.BI -no-maketex \ fmt +.rb +Disable +.RI mktex fmt , +where +.I fmt +must be +.IR mf . +.TP +.BI -output-directory \ directory +.rb Write output files in +.I directory +instead of the current directory. Look up input files in +.I directory +first, the along the normal search path. +.TP +.B -parse-first-line +.rb +If the first line of the main input file begins with +.I %& +parse it to look for a dump name or a +.B -translate-file +option. +.TP +.B -no-parse-first-line +.rb +Disable parsing of the first line of the main input file. +.TP +.BI -progname \ name +.rb +Pretend to be program +.IR name . +This affects both the format used and the search paths. +.TP +.B -recorder +.rb +Enable the filename recorder. This leaves a trace of the files opened +for input and output in a file with extension +.IR .fls . +.TP +.BI -translate-file \ tcxname +.rb +Use the +.I tcxname +translation table. +.TP +.B -version +.rb +Print version information and exit. +.\"===================================================================== +.SH ENVIRONMENT +See the Kpathsearch library documentation (the `Path specifications' +node) for the details of how the environment variables are use when +searching. The +.B kpsewhich +utility can be used to query the values of the variables. +.PP +If the environment variable +TEXMFOUTPUT is set, \*(MF attempts to put its output +files in it, if they cannot be put in the current directory. Again, see +.BR tex (1). +.TP +MFINPUTS +Search path for +.I input +and +.I openin +files. +.TP +MFEDIT +Command template for switching to editor. +.TP +MFTERM +Determines the online graphics display. If MFTERM is not set, +and DISPLAY is set, the Metafont window support for X is used. +(DISPLAY must be set to a valid X server specification, as usual.) +If neither MFTERM nor DISPLAY is set, TERM is used to guess the window +support to use. +.\"===================================================================== +.SH "FONT UTILITIES" +A number of utility programs are available. +The following is a partial list of available utilities and their purpose. +Consult your local \*(MF guru for details. +.br +.TP \w'gftodvi'u+2n +.B gftopk +Takes a +.I gf +file and produces a more tightly packed +.I pk +font file. +.TP +.B gftodvi +Produces proof sheets for fonts. +.TP +.B gftype +Displays the contents of a +.I gf +file in mnemonics and/or images. +.TP +.B pktype +Mnemonically displays the contents of a +.I pk +file. +.TP +.B mft +Formats a source file as shown in +.IR "Computer Modern Typefaces" . +.\"===================================================================== +.SH "FILES" +.TP +.I "mf.pool" +Encoded text of \*(MF's messages. +.TP +.I *.base +Predigested \*(MF base files. +.TP +.I $TEXMFMAIN/metafont/base/plain.mf +The standard base. +.TP +.I $TEXMFMAIN/metafont/misc/modes.mf +The file of +.IR mode_def s +for your site's various printers +.\"===================================================================== +.SH NOTES +This manual page is not meant to be exhaustive. The complete +documentation for this version of \*(MF can be found in the info manual +.IR "Web2C: A TeX implementation" . +.\"===================================================================== +.SH BUGS +On January 4, 1986 the ``final'' bug in \*(MF was discovered +and removed. If an error still lurks in the code, Donald E. Knuth promises to +pay a finder's fee which doubles every year to the first person who finds +it. Happy hunting. +.\"===================================================================== +.SH "SUGGESTED READING" +Donald E. Knuth, +.I "The \*(MF\^book" +(Volume C of +.IR "Computers and Typesetting" ), +Addison-Wesley, 1986, ISBN 0-201-13445-4. +.br +Donald E. Knuth, +.I "\*(MF:\^ The Program" +(Volume D of +.IR "Computers and Typesetting" ), +Addison-Wesley, 1986, ISBN 0-201-13438-1. +.br +Donald E. Knuth, +.I Computer Modern Typefaces +(Volume E of +.IR "Computers and Typesetting" ), +Addison-Wesley, 1986, ISBN 0-201-13446-2. +.br +.I TUGboat +(the journal of the \*(TX Users Group). +.\"===================================================================== +.SH COMMENTS +Warning: ``Type design can be hazardous to your other interests. +Once you get hooked, you will develop intense feelings about letterforms; +the medium will intrude on the messages that you read. +And you will perpetually be thinking of improvements to the fonts that +you see everywhere, especially those of your own design.'' +.\"===================================================================== +.SH "SEE ALSO" +.BR gftopk (1), +.BR gftodvi (1), +.BR gftype (1), +.BR mft (1), +.BR pltotf (1), +.BR tftopl (1). +.\"===================================================================== +.SH AUTHORS +\*(MF was designed by Donald E. Knuth, who implemented it +using his \*(WB system for Pascal programs. It was originally +ported to Unix by Paul Richards at the University of Illinois at +Urbana-Champaign. This page was mostly written by Pierre MacKay. diff --git a/Build/source/texk/web2c/man/mft.man b/Build/source/texk/web2c/man/mft.man new file mode 100644 index 00000000000..cedecd79630 --- /dev/null +++ b/Build/source/texk/web2c/man/mft.man @@ -0,0 +1,134 @@ +.TH MFT 1 "14 December 1993" "Web2C @VERSION@" +.\"===================================================================== +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.\"===================================================================== +.SH NAME +mft \- translate Metafont code to TeX code for prettyprinting +.SH SYNOPSIS +.B mft +.I mf_file_name[.mf] +[ +[ +.B \-c +] +or +[ +.I change_file_name[.ch] +] +] +[ +[ +.B \-s +] +or +[ +.I style_file_name[.mft] +] +] +.\"===================================================================== +.SH DESCRIPTION +This manual page is not meant to be exhaustive. The complete +documentation for this version of \*(TX can be found in the info file +or manual +.IR "Web2C: A TeX implementation" . +.PP +The +.B mft +program creates a \*(TX file from a \*(MF program. +It takes appropriate care of typographic details like page +layout and the use of indentation, italics, boldface, etc., as illustrated +in the book +.IR "Computer Modern Typefaces" . +Special conventions in \*(MF comments allow you to control things that +would not otherwise come out right; section 1 of the MFT source program +in the +.I \*(MFware +report explains these rules. +.PP +The command line has one required file name and two optional file names. +The required +one is a \*(MF source file; there is also an optional change file +(which works just as the change files to +.BR tangle (1) +and +.BR weave (1) +do) +and an optional style file (which is prepended to everything). +.PP +A file name that doesn't contain a dot is always given an extension, +either +.I .mf +(\*(MF) or +.I .ch +(change) or +.I .mft +(style). If no style file is specified, the style file +.I plain.mft +is automatically used. The +.I change_file_name +is not searched for using any paths. The +.I .mf +file is searched for using the MFINPUTS environment variable if you +have set it, or else the system default. The style file is searched +for using the TEXINPUTS environment variable. See +.BR tex (1) +for the details of the searching. +.PP +The output \*(TX file name is formed by using +.I .tex +in place of the extension of +.IR mf_file_name . +.\"===================================================================== +.SH OPTIONS +Specify command-line options +.B \-c +to suppress the reading of a change file, and +.B \-s +to suppress the reading of a style file. +.\"===================================================================== +.SH FILES +.TP +.I mftmac.tex +\*(TX macros used by +.B mft +output. +.TP +.I plain.mft +Default style file. +.TP +.I cmbase.mft +Style file for Computer Modern. +.\"===================================================================== +.SH "SEE ALSO" +.BR mf (1), +.BR weave (1). +.br +Donald E. Knuth, +.I Computer Modern Typefaces +(Volume E of +.IR "Computers and Typesetting" ), +Addison-Wesley, 1986, ISBN 0-201-13446-2. +.br +Donald E. Knuth et al., +.IR \*(MFware . +.\"===================================================================== +.SH AUTHORS +Donald E. Knuth wrote the program, and he ported it to Unix with the help of +Pierre MacKay and the Unix port of +.B weave +by Howard Trickey and Pavel Curtis. +The program is published in the +.I \*(MFware +technical report, available from the \*(TX Users Group. diff --git a/Build/source/texk/web2c/man/mpost.man b/Build/source/texk/web2c/man/mpost.man new file mode 100644 index 00000000000..f47911c9297 --- /dev/null +++ b/Build/source/texk/web2c/man/mpost.man @@ -0,0 +1,478 @@ +.TH MPOST 1 "10 November 2001" "Web2C @VERSION@" +.\"===================================================================== +.if n .ds MP MetaPost +.if t .ds MP MetaPost +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.if n .ds WB Web +.if t .ds WB W\s-2EB\s0 +.\"===================================================================== +.SH NAME +mpost, inimpost, virmpost \- MetaPost, a system for drawing pictures +.SH SYNOPSIS +.B mpost +.RI [ options ] +.RI [ commands ] +.\"===================================================================== +.SH DESCRIPTION +\*(MP interprets the \*(MP language and produces PostScript +pictures. The \*(MP language is similar to Knuth's \*(MF +with additional features for including +.BR tex (1) +or +.BR troff (1) +commands and accessing features of PostScript not found in \*(MF. +.PP +Like \*(TX and \*(MF, \*(MP is normally used with a large body of +precompiled macros. This version of \*(MP looks at its command line +to see what name it was called under. Both +.B inimpost +and +.B virmpost +are symlinks to the +.B mpost +executable. When called as +.BR inimpost +(or when the +.B -ini +option is given) it can be used to precompile macros into a +.I .mem +file. When called as +.B virmpost +it will use the +.I plain +mem. When called under any other name, \*(MP will use that name as +the name of the mem to use. For example, when called as +.B mpost +the +.I mpost +mem is used, which is identical to the +.I plain +mem. Other mems than +.I plain +are rarely used. +.PP +The +.I commands +given on the command line to the \*(MP program are passed to it as the +first input line. (But it is often easier to type extended arguments +as the first input line, since UNIX shells tend to gobble up or +misinterpret \*(MP's favorite symbols, like semicolons, unless you +quote them.) The first line should begin with a filename, a +.RI \e controlsequence , +or a +.IR &memname . +.PP +The normal usage is to say +.I mpost figs +to process the file +.IR figs.mp . +The basename of +.I figs +becomes the ``jobname'', +and is used in forming output file names. If no file is named, the +jobname becomes +.IR mpout . +The default extension, +.IR .mp , +can be overridden by specifying an extension explicitly. +.PP +There is normally one output file for each picture generated, +and the output files are named \fIjobname\fP\fB\^.\^\fP\fInnn\fP, +where \fInnn\fP +is a number passed to the +.I beginfig +macro. The output file name +can also be \fIjobname\fP\fB\^.\^\fP\fIps\fP +if this number is negative. +.PP +The output files can be used as figures in a \*(TX document by including +.ce +.BI "\especial{psfile=" jobname.nnn } +in the \*(TX document. Alternatively, one can +.B \einput epsf.tex +and then use the macro +.ce +.BI "\eepsfbox{" jobname.nnn } +to produce a box of the appropriate size containing the figure. +.TP +.BI btex " TeX commands " etex +This causes +.I mpost +to generate a \*(MP picture expression that corresponds to the +\*(TX commands. If the \*(TX commands generate +more than one line of text, it must be in a +.I \evbox +or a minipage environment. +.TP +.BI verbatimtex " TeX commands " etex +This is ignored by +.I mpost +except that the \*(TX commands are passed on to \*(TX. When using \*(LX +instead of \*(TX the input file must start with a +.I verbatimtex +block that gives the +.I \edocumentstyle +and +.I "\ebegin{document}" +commands. You can use the `%&' construct in the first verbatimtex +block to ensure that the correct \*(TX format is used to process the +commands. +.PP +Since most \*(TX fonts have to be downloaded as bitmaps, the +.I btex +feature works best when the output of +.I mpost +is to be included in a \*(TX document so that +.BR dvips (1) +can download the fonts. For self-contained PostScript output that can be +used directly or included in a +.I troff +document, start your \*(MP input file with the command +.I "prologues:=1" +and stick to standard PostScript fonts. \*(TX and \*(MP use the names in the +third column of the file +.IR trfonts.map , +which can be found in the directories with support files for \*(MP. +.PP +\*(MP output can be included in a +.I troff +document via the +.I "-m pictures" +macro package. In this case +.I mpost +should be invoked with the +.B -T +flag so that the commands between +.I btex +and +.I etex +or between +.I verbatimtex +and +.I etex +are interpreted as +.I troff +instead of \*(TX. (This automatically sets +.I "prologues:=1" +). +.\"===================================================================== +.SH OPTIONS +This version of \*(MP understands the following command line options. +.TP +.B -file-line-error +.rb +Print error messages in the form +.I file:line:error +which is similar to the way many compilers format them. +.TP +.B -no-file-line-error +.rb +Disable printing error messages in the +.I file:line:error +style. +.TP +.B -file-line-error-style +.rb +This is the old name of the +.B -file-line-error +option. +.TP +.B -halt-on-error +.rb +Exit with an error code when an error is encountered during processing. +.TP +.B -help +.rb +Print help message and exit. +.TP +.B -ini +.rb +Be +.BR inimpost , +for dumping bases; this is implicitly true if the program is called +as +.BR inimpost . +.TP +.BI -interaction \ mode +.rb +Sets the interaction mode. The mode can be one of +.IR batchmode , +.IR nonstopmode , +.IR scrollmode , +and +.IR errorstopmode . +The meaning of these modes is the same as that of the corresponding +commands. +.TP +.BI -jobname \ name +.rb +Use +.I name +for the job name, instead of deriving it from the name of the input file. +.TP +.BI -kpathsea-debug \ bitmask +.rb +Sets path searching debugging flags according to the bitmask. See the +.I Kpathsea +manual for details. +.TP +.BI -mem \ mem +.rb +Use +.I mem +as the name of the mem to be used, instead of the name by which +\*(MP was called or a +.I %& +line. +.TP +.BI -output-directory \ directory +.rb Write output files in +.I directory +instead of the current directory. Look up input files in +.I directory +first, the along the normal search path. +.TP +.B -parse-first-line +.rb +If the first line of the main input file begins with +.I %& +parse it to look for a dump name or a +.B -translate-file +option. +.TP +.B -no-parse-first-line +.rb +Disable parsing of the first line of the main input file. +.TP +.BI -progname \ name +.rb +Pretend to be program +.IR name . +This affects both the format used and the search paths. +.TP +.B -recorder +.rb +Enable the filename recorder. This leaves a trace of the files opened +for input and output in a file with extension +.IR .fls . +.TP +.B -T +.rb +Produce TROFF output. +.TP +.BI -translate-file \ tcxname +.rb +Use the +.I tcxname +translation table. +.TP +.B -troff +.rb +As +.BR -T . +.TP +.B -version +.rb +Print version information and exit. +.\"===================================================================== +.SH ENVIRONMENT +See the Kpathsearch library documentation (the `Path specifications' +node) for the details of how the environment variables are use when +searching. The +.B kpsewhich +utility can be used to query the values of the variables. +.PP +If the environment variable +TEXMFOUTPUT is set, \*(MP attempts to put its output +files in it, if they cannot be put in the current directory. +.PP +Here is a list of the environment variables affect the behavior of +.IR mpost : +.TP +.TP +MPINPUTS +Search path for +.I input +files. +.TP +MFINPUTS +Auxiliary search path for +.I input +files with +.I .mf +extensions. +.TP +MPSUPPORT +Directory for various tables for handling included +.I tex +and +.IR troff . +.TP +MPXCOMMAND +The name of a shell script that converts embedded typesetting commands +to a form that \*(MP understands. Defaults: +.I makempx +for +.I tex +and +.I troffmpx +for +.IR troff . +.TP +TEX +The version of \*(TX \- or \*(LX \- to use when processing +.I btex +and +.I verbatimtex +commands. Default +.IR tex . +This version of \*(MP allows you to use a `%&format' line instead. +.TP +TROFF +The +.I troff +pipeline for +.I btex +and +.I verbatimtex +commands. Default +.I eqn -d\e$\e$ | troff +.TP +MPEDIT +A command template for invoking an editor. +.PP +A +.I .mem +file is a binary file that permits fast loading of macro packages. +.I mpost +reads the default +.I plain.mem +unless another +.I .mem +file is specified at the start of the first line with an +.I & +just before it. There is also an +.I mfplain.mem +that simulates plain \*(MF so that +.I mpost +can read +.I .mf +fonts. (Plain \*(MF is described in +.IR "The \*(MF\^book" ). +.PP +Experts can create +.I .mem +files be invoking +.I inimpost +and giving macro definitions followed by a +.I dump +command. +.PP +The \*(MP language is similar to \*(MF, but the manual +.I A User's Manual for \*(MP +assumes no knowledge of \*(MF. \*(MP does not have bitmap +output commands or \*(MF's online display mechanism. +.\"===================================================================== +.SH FILES +.TP +.I mpost.pool +Encoded text of \*(MP's messages. +.TP +.I *.mem +Predigested \*(MP mem files. +.TP +.I plain.mp +The standard mem file. +.TP +.I mfplain.mp +The \*(MF-compatible mem file. This is loaded when +.I virmp +is invoked via a symbolic link as +.IR mfmp . +.TP +.I $TEXMFMAIN/metapost/base/*.mp +The standard \*(MP macros included in the original distribution. +.TP +.I $TEXMFMAIN/metapost/support/* +Various tables for handling included +.I tex +and +.IR troff . +.TP +.I $TEXMFMAIN/metapost/support/trfonts.map +Table of corresponding font names for +.I troff +and PostScript. +.TP +.I psfonts.map +Table of corresponding font names for +.I tex +and PostScript. +.TP +.I $TEXMFMAIN/doc/metapost/examples.mp +The source file for a few sample figures +that are part of a \*(LX document +.I $TEXMFMAIN/doc/metapost/mpintro.tex +that describes the \*(MP system +in a little more detail. +.\"===================================================================== +.SH NOTES +This manual page is not meant to be exhaustive. The complete +documentation for this version of \*(MP can be found in the info manual +.IR "Web2C: A TeX implementation" . +.\"===================================================================== +.SH "SUGGESTED READING" +Donald E. Knuth, +.I "The \*(MF\^book" +(Volume C of +.IR "Computers and Typesetting" ), +Addison-Wesley, 1986, ISBN 0-201-13445-4. +.br +John D. Hobby, +.IR "A User's Manual for \*(MP" , +CSTR 162, AT&T Bell Labs, +.br +John D. Hobby, +.IR "Drawing Graphs with \*(MP" , +CSTR 164, AT&T Bell Labs, +.br +.I TUGboat +(the journal of the \*(TX Users Group). +.\"===================================================================== +.SH "SEE ALSO" +.BR tex (1), +.BR mf (1), +.BR dvips (1). +.\"===================================================================== +.SH AUTHORS +\*(MP was designed by John D. Hobby, incorporating algorithms from +\*(MF by Donald E. Knuth. It was originally implemented on Unix, +incorporating system-dependent routines from +.BR web2c , +while not relying on it except for the actual \*(WB-to-C translator. +.PP +Ulrik Vieth adapted \*(MP to take advantage of the advanced path +searching features in more recent versions of +.B web2c +and worked towards fully integrating \*(MP into the canonical Unix +\*(TX distribution. He also updated and extended this manual page. +.\"===================================================================== +.SH TRIVIA +Unlike \*(TX and \*(MF, \*(MP originally didn't use any fancy logo. +John Hobby says he prefers the spelling ``MetaPost'', yet Don Knuth +has updated the \*(MF +.I logo.mf +font to be able to typeset a proper \*(MP logo similar to the \*(MF +logo. Feel free to use whatever you think is more appropriate! diff --git a/Build/source/texk/web2c/man/mpto.man b/Build/source/texk/web2c/man/mpto.man new file mode 100644 index 00000000000..f5d99040a58 --- /dev/null +++ b/Build/source/texk/web2c/man/mpto.man @@ -0,0 +1,68 @@ +.TH MPTO 1 "4 January 1998" "Web2C @VERSION@" +.\"===================================================================== +.if n .ds MP MetaPost +.if t .ds MP MetaPost +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.\"===================================================================== +.SH NAME +mpto \- extract labels in MetaPost pictures for typesetting +.SH SYNOPSIS +.B mpto +.RI [ -tex | -troff ] +.I mpfile +.\"===================================================================== +.SH DESCRIPTION +This manual page is not meant to be exhaustive. The complete +documentation for this version of \*(TX can be found in the info file +or manual +.IR "Web2C: A TeX implementation" . +.PP +Strip +.I btex..etex +and +.I verbatimtex...etex +parts from \*(MP input file +.IR mpfile , +converting to either \*(TX or Troff (\*(TX by default). The generated +code is dumped on standard output. +.PP +.B mpto +is typically called by +.BR makempx , +not from the command line. +.\"===================================================================== +.SH OPTIONS +.B mpto +accepts the following options: +.TP +.B --help +.rb +Print help message and exit. +.TP +.B -tex +.rb +Assume input file contains \*(TX commands. +.TP +.B -troff +.rb +Assume input file contains Troff commands. +.TP +.B --version +.rb +Print version information and exit. +.\"===================================================================== +.SH "SEE ALSO" +.BR mpost (1), +.BR makempx (1). diff --git a/Build/source/texk/web2c/man/newer.man b/Build/source/texk/web2c/man/newer.man new file mode 100644 index 00000000000..f96a2f1ee94 --- /dev/null +++ b/Build/source/texk/web2c/man/newer.man @@ -0,0 +1,41 @@ +.TH NEWER 1 "21 June 2005" "Web2C @VERSION@" +.\"===================================================================== +.SH NAME +newer \- compare file modification times +.SH SYNOPSIS +.B newer +.RI [ option ] +.I src1 +[ +.I src2 ... srcN +] +.I target +.\"===================================================================== +.SH DESCRIPTION +Exit successfully if files +.I src1 ... srcN +exist and at least one of them is not older than +.IR target . +Also exit successfully if +.I target +doesn't exist. +.\"===================================================================== +.SH OPTIONS +.B newer +accepts the following options: +.TP +.B --help +.rb +Print help message and exit. +.TP +.B --quiet, -q +.rb +Do not print any output, including error messages. +.TP +.B --version +.rb +Print version information and exit. +.TP +.B --verbose, -v +.rb +List missing source files. This is the default. diff --git a/Build/source/texk/web2c/man/omega.man b/Build/source/texk/web2c/man/omega.man new file mode 100644 index 00000000000..e48e22a9a9f --- /dev/null +++ b/Build/source/texk/web2c/man/omega.man @@ -0,0 +1,292 @@ +.TH OMEGA 1 "27 December 1997" "Web2C @VERSION@" +.\"===================================================================== +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.if t .ds AX \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(TX +.if n .ds AX AmSTeX +.if t .ds AY \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(LX +.if n .ds AY AmSLaTeX +.\"===================================================================== +.SH NAME +omega, iniomega, viromega \- extended unicode TeX +.SH SYNOPSIS +.B omega +.RI [ options ] +[\fB&\fR \fIformat\fR ] +[ \fIfile\fR | \fB\e\fR \fIcommands\fR ] +.\"===================================================================== +.SH DESCRIPTION +Run the Omega typesetter on +.IR file , +usually creating +.IR file.dvi . +If the file argument has no extension, ".tex" will be appended to it. +Instead of a filename, a set of Omega commands can be given, the first +of which must start with a backslash. +With a +.BI & format +argument Omega uses a different set of precompiled commands, +contained in +.IR format.fmt ; +it is usually better to use the +.B -fmt +.I format +option instead. +.PP +Omega is a version of the \*(TX program modified for multilingual +typesetting. It uses unicode, and has additional primitives for +(among other things) bidirectional typesetting. +.PP +The +.B iniomega +and +.B viromega +commands are Omega's analogues to the +.B initex +and +.B virtex +commands. In this installation, they are symlinks to the +.B omega +executable. +.PP +Omega's command line options are similar to those of \*(TX. +.PP +Omega is experimental software. +.\"===================================================================== +.SH OPTIONS +This version of Omega understands the following command line options. +.TP +.BI --oft \ format +.rb +Use +.I format +as the name of the format to be used, instead of the name by which +Omega was called or a +.I %& +line. +.TP +.B -halt-on-error +.rb +Exit with an error code when an error is encountered during processing. +.TP +.B --help +.rb +Print help message and exit. +.TP +.B --ini +.rb +Be +.BR iniomega , +for dumping formats; this is implicitly true if the program is called +as +.BR iniomega . +.TP +.BI --interaction \ mode +.rb +Sets the interaction mode. The mode can be one of +.IR batchmode , +.IR nonstopmode , +.IR scrollmode , +and +.IR errorstopmode . +The meaning of these modes is the same as that of the corresponding +\ecommands. +.TP +.B --ipc +.rb +Send DVI output to a socket as well as the usual output file. Whether +this option is available is the choice of the installer. +.TP +.B --ipc-start +.rb +As +.BR --ipc , +and starts the server at the other end as well. Whether this option +is available is the choice of the installer. +.TP +.BI --kpathsea-debug \ bitmask +.rb +Sets path searching debugging flags according to the bitmask. See the +.I Kpathsea +manual for details. +.TP +.BI --maketex \ fmt +.rb +Enable +.RI mktex fmt , +where +.I fmt +must be one of +.I tex +or +.IR tfm . +.TP +.BI --no-maketex \ fmt +.rb +Disable +.RI mktex fmt , +where +.I fmt +must be one of +.I tex +or +.IR tfm . +.TP +.BI --output-comment \ string +.rb +Use +.I string +for the DVI file comment instead of the date. +.TP +.BI -output-directory \ directory +.rb Write output files in +.I directory +instead of the current directory. Look up input files in +.I directory +first, the along the normal search path. +.TP +.B --parse-first-line +.rb +If the first line of the main input file begins with +.I %& +parse it to look for a dump name. +.TP +.BI --progname \ name +.rb +Pretend to be program +.IR name . +This affects both the format used and the search paths. +.TP +.B --recorder +.rb +Enable the filename recorder. This leaves a trace of the files opened +for input and output in a file with extension +.IR .ofl . +(This option is always on.) +.TP +.B --shell-escape +.rb +Enable the +.BI \ewrite18{ command } +construct. The +.I command +can be any Bourne shell command. This construct is normally +disallowed for security reasons. +.TP +.B --version +.rb +Print version information and exit. +.\"===================================================================== +.SH ENVIRONMENT +See the Kpathsearch library documentation (the `Path specifications' +node) for precise details of how the environment variables are used. +The +.B kpsewhich +utility can be used to query the values of the variables. +.PP +One caveat: In most Omega formats, you cannot use ~ in a filename you +give directly to Omega, because ~ is an active character, and hence is +expanded, not taken as part of the filename. Other programs, such as +\*(MF, do not have this problem. +.PP +.TP +TEXMFOUTPUT +Normally, Omega puts its output files in the current directory. If +any output file cannot be opened there, it tries to open it in the +directory specified in the environment variable TEXMFOUTPUT. +There is no default value for that variable. For example, if you say +.I tex paper +and the current directory is not writable, if TEXMFOUTPUT has +the value +.IR /tmp , +Omega attempts to create +.I /tmp/paper.log +(and +.IR /tmp/paper.dvi , +if any output is produced.) +.TP +TEXINPUTS +Search path for +.I \einput +and +.I \eopenin +files. +This should probably start with ``.'', so +that user files are found before system files. An empty path +component will be replaced with the paths defined in the +.I texmf.cnf +file. For example, set TEXINPUTS to ".:/home/usr/tex:" to prepend the +current direcory and ``/home/user/tex'' to the standard search path. +.TP +TEXEDIT +Command template for switching to editor. The default, usually +.BR vi , +is set when Omega is compiled. +.\"===================================================================== +.SH FILES +The location of the files mentioned below varies from system to +system. Use the +.B kpsewhich +utility to find their locations. +.TP +.I omega.pool +Encoded text of Omega's messages. +.TP +.I *.oft +Predigested Omega format (.\|oft) files. +.br +.\"===================================================================== +.SH NOTES +This manual page is not meant to be exhaustive. The complete +documentation for this version of Omega can be found in the info +manual +.IR "Web2C: A TeX implementation" . +.\"===================================================================== +.SH BUGS +This version of Omega implements a number of optional extensions. +In fact, many of these extensions conflict to a greater or lesser +extent with the definition of Omega. When such extensions are +enabled, the banner printed when Omega starts is changed to print +.B Omegak +instead of +.BR Omega . +.PP +This version of Omega fails to trap arithmetic overflow when +dimensions are added or subtracted. Cases where this occurs are rare, +but when it does the generated +.I DVI +file will be invalid. +.PP +The +.I DVI +files produced by Omega may use extensions which make them incompatible +with most software designed to handle +.I DVI +files. In order to print or preview them, you should use +.B odvips +to generate a PostScript file. +.PP +Omega is experimental software, and if you are an active user it is +strongly recommended that you subscribe to the Omega mailing list. +Visit the Omega website +.B http://omega.cse.unsw.edu.au +for information on how to subscribe. +.\"===================================================================== +.SH "SEE ALSO" +.BR tex (1), +.BR mf (1), +.RB odvips (1), +.\"===================================================================== +.SH AUTHORS +The primary authors of Omega are John Plaice and Yannis Haralambous. diff --git a/Build/source/texk/web2c/man/patgen.man b/Build/source/texk/web2c/man/patgen.man new file mode 100644 index 00000000000..d32f56e37a3 --- /dev/null +++ b/Build/source/texk/web2c/man/patgen.man @@ -0,0 +1,170 @@ +.TH PATGEN 1 "23 August 2004" "Web2C @VERSION@" +.\"===================================================================== +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.\"===================================================================== +.SH NAME +patgen \- generate patterns for TeX hyphenation +.SH SYNOPSIS +.B patgen +.I dictionary_file pattern_file patout_file translate_file +.\"===================================================================== +.SH DESCRIPTION +This manual page is not meant to be exhaustive. The complete +documentation for this version of \*(TX can be found in the info file +or manual +.IR "Web2C: A TeX implementation" . +.PP +The +.B patgen +program reads the +.I dictionary_file +containing a list of hyphenated words and the +.I pattern_file +containing previously-generated patterns (if any) for a particular +language, and produces the +.I patout_file +with (previously- plus newly-generated) hyphenation patterns for that +language. The +.I translate_file +defines language specific values for the parameters +.IR left_hyphen_min " and " right_hyphen_min +used by \*(TX's hyphenation algorithm and the external representation +of the lower and upper case version(s) of all \`letters' of that +language. Further details of the pattern generation process such as +hyphenation levels and pattern lengths are requested interactively from +the user's terminal. Optionally +.B patgen +creates a new dictionary file +.BI pattmp. n +showing the good and bad hyphens found by the generated patterns, where +.I n +is the highest hypenation level. +.PP +The patterns generated by +.B patgen +can be read by +.B initex +for use in hyphenating words. For a (very) long example of +.IR patgen 's +output, see +.IR $TEXMFMAIN/tex/generic/hyphen/hyphen.tex , +which contains the patterns \*(TX uses for English. +At some sites, patterns for several other languages may be available, +and the local +.B tex +programs may have them preloaded; consult your +.I Local Guide +or your system administrator for details. +.PP +All filenames must be complete; no adding of default +extensions or path searching is done. +.\"===================================================================== +.SH FILE FORMATS +.TP \w'@@'u+2n +.B Letters +When +.B initex +digests hyphenation patterns, \*(TX first expands macros and the result +must entirely consist of digits (hyphenation levels), dots (\`.', edge +of a word), and letters. In pattern files for non-English languages +letters are often represented by macros or other expandable constructs. +For the purpose of +.B patgen +these are just character sequences, subject to the condition that no +such sequence is a prefix of another one. +.TP \w'@@'u+2n +.B Dictionary file +A dictionary file contains a weighted list of hyphenated words, one word +per line starting in column 1. A digit in column 1 indicates a global +word weight (initially =1) applicable to all following words up to the +next global word weight. A digit at some intercharacter position +indicates a weight for that position only. + +The hyphens in a word are indicated by \`-', \`*', or \`.' (or their +replacements as defined in the translate file) for hyphens yet to be +found, \`good' hyphens (correctly found by the patterns), and \`bad' +hyphens (erroneously found by the patterns) respectively; when reading a +dictionary file \`*' is treated like \`-' and \`.' is ignored. +.TP \w'@@'u+2n +.B Translate file +A translate file starts with a line containing the values of +.I left_hypen_min +in columns 1-2, +.I right_hyphen_min +in columns 3-4, and either a blank or the replacement for one of the +"hyphen" characters \`-', \`*', and \`.' in columns 5, 6, and 7. (Input +lines are padded with blanks as for many \*(TX related programs.) + +Each following line defines one \`letter': an arbitrary delimiter +character in column 1, followed by one or more external representations +of that character (first the \`lower' case one used for output), each +one terminated by the delimiter and the whole sequence terminated by +another delimiter. + +If the translate file is empty, the values +.IR left_hypen_min "=2, " right_hyphen_min "=3," +and the 26 lower case letters +.IR a ... z +with their upper case representations +.IR A ... Z +are assumed. +.TP \w'@@'u+2n +.B Terminal input +After reading the +.I translate_file +and any previously-generated patterns from +.IR pattern_file, +.B patgen +requests input from the user's terminal. + +First the integer values of +.IR hyph_start " and " hyph_finish , +the lowest and highest hyphenation level for which patterns are to be +generated. The value of +.I hyph_start +should be larger than any hyphenation level already present in +.IR pattern_file . + +Then, for each hyphenation level, the integer values of +.IR pat_start " and " pat_finish , +the smallest and largest pattern length to be analyzed, as well as +.IR "good weight" ", " "bad weight" ", and " threshold , +the weights for good and bad hyphens and a weight threshold for useful +patterns. + +Finally the decision (\`y' or \`Y' vs. anything else) whether or not to +produce a hypenated word list. +.\"===================================================================== +.SH FILES +.TP \w'@@'u+2n +.I $TEXMFMAIN/tex/generic/hyphen/hyphen.tex +Patterns for English. +.\"===================================================================== +.SH "SEE ALSO" +Frank Liang, +.IR "Word hy-phen-a-tion by com-puter" , +STAN-CS-83-977, +Stanford University Ph.D. thesis, 1983. +.br +Donald E. Knuth, +.IR "The \*(OXbook" , +Addison-Wesley, 1986, ISBN 0-201-13447-0, Appendix H. +.\"===================================================================== +.SH AUTHORS +Frank Liang wrote the first version of this program. Peter +Breitenlohner made a +substantial revision in 1991 for \*(TX 3. +The first version was published as the appendix to the +.I \*(OXware +technical report, available from the \*(TX Users Group. Howard Trickey +originally ported it to Unix. diff --git a/Build/source/texk/web2c/man/pdfetex.man b/Build/source/texk/web2c/man/pdfetex.man new file mode 100644 index 00000000000..653cab10cbd --- /dev/null +++ b/Build/source/texk/web2c/man/pdfetex.man @@ -0,0 +1,487 @@ +.TH PDFETEX 1 "21 August 2004" "Web2C @VERSION@" +.\"===================================================================== +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP\" for troff +.el .ds OX TeX\" for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.if t .ds AX \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(TX +.if n .ds AX AmSTeX +.if t .ds AY \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(LX +.if n .ds AY AmSLaTeX +.\"===================================================================== +.SH NAME +pdfetex, pdfeinitex, pdfevirtex \- PDF output from e-TeX +.SH SYNOPSIS +.B pdfetex +.RI [ options ] +[\fB&\fR \fIformat\fR ] +[ \fIfile\fR | \fB\e\fR \fIcommands\fR ] +.\"===================================================================== +.SH DESCRIPTION +Run the pdfe\*(TX typesetter on +.IR file , +usually creating +.IR file.pdf . +If the file argument has no extension, ".tex" will be appended to it. +Instead of a filename, a set of pdfe\*(TX commands can be given, the first +of which must start with a backslash. +With a +.BI & format +argument pdfe\*(TX uses a different set of precompiled commands, +contained in +.IR format.fmt ; +it is usually better to use the +.B -fmt +.I format +option instead. +.PP +pdfe\*(TX is a version of e-\*(TX that can create +.I PDF +files as well as +.I DVI +files. +.PP +In +.I DVI +mode, pdfe\*(TX can be used as a complete replacement of the e-\*(TX +engine. +.PP +The typical use of pdfe\*(TX is with a pregenerated formats for which +PDF output has been enabled. The +.B pdfetex +command uses the equivalent of the plain e-\*(TX format, and the +.B pdfelatex +command uses the equivalent of the e-\*(LX format. +To generate formats, use the +.B -ini +switch. +.PP +The +.B pdfeinitex +and +.B pdfevirtex +commands are pdfe\*(TX's analogues to the +.B einitex +and +.B evirtex +commands. In this installation, they are symbolic links to the +.B pdfetex +executable. These symbolic links may not exist at all. +.PP +In +.I PDF +mode, pdfe\*(TX can natively handle the +.IR PDF , +.IR JPG , +and +.I PNG +graphics formats. +pdfe\*(TX's handling of its command-line arguments is similar to that of +of the other \*(TX programs in the +.I web2c +implementation. +.\"===================================================================== +.SH OPTIONS +This version of pdfe\*(TX understands the following command line options. +.TP +.B -enc +.rb +Enable the enc\*(TX extensions. This option is only effective in +combination with +.BR -ini . +For documentation of the enc\*(TX extensions see +.BR http://www.olsak.net/enctex.html . +.TP +.B -etex +.rb +Enable the e-\*(TX extensions. This option is only effective in +combination with +.BR -ini . +.TP +.B -file-line-error +.rb +Print error messages in the form +.I file:line:error +which is similar to the way many compilers format them. +.TP +.B -no-file-line-error +.rb +Disable printing error messages in the +.I file:line:error +style. +.TP +.B -file-line-error-style +.rb +This is the old name of the +.B -file-line-error +option. +.TP +.BI -fmt \ format +.rb +Use +.I format +as the name of the format to be used, instead of the name by which +pdfe\*(TX was called or a +.I %& +line. +.TP +.B -halt-on-error +.rb +Exit with an error code when an error is encountered during processing. +.TP +.B -help +.rb +Print help message and exit. +.TP +.B -ini +.rb +Start in +.I INI +mode, which is used to dump formats. The +.I INI +mode can be used for typesetting, but no format is preloaded, and +basic initializations like setting catcodes may be required. +.TP +.BI -interaction \ mode +.rb +Sets the interaction mode. The mode can be either +.IR batchmode , +.IR nonstopmode , +.IR scrollmode , +and +.IR errorstopmode . +The meaning of these modes is the same as that of the corresponding +\ecommands. +.TP +.B -ipc +.rb +Send DVI or PDF output to a socket as well as the usual output file. +Whether this option is available is the choice of the installer. +.TP +.B -ipc-start +.rb +As +.BR -ipc , +and starts the server at the other end as well. Whether this option +is available is the choice of the installer. +.TP +.BI -jobname \ name +.rb +Use +.I name +for the job name, instead of deriving it from the name of the input file. +.TP +.BI -kpathsea-debug \ bitmask +.rb +Sets path searching debugging flags according to the bitmask. See the +.I Kpathsea +manual for details. +.TP +.BI -mktex \ fmt +.rb +Enable +.RI mktex fmt , +where +.I fmt +must be either +.I tex +or +.IR tfm . +.TP +.B -mltex +.rb +Enable ML\*(TX extensions. Only effective in combination with +.BR -ini . +.TP +.BI -no-mktex \ fmt +.rb +Disable +.RI mktex fmt , +where +.I fmt +must be either +.I tex +or +.IR tfm . +.TP +.BI -output-comment \ string +.rb +In +.I DVI +mode, use +.I string +for the +.I DVI +file comment instead of the date. This option is ignored +in +.I PDF +mode. +.TP +.BI -output-directory \ directory +.rb Write output files in +.I directory +instead of the current directory. Look up input files in +.I directory +first, the along the normal search path. +.TP +.BI -output-format \ format +.rb +Set the output format mode, where +.I format +must be either +.I pdf +or +.IR dvi . +This also influences the set of graphics formats understood by pdfe\*(TX. +.TP +.B -parse-first-line +.rb +If the first line of the main input file begins with +.I %& +parse it to look for a dump name or a +.B -translate-file +option. +.TP +.B -no-parse-first-line +.rb +Disable parsing of the first line of the main input file. +.TP +.BI -progname \ name +.rb +Pretend to be program +.IR name . +This affects both the format used and the search paths. +.TP +.B -recorder +.rb +Enable the filename recorder. +This leaves a trace of the files opened for input and output +in a file with extension +.IR .fls . +.TP +.B -shell-escape +.rb +Enable the +.BI \ewrite18{ command } +construct. The +.I command +can be any shell command. This construct is normally +disallowed for security reasons. +.TP +.B -no-shell-escape +.rb +Disable the +.BI \ewrite18{ command } +construct, even if it is enabled in the +.I texmf.cnf +file. +.TP +.B -src-specials +.rb +In +.I DVI +mode, insert source specials into the +.I DVI +file. +This option is ignored in +.I PDF +mode. +.TP +.BI -src-specials \ where +.rb +In +.I DVI +mode, insert source specials in certain placed of the +.I DVI +file. +.I where +is a comma-separated value list: +.IR cr , +.IR display , +.IR hbox , +.IR math , +.IR par , +.IR parent , +or +.IR vbox . +This option is ignored in +.I PDF +mode. +.TP +.BI -translate-file \ tcxname +.rb +Use the +.I tcxname +translation table to set the mapping of input characters and +re-mapping of output characters. +.TP +.BI -default-translate-file \ tcxname +.rb +Like +.B -translate-file +except that a +.I %& +line can overrule this setting. +.TP +.B -version +.rb +Print version information and exit. +.\"===================================================================== +.SH ENVIRONMENT +See the Kpathsearch library documentation (the `Path specifications' +node) for precise details of how the environment variables are used. +The +.B kpsewhich +utility can be used to query the values of the variables. +.PP +One caveat: In most pdfe\*(TX formats, you cannot use ~ in a filename you +give directly to pdfe\*(TX, because ~ is an active character, and hence is +expanded, not taken as part of the filename. Other programs, such as +\*(MF, do not have this problem. +.PP +.TP +TEXMFOUTPUT +Normally, pdfe\*(TX puts its output files in the current directory. If +any output file cannot be opened there, it tries to open it in the +directory specified in the environment variable TEXMFOUTPUT. +There is no default value for that variable. For example, if you say +.I pdfetex paper +and the current directory is not writable, if TEXMFOUTPUT has +the value +.IR /tmp , +pdfe\*(TX attempts to create +.I /tmp/paper.log +(and +.IR /tmp/paper.pdf , +if any output is produced.) +.TP +TEXINPUTS +Search path for +.I \einput +and +.I \eopenin +files. +This should probably start with ``.'', so +that user files are found before system files. An empty path +component will be replaced with the paths defined in the +.I texmf.cnf +file. For example, set TEXINPUTS to ".:/home/usr/tex:" to prepend the +current direcory and ``/home/user/tex'' to the standard search path. +.TP +TEXFORMATS +Search path for format files. +.TP +TEXPOOL +search path for +.B pdfetex +internal strings. +.TP +TEXEDIT +Command template for switching to editor. The default, usually +.BR vi , +is set when pdfe\*(TX is compiled. +.TP +TFMFONTS +Search path for font metric +.RI ( .tfm ) +files. +.\"===================================================================== +.SH FILES +The location of the files mentioned below varies from system to +system. Use the +.B kpsewhich +utility to find their locations. +.TP +.I pdfetex.pool +Text file containing pdfe\*(TX's internal strings. +.TP +.I pdftex.map +Filename mapping definitions. +.TP +.I *.tfm +Metric files for pdfe\*(TX's fonts. +.TP +.I *.fmt +Predigested pdfe\*(TX format (.\|fmt) files. +.br +.\"===================================================================== +.SH NOTES +This manual page is not meant to be exhaustive. The complete +documentation for this version of pdfe\*(TX can be found in the info +manual +.IR "Web2C: A TeX implementation" . +.\"===================================================================== +.SH BUGS +This version of pdfe\*(TX implements a number of optional extensions. +In fact, many of these extensions conflict to a greater or lesser +extent with the definition of pdfe\*(TX. When such extensions are +enabled, the banner printed when pdfe\*(TX starts is changed to print +.B pdfeTeXk +instead of +.BR pdfeTeX . +.PP +This version of pdfe\*(TX fails to trap arithmetic overflow when +dimensions are added or subtracted. Cases where this occurs are rare, +but when it does the generated +.I DVI +file will be invalid. Whether a generated +.I PDF +file would be usable is unknown. +.\"===================================================================== +.SH AVAILABILITY +pdfe\*(TX is available for a large variety of machine architectures +and operation systems. +pdfe\*(TX is part of all major \*(TX distributions. +.P +Information on how to get pdfe\*(TX and related information +is available at the +.BI "http://tug.org" \ TUG +website. +The most recent version of pdfe\*(TX is available for anonymous +ftp at the +.B http://www.pdftex.de/tex/pdftex/ +.IR "pdfe\*(TX development site" . +.P +The following pdfe\*(TX related mailing list is available: +.BR pdftex@tug.org . +This is a mailman list; +to subscribe send a message containing +.I subscribe +to +.BR pdftex-request@tug.org . +More about the list can be found at the +.B "http://tug.org/mailman/listinfo/pdftex" +.I mailing list +website. +.\"===================================================================== +.SH "SEE ALSO" +.BR tex (1), +.BR mf (1), +.BR etex (1), +.BR pdftex (1). +.\"===================================================================== +.SH AUTHORS +The primary authors of pdf\*(TX are Han The Thanh, Petr Sojka, and +Jiri Zlatuska. +.PP +\*(TX was designed by Donald E. Knuth, +who implemented it using his \*(WB system for Pascal programs. +It was ported to Unix at Stanford by Howard Trickey, and +at Cornell by Pavel Curtis. +The version now offered with the Unix \*(TX distribution is that +generated by the \*(WB to C system +.RB ( web2c ), +originally written by Tomas Rokicki and Tim Morgan. +.PP +The enc\*(TX extensions were written by Petr Olsak. diff --git a/Build/source/texk/web2c/man/pdftex.man b/Build/source/texk/web2c/man/pdftex.man new file mode 100644 index 00000000000..f8209fdeb2f --- /dev/null +++ b/Build/source/texk/web2c/man/pdftex.man @@ -0,0 +1,479 @@ +.TH PDFTEX 1 "25 March 2004" "Web2C @VERSION@" +.\"===================================================================== +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.if t .ds AX \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(TX +.if n .ds AX AmSTeX +.if t .ds AY \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(LX +.if n .ds AY AmSLaTeX +.\"===================================================================== +.SH NAME +pdftex, pdfinitex, pdfvirtex \- PDF output from TeX +.SH SYNOPSIS +.B pdftex +.RI [ options ] +[\fB&\fR \fIformat\fR ] +[ \fIfile\fR | \fB\e\fR \fIcommands\fR ] +.\"===================================================================== +.SH DESCRIPTION +Run the pdf\*(TX typesetter on +.IR file , +usually creating +.IR file.pdf . +If the file argument has no extension, ".tex" will be appended to it. +Instead of a filename, a set of pdf\*(TX commands can be given, the first +of which must start with a backslash. +With a +.BI & format +argument pdf\*(TX uses a different set of precompiled commands, +contained in +.IR format.fmt ; +it is usually better to use the +.B -fmt +.I format +option instead. +.PP +pdf\*(TX is a version of \*(TX that can create +.I PDF +files as well as +.I DVI +files. +.PP +In +.I DVI +mode, pdf\*(TX can be used as a complete replacement of the \*(TX +engine. +.PP +The typical use of pdf\*(TX is with a pregenerated formats for which +PDF output has been enabled. The +.B pdftex +command uses the equivalent of the plain \*(TX format, and the +.B pdflatex +command uses the equivalent of the \*(LX format. +To generate formats, use the +.B -ini +switch. +.PP +The +.B pdfinitex +and +.B pdfvirtex +commands are pdf\*(TX's analogues to the +.B initex +and +.B virtex +commands. In this installation, they are symbolic links to the +.B pdftex +executable. These symbolic links may not exist at all. +.PP +In +.I PDF +mode, pdf\*(TX can natively handle the +.IR PDF , +.IR JPG , +and +.I PNG +graphics formats. +pdf\*(TX's handling of its command-line arguments is similar to that of +of the other \*(TX programs in the +.I web2c +implementation. +.\"===================================================================== +.SH OPTIONS +This version of pdf\*(TX understands the following command line options. +.TP +.B -enc +.rb +Enable the enc\*(TX extensions. This option is only effective in +combination with +.BR -ini . +For documentation of the enc\*(TX extensions see +.BR http://www.olsak.net/enctex.html . +.TP +.B -file-line-error +.rb +Print error messages in the form +.I file:line:error +which is similar to the way many compilers format them. +.TP +.B -no-file-line-error +.rb +Disable printing error messages in the +.I file:line:error +style. +.TP +.B -file-line-error-style +.rb +This is the old name of the +.B -file-line-error +option. +.TP +.BI -fmt \ format +.rb +Use +.I format +as the name of the format to be used, instead of the name by which +pdf\*(TX was called or a +.I %& +line. +.TP +.B -halt-on-error +.rb +Exit with an error code when an error is encountered during processing. +.TP +.B -help +.rb +Print help message and exit. +.TP +.B -ini +.rb +Start in +.I INI +mode, which is used to dump formats. The +.I INI +mode can be used for typesetting, but no format is preloaded, and +basic initializations like setting catcodes may be required. +.TP +.BI -interaction \ mode +.rb +Sets the interaction mode. The mode can be either +.IR batchmode , +.IR nonstopmode , +.IR scrollmode , +and +.IR errorstopmode . +The meaning of these modes is the same as that of the corresponding +\ecommands. +.TP +.B -ipc +.rb +Send DVI or PDF output to a socket as well as the usual output file. +Whether this option is available is the choice of the installer. +.TP +.B -ipc-start +.rb +As +.BR -ipc , +and starts the server at the other end as well. Whether this option +is available is the choice of the installer. +.TP +.BI -jobname \ name +.rb +Use +.I name +for the job name, instead of deriving it from the name of the input file. +.TP +.BI -kpathsea-debug \ bitmask +.rb +Sets path searching debugging flags according to the bitmask. See the +.I Kpathsea +manual for details. +.TP +.BI -mktex \ fmt +.rb +Enable +.RI mktex fmt , +where +.I fmt +must be either +.I tex +or +.IR tfm . +.TP +.B -mltex +.rb +Enable ML\*(TX extensions. Only effective in combination with +.BR -ini . +.TP +.BI -no-mktex \ fmt +.rb +Disable +.RI mktex fmt , +where +.I fmt +must be either +.I tex +or +.IR tfm . +.TP +.BI -output-comment \ string +.rb +In +.I DVI +mode, use +.I string +for the +.I DVI +file comment instead of the date. This option is ignored +in +.I PDF +mode. +.TP +.BI -output-directory \ directory +.rb Write output files in +.I directory +instead of the current directory. Look up input files in +.I directory +first, the along the normal search path. +.TP +.BI -output-format \ format +.rb +Set the output format mode, where +.I format +must be either +.I pdf +or +.IR dvi . +This also influences the set of graphics formats understood by pdf\*(TX. +.TP +.B -parse-first-line +.rb +If the first line of the main input file begins with +.I %& +parse it to look for a dump name or a +.B -translate-file +option. +.TP +.B -no-parse-first-line +.rb +Disable parsing of the first line of the main input file. +.TP +.BI -progname \ name +.rb +Pretend to be program +.IR name . +This affects both the format used and the search paths. +.TP +.B -recorder +.rb +Enable the filename recorder. +This leaves a trace of the files opened for input and output +in a file with extension +.IR .fls . +.TP +.B -shell-escape +.rb +Enable the +.BI \ewrite18{ command } +construct. The +.I command +can be any shell command. This construct is normally +disallowed for security reasons. +.TP +.B -no-shell-escape +.rb +Disable the +.BI \ewrite18{ command } +construct, even if it is enabled in the +.I texmf.cnf +file. +.TP +.B -src-specials +.rb +In +.I DVI +mode, insert source specials into the +.I DVI +file. +This option is ignored in +.I PDF +mode. +.TP +.BI -src-specials \ where +.rb +In +.I DVI +mode, insert source specials in certain placed of the +.I DVI +file. +.I where +is a comma-separated value list: +.IR cr , +.IR display , +.IR hbox , +.IR math , +.IR par , +.IR parent , +or +.IR vbox . +This option is ignored in +.I PDF +mode. +.TP +.BI -translate-file \ tcxname +.rb +Use the +.I tcxname +translation table to set the mapping of input characters and +re-mapping of output characters. +.TP +.BI -default-translate-file \ tcxname +.rb +Like +.B -translate-file +except that a +.I %& +line can overrule this setting. +.TP +.B -version +.rb +Print version information and exit. +.\"===================================================================== +.SH ENVIRONMENT +See the Kpathsearch library documentation (the `Path specifications' +node) for precise details of how the environment variables are used. +The +.B kpsewhich +utility can be used to query the values of the variables. +.PP +One caveat: In most pdf\*(TX formats, you cannot use ~ in a filename you +give directly to pdf\*(TX, because ~ is an active character, and hence is +expanded, not taken as part of the filename. Other programs, such as +\*(MF, do not have this problem. +.PP +.TP +TEXMFOUTPUT +Normally, pdf\*(TX puts its output files in the current directory. If +any output file cannot be opened there, it tries to open it in the +directory specified in the environment variable TEXMFOUTPUT. +There is no default value for that variable. For example, if you say +.I pdftex paper +and the current directory is not writable, if TEXMFOUTPUT has +the value +.IR /tmp , +pdf\*(TX attempts to create +.I /tmp/paper.log +(and +.IR /tmp/paper.pdf , +if any output is produced.) +.TP +TEXINPUTS +Search path for +.I \einput +and +.I \eopenin +files. +This should probably start with ``.'', so +that user files are found before system files. An empty path +component will be replaced with the paths defined in the +.I texmf.cnf +file. For example, set TEXINPUTS to ".:/home/usr/tex:" to prepend the +current direcory and ``/home/user/tex'' to the standard search path. +.TP +TEXFORMATS +Search path for format files. +.TP +TEXPOOL +search path for +.B pdftex +internal strings. +.TP +TEXEDIT +Command template for switching to editor. The default, usually +.BR vi , +is set when pdf\*(TX is compiled. +.TP +TFMFONTS +Search path for font metric +.RI ( .tfm ) +files. +.\"===================================================================== +.SH FILES +The location of the files mentioned below varies from system to +system. Use the +.B kpsewhich +utility to find their locations. +.TP +.I pdftex.pool +Text file containing pdf\*(TX's internal strings. +.TP +.I pdftex.map +Filename mapping definitions. +.TP +.I *.tfm +Metric files for pdf\*(TX's fonts. +.TP +.I *.fmt +Predigested pdf\*(TX format (.\|fmt) files. +.br +.\"===================================================================== +.SH NOTES +This manual page is not meant to be exhaustive. The complete +documentation for this version of pdf\*(TX can be found in the info +manual +.IR "Web2C: A TeX implementation" . +.\"===================================================================== +.SH BUGS +This version of pdf\*(TX implements a number of optional extensions. +In fact, many of these extensions conflict to a greater or lesser +extent with the definition of pdf\*(TX. When such extensions are +enabled, the banner printed when pdf\*(TX starts is changed to print +.B pdfTeXk +instead of +.BR pdfTeX . +.PP +This version of pdf\*(TX fails to trap arithmetic overflow when +dimensions are added or subtracted. Cases where this occurs are rare, +but when it does the generated +.I DVI +file will be invalid. Whether a generated +.I PDF +file would be usable is unknown. +.\"===================================================================== +.SH AVAILABILITY +pdf\*(TX is available for a large variety of machine architectures +and operation systems. +pdf\*(TX is part of all major \*(TX distributions. +.P +Information on how to get pdfe\*(TX and related information +is available at the +.BI "http://tug.org" \ TUG +website. +The most recent version of pdf\*(TX is available for anonymous +ftp at the +.B http://www.pdftex.de/tex/pdftex/ +.IR "pdf\*(TX development site" . +.P +The following pdfe\*(TX related mailing list is available: +.BR pdftex@tug.org . +This is a mailman list; +to subscribe send a message containing +.I subscribe +to +.BR pdftex-request@tug.org . +More about the list can be found at the +.B "http://tug.org/mailman/listinfo/pdftex" +.I mailing list +website. +.\"===================================================================== +.SH "SEE ALSO" +.BR tex (1), +.BR mf (1). +.\"===================================================================== +.SH AUTHORS +The primary authors of pdf\*(TX are Han The Thanh, Petr Sojka, and +Jiri Zlatuska. +.PP +\*(TX was designed by Donald E. Knuth, +who implemented it using his \*(WB system for Pascal programs. +It was ported to Unix at Stanford by Howard Trickey, and +at Cornell by Pavel Curtis. +The version now offered with the Unix \*(TX distribution is that +generated by the \*(WB to C system +.RB ( web2c ), +originally written by Tomas Rokicki and Tim Morgan. +.PP +The enc\*(TX extensions were written by Petr Olsak. diff --git a/Build/source/texk/web2c/man/pdftexman.m4 b/Build/source/texk/web2c/man/pdftexman.m4 new file mode 100644 index 00000000000..c80e8a1c28e --- /dev/null +++ b/Build/source/texk/web2c/man/pdftexman.m4 @@ -0,0 +1,671 @@ +m4_divert(-1)m4_dnl +======================================================================= +$Id: //depot/Build/source.development/TeX/texk/web2c/man/pdftexman.m4#2 $ + +Common man page for pdftex and pdfetex, to be preprocessed by GNU m4: + +$ m4 -P -DOLD pdftexman.m4 > pdftex.man +$ m4 -P pdfetexman.m4 > pdfetex.man + +======================================================================= + +m4_define(`M_MANDATE', `23 March 2004') +m4_define(`M_WEB2CVERSION', `@VERSION@') + +m4_ifdef(`OLD', + ` + m4_define(`M_LTXPP', `\*(LX') + m4_define(`M_TEXPP', `\*(TX') + m4_define(`M_TEXP', `TeX') + m4_define(`M_TEX', `tex') + m4_define(`M_PDFTEX', `PDFTEX') + m4_define(`M_PDFENGINI', `pdfinitex') + m4_define(`M_PDFENGVIR', `pdfvirtex') + m4_define(`M_PDFENGPP', `pdf\*(TX') + m4_define(`M_PDFENGKP', `pdfTeXk') + m4_define(`M_PDFENGP', `pdfTeX') + m4_define(`M_PDFENG', `pdftex') + m4_define(`M_ENGINI', `initex') + m4_define(`M_ENGVIR', `virtex') + m4_define(`M_PDFLTX', `pdflatex') + m4_define(`M_FMT', `fmt') + ', ` + m4_define(`M_LTXPP', `e-\*(LX') + m4_define(`M_TEXPP', `e-\*(TX') + m4_define(`M_TEXP', `e-TeX') + m4_define(`M_TEX', `etex') + m4_define(`M_PDFTEX', `PDFETEX') + m4_define(`M_PDFENGINI', `pdfeinitex') + m4_define(`M_PDFENGVIR', `pdfevirtex') + m4_define(`M_PDFENGPP', `pdfe\*(TX') + m4_define(`M_PDFENGKP', `pdfeTeXk') + m4_define(`M_PDFENGP', `pdfeTeX') + m4_define(`M_PDFENG', `pdfetex') + m4_define(`M_ENGINI', `einitex') + m4_define(`M_ENGVIR', `evirtex') + m4_define(`M_PDFLTX', `pdfelatex') + m4_define(`M_FMT', `efmt') + ' +) +m4_divert`'m4_dnl +.TH M_PDFTEX 1 "M_MANDATE" "Web2C M_WEB2CVERSION" +.\"===================================================================== +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP\" for troff +.el .ds OX TeX\" for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.if t .ds AX \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(TX +.if n .ds AX AmSTeX +.if t .ds AY \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(LX +.if n .ds AY AmSLaTeX +.\"===================================================================== + +.SH NAME +M_PDFENG \- Direct PDF or DVI output from M_TEXP +.\"===================================================================== + +.SH SYNTAX +.B M_PDFENG +[\fIoption\fR] ... [\fItexname\fR[\fI.tex\fR]] ... [\fIcommands\fR] +.br +.B M_PDFENG +[\fIoption\fR] ... \e\fIfirst-line\fR +.br +.B M_PDFENG +[\fIoption\fR] ... &\fI`'M_FMT args\fR +.br +.B M_PDFENG \-\-version +.br +.B M_PDFENG \-\-help +.\"===================================================================== + +.SH USAGE +Run M_PDFENGPP on +.IR texname , +usually creating +.I texname.pdf +or +.IR texname.dvi . +Any remaining +.I commands +are processed as M_PDFENGPP input, after +.I texname +is read. +.P +If the first line of +.I texname +is +.IR "%&M_FMT" , +where +.I M_FMT +is an existing format +.RI ( .M_FMT ) +file, and if parsing of the first line is enabled, use this format. +Else use +.IR "name.M_FMT" , +where +.I name +is the program invocation name, most commonly M_PDFENG. +.P +Alternatively, if the first non-option argument begins with a backslash +.IR \e , +interpret all non-option arguments as a line of M_PDFENGPP input. +.P +Alternatively, if the first non-option argument begins with an ampersand +.IR & , +the next word is taken as the format +.I M_FMT +to read, overriding all else. +Any remaining arguments +.I args +are processed as above. +.P +If no arguments or options are specified, prompt for input. +.P +M_PDFENGPP's handling of its command line arguments is similar to +that of the other \*(TX programs in the +.I WEB2C +implementation. +.P +Non-alphanumeric characters on the command line +might need quoting, depending on the shell used. +.\"===================================================================== + +.SH DESCRIPTION +This manual page is not meant to be exhaustive. +The complete documentation for this version of a \*(TX engine +can be found in the manual +.IR "The pdfTeX user manual" +and in the info file or manual +.IR "Web2C: A TeX implementation" . +.P +M_PDFENGPP is a version of M_TEXPP that can create +.I PDF +files as well as +.I DVI +files. +In +.I DVI +mode, +M_PDFENGPP can be used as complete replacement for the M_TEXPP engine. +The selection of +.I PDF +or +.I DVI +mode is done by the +.B --output-format +option or by setting the +.BI \epdfoutput +register. +.P +The typical use of M_PDFENGPP is with a pregenerated format +for which PDF output has been enabled. +The +.B M_PDFENG +command uses the equivalent of the plain M_TEXPP format, and the +.B M_PDFLTX +command uses the equivalent of the M_LTXPP format. +.P +M_PDFENGPP can also be used for generating format +.RI ( .M_FMT ) +files by call +.BR "M_PDFENG --ini" . +This gives the same functionality as the former +.B M_PDFENGINI +command, which is considered as deprecated. +.\" The +.\" .B M_PDFENGINI +.\" and +.\" .B M_PDFENGVIR +.\" commands are M_PDFENGPP's analogues to the +.\" .B M_ENGINI +.\" and +.\" .B M_ENGVIR +.\" commands. In this installation, they are symlinks to the +.\" .B M_PDFENG +.\" executable. +.P +In +.I PDF +mode, M_PDFENGPP can natively handle graphics input formats +.IR PNG , +.IR JPEG , +and +.IR PDF . +m4_ifdef(`OLD', `m4_dnl +.P +Nowadays M_PDFENGPP usually is just a link to the pdfe\*(TX program. +', `')m4_dnl +.\"===================================================================== + +.SH OPTIONS +This version of M_PDFENGPP understands the following command line options, +which can be also given starting with a single dash. +m4_dnl------------------------------------------------------------------ +.TP +.BI --default-translate-file \ tcxname +.rb +Use the default translation table from file +.IR tcxname . +This option does not override a setting given in a +.I %& +line. +The +.BI --translate-file +can overwrite this setting. +m4_dnl------------------------------------------------------------------ +.TP +m4_ifdef(`OLD', `', `m4_dnl +.BI --M_FMT \ M_FMT +.rb +Use +.I M_FMT +as the name of the format to be used, instead of the name by which +M_PDFENGPP was called or a +.I %& +line. +m4_dnl------------------------------------------------------------------ +.TP +')m4_dnl +.B --enc +.rb +Enable enc\*(TX extension by Petr Olsak, see the file +.IR "encdoc-e.pdf" . +m4_dnl------------------------------------------------------------------ +.TP +.B --file-line-error-style +.rb +Print error messages in the form +.I file:line:error +which is similar to the way many compilers format them. +m4_dnl------------------------------------------------------------------ +.TP +m4_ifdef(`OLD', `m4_dnl +.BI --M_FMT \ M_FMT +.rb +Use +.I M_FMT +as the name of the format to be used, instead of the name by which +M_PDFENGPP was called or a +.I %& +line. +m4_dnl------------------------------------------------------------------ +.TP +', `')m4_dnl +.B --help +.rb +Print help message with list of command line options and exit. +m4_dnl------------------------------------------------------------------ +.TP +.B --ini +.rb +Start in +.I INI +mode, for dumping a format M_FMT. +The +.I INI +mode can als be used for general typesetting. +As no format is preloaded, +basic initializations like setting catcodes might be required. +\." ; this is implicitly true if the program is called +\." as +\." .BR M_PDFENGINI . +m4_dnl------------------------------------------------------------------ +.TP +.BI --interaction \ mode +.rb +Sets the interaction mode. The mode can be either +.IR batchmode , +.IR nonstopmode , +.IR scrollmode , +and +.IR errorstopmode . +The meaning of these modes is the same as that of the corresponding +\ecommands. +m4_dnl------------------------------------------------------------------ +.TP +.B --ipc +.rb +In +.I DVI mode, +send +.I DVI +output to a socket as well as the usual output file. +Whether this option is available is the choice of the installer. +This option is ignored in +.I PDF +mode. +m4_dnl------------------------------------------------------------------ +.TP +.B --ipc-start +.rb +In +.DVI +mode, works as +.BR --ipc , +and starts the server at the other end as well. +Whether this option is available is the choice of the installer. +This option is ignored in +.I PDF +mode. +m4_dnl------------------------------------------------------------------ +.TP +.BI --jobname \ name +.rb +Use +.I name +for the job name, instead of deriving it from the name of the input file. +m4_dnl------------------------------------------------------------------ +.TP +.BI --kpathsea-debug \ bitmask +.rb +Sets path searching debugging flags according to the bitmask. See the +.I Kpathsea +manual for details. +m4_dnl------------------------------------------------------------------ +.TP +.BI --mktex \ fmt +.rb +Enable +.RI mktex fmt , +where +.I fmt +must be either +.I tex +or +.IR tfm . +m4_dnl------------------------------------------------------------------ +.TP +.BI --mltex +.rb +Enable MLTeX extensions such as +.IR \echarsubdef . +m4_dnl------------------------------------------------------------------ +.TP +.BI --no-mktex \ fmt +.rb +Disable +.RI mktex fmt , +where +.I fmt +must be either +.I tex +or +.IR tfm . +m4_dnl------------------------------------------------------------------ +.TP +.BI --output-comment \ string +.rb +In +.I DVI +mode, use +.I string +for the DVI file comment instead of the date. +This option is ignored in +.I PDF +mode. +m4_dnl------------------------------------------------------------------ +.TP +.BI --output-format \ format +.rb +Set output format mode, +where +.I format +must be either +.I pdf +or +.IR dvi . +This option can be overridden by setting the +.BI \epdfoutput +register. +The output format mode also influences the set of graphics formats +understood by M_PDFENGPP. +m4_dnl------------------------------------------------------------------ +.TP +.B --parse-first-line +.rb +If the first line of the main input file begins with +.IR %& , +parse it to look for a dump name or a +.B --translate-file +option. +m4_dnl------------------------------------------------------------------ +.TP +.BI --progname \ name +.rb +Pretend to be program +.IR name . +This affects both the format used and the search paths. +.TP +.B --recorder +.rb +Enable the filename recorder. +This leaves a trace of the files opened for input and output +in a file with extension +.IR .fls . +m4_dnl------------------------------------------------------------------ +.TP +.B --shell-escape +.rb +Enable the +.BI \ewrite18{ command } +construct. The +.I command +can be any shell command. +This construct is often disallowed for security reasons. +m4_dnl------------------------------------------------------------------ +.TP +.B --src-specials +.rb +In +.I DVI +mode, insert source specials into the +.I DVI +file. +This option is ignored in +.I PDF +mode. +m4_dnl------------------------------------------------------------------ +.TP +.BI --src-specials \ where +.rb +In +.I DVI +mode, insert source specials in certain placed of the +.I DVI +file. +.I where +is a comma-separated value list: +.IR cr , +.IR display , +.IR hbox , +.IR math , +.IR par , +.IR parent , +or +.IR vbox . +This option is ignored in +.I PDF +mode. +m4_dnl------------------------------------------------------------------ +.TP +.BI --translate-file \ tcxname +.rb +Use the translation table in file +.I tcxname +for mapping of input characters +and re-mapping of output characters. +This option overrides a setting given in a +.I %& +line. +m4_dnl------------------------------------------------------------------ +.TP +.B --version +.rb +Print version and copyright information and exit. +.\"===================================================================== + +.SH ENVIRONMENT +See the +.I Kpathsea library +documentation, section ```Path searching''' +for precise details of how the environment variables are used. +The +.B kpsewhich +utility can be used to query the values of the variables. +.P +One caveat: +In most M_PDFENGPP formats, you cannot use ~ in a filename +you give directly to M_PDFENGPP, because ~ is an active character, +and hence is expanded, not taken as part of the filename. +Other programs, such as \*(MF, do not have this problem. +.P +.TP +TEXMFOUTPUT +Normally, M_PDFENGPP puts its output files in the current directory. +If any output file cannot be opened there, it tries to open it in the +directory specified in the environment variable TEXMFOUTPUT. +There is no default value for that variable. For example, if you say +.I M_PDFENG paper +and the current directory is not writable, if TEXMFOUTPUT has +the value +.IR /tmp , +M_PDFENGPP attempts to create +.I /tmp/paper.log +(and +.IR /tmp/paper.pdf , +if any output is produced.) +.TP +TEXINPUTS +Search path for files read in by +.I \einput +and +.I \eopenin +commands, +as well as for graphics files. +This should probably start with ```.''', so +that user files are found before system files. An empty path +component will be replaced with the paths defined in the +.I texmf.cnf +file. For example, set TEXINPUTS to ".:/home/usr/tex:" to prepend the +current direcory and ```/home/user/tex''' to the standard search path. +.TP +TEXFORMATS +Search path for format +.RI ( .M_FMT ) +files. +.TP +TEXPOOL +Search path for string pool +.RI ( .pool ) +files. +.TP +ENCFONTS +Search path for font encoding +.RI ( .enc ) +files. +.TP +TEXFONTMAPS +Search path for font mapping +.RI ( .map ) +files. +.TP +TFMFONTS +Search path for font metric +.RI ( .tfm ) +files. +.TP +VFFONTS +Search path for virtual font +.RI ( .vf ) +files. +.TP +T1FONTS +Search path for Type 1 font files +.RI ( .pfa ) +and +.RI ( .pfb ")." +.TP +TTFONTS +Search path for True-Type font +.RI ( .ttf ) +files. +.TP +PKFONTS +Search path for pixel font +.RI ( .pk ) +files. +.TP +TEXEDIT +Command template for switching to editor. The default, usually +.BR vi , +is set when M_PDFENGPP is compiled. +.\"===================================================================== + +.SH FILES +The location of the files mentioned below varies from system to +system. Use the +.B kpsewhich +utility to find their locations. +.TP +.I texmf.cnf +Configuration file with default settings for M_PDFENGPP as well +as for other \*(TX and \*(MF related programs and utilities. +.TP +.I *.M_FMT +Predigested M_PDFENGPP format files. +.TP +.I *.pool +String pool files. +.TP +.I *.enc +Font encoding files. +.TP +.I *.map +Text files containing font mapping definitions +between TFM entries and font files. +The default file is +.IR pdftex.map . +.TP +.I *.tfm +Font metric files. +.TP +.I *.vf +Virtual font files. +.TP +.IR *.pfa , \ *.pfb +Type 1 font files (ASCII and binary format). +.TP +.I *.ttf +True-Type font files. +.TP +.I *.pk +Pixel font files. +.TP +.I *.tcx +Character translation table files. +.\"===================================================================== + +.SH BUGS +This version of M_PDFENGPP implements a number of optional extensions. +In fact, many of these extensions conflict to a greater or lesser +extent with the definition of M_PDFENGPP. When such extensions are +enabled, the banner printed when M_PDFENGPP starts is changed to print +.B M_PDFENGKP +instead of +.BR M_PDFENGP . +.P +This version of M_PDFENGPP fails to trap arithmetic overflow when +dimensions are added or subtracted. Cases where this occurs are rare, +but when it does the generated +.I DVI +file will be invalid. Whether a generated +.I PDF +file would be usable is unknown. +\." .P +.\"===================================================================== + +.SH AVAILABILITY +M_PDFENGPP is available for a large variety of machine architectures +and operation systems. +M_PDFENGPP is part of all major \*(TX distributions. +.P +Information on how to get M_PDFENGPP and related information +is available at the +.BI "http://www.pdftex.org" \ pdf\*(TX +website. +.P +The following M_PDFENGPP related mailing list is available: +.BR "pdftex@tug.org" . +This is a mailman list; +to subscribe, send a message with the subject +.I subscribe +to +.BR pdftex-request@tug.org . +More about the list can be found at the +.B "http://tug.org/mailman/listinfo/pdftex" +.I mailing list +website. +.\"===================================================================== + +.SH "SEE ALSO" +.BR tex (1), +m4_ifdef(`OLD',m4_dnl +`.BR mf (1).',m4_dnl +`.BR mf (1), +.BR etex (1).') +.\"===================================================================== + +.SH AUTHORS +The authors of M_PDFENGPP are Han The Thanh and the pdf\*(TX team. diff --git a/Build/source/texk/web2c/man/pdfxtex.man b/Build/source/texk/web2c/man/pdfxtex.man new file mode 100644 index 00000000000..edbfff44aa6 --- /dev/null +++ b/Build/source/texk/web2c/man/pdfxtex.man @@ -0,0 +1,481 @@ +.TH PDFXTEX 1 "25 March 2004" "Web2C @VERSION@" +.\"===================================================================== +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.if t .ds AX \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(TX +.if n .ds AX AmSTeX +.if t .ds AY \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(LX +.if n .ds AY AmSLaTeX +.\"===================================================================== +.SH NAME +pdfxtex, pdfxinitex, pdfxvirtex \- PDF output from e-TeX +.SH SYNOPSIS +.B pdfxtex +.RI [ options ] +[\fB&\fR \fIformat\fR ] +[ \fIfile\fR | \fB\e\fR \fIcommands\fR ] +.\"===================================================================== +.SH DESCRIPTION +Run the pdfx\*(TX typesetter on +.IR file , +usually creating +.IR file.pdf . +If the file argument has no extension, ".tex" will be appended to it. +Instead of a filename, a set of pdfx\*(TX commands can be given, the first +of which must start with a backslash. +With a +.BI & format +argument pdfx\*(TX uses a different set of precompiled commands, +contained in +.IR format.fmt ; +it is usually better to use the +.B -fmt +.I format +option instead. +.PP +pdfx\*(TX is a version of e-\*(TX that can create +.I PDF +files as well as +.I DVI +files. +.PP +In +.I DVI +mode, pdfx\*(TX can be used as a complete replacement of the e-\*(TX +engine. +.PP +The typical use of pdfx\*(TX is with a pregenerated formats for which +PDF output has been enabled. The +.B pdfxtex +command uses the equivalent of the plain e-\*(TX format, and the +.B pdfxlatex +command uses the equivalent of the e-\*(LX format. +To generate formats, use the +.B -ini +switch. +.PP +The +.B pdfxinitex +and +.B pdfxvirtex +commands are pdfx\*(TX's analogues to the +.B einitex +and +.B evirtex +commands. In this installation, they are symbolic links to the +.B pdfxtex +executable. These symbolic links may not exist at all. +.PP +In +.I PDF +mode, pdfx\*(TX can natively handle the +.IR PDF , +.IR JPG , +and +.I PNG +graphics formats. +pdfx\*(TX's handling of its command-line arguments is similar to that of +of the other \*(TX programs in the +.I web2c +implementation. +.\"===================================================================== +.SH OPTIONS +This version of pdfx\*(TX understands the following command line options. +.TP +.B -enc +.rb +Enable the enc\*(TX extensions. This option is only effective in +combination with +.BR -ini . +For documentation of the enc\*(TX extensions see +.BR http://www.olsak.net/enctex.html . +.TP +.B -file-line-error +.rb +Print error messages in the form +.I file:line:error +which is similar to the way many compilers format them. +.TP +.B -no-file-line-error +.rb +Disable printing error messages in the +.I file:line:error +style. +.TP +.B -file-line-error-style +.rb +This is the old name of the +.B -file-line-error +option. +.TP +.BI -fmt \ format +.rb +Use +.I format +as the name of the format to be used, instead of the name by which +pdfx\*(TX was called or a +.I %& +line. +.TP +.B -halt-on-error +.rb +Exit with an error code when an error is encountered during processing. +.TP +.B -help +.rb +Print help message and exit. +.TP +.B -ini +.rb +Start in +.I INI +mode, which is used to dump formats. The +.I INI +mode can be used for typesetting, but no format is preloaded, and +basic initializations like setting catcodes may be required. +.TP +.BI -interaction \ mode +.rb +Sets the interaction mode. The mode can be either +.IR batchmode , +.IR nonstopmode , +.IR scrollmode , +and +.IR errorstopmode . +The meaning of these modes is the same as that of the corresponding +\ecommands. +.TP +.B -ipc +.rb +Send DVI or PDF output to a socket as well as the usual output file. +Whether this option is available is the choice of the installer. +.TP +.B -ipc-start +.rb +As +.BR -ipc , +and starts the server at the other end as well. Whether this option +is available is the choice of the installer. +.TP +.BI -jobname \ name +.rb +Use +.I name +for the job name, instead of deriving it from the name of the input file. +.TP +.BI -kpathsea-debug \ bitmask +.rb +Sets path searching debugging flags according to the bitmask. See the +.I Kpathsea +manual for details. +.TP +.BI -mktex \ fmt +.rb +Enable +.RI mktex fmt , +where +.I fmt +must be either +.I tex +or +.IR tfm . +.TP +.B -mltex +.rb +Enable ML\*(TX extensions. Only effective in combination with +.BR -ini . +.TP +.BI -no-mktex \ fmt +.rb +Disable +.RI mktex fmt , +where +.I fmt +must be either +.I tex +or +.IR tfm . +.TP +.BI -output-comment \ string +.rb +In +.I DVI +mode, use +.I string +for the +.I DVI +file comment instead of the date. This option is ignored +in +.I PDF +mode. +.TP +.BI -output-directory \ directory +.rb Write output files in +.I directory +instead of the current directory. Look up input files in +.I directory +first, the along the normal search path. +.TP +.BI -output-format \ format +.rb +Set the output format mode, where +.I format +must be either +.I pdf +or +.IR dvi . +This also influences the set of graphics formats understood by pdfx\*(TX. +.TP +.B -parse-first-line +.rb +If the first line of the main input file begins with +.I %& +parse it to look for a dump name or a +.B -translate-file +option. +.TP +.B -no-parse-first-line +.rb +Disable parsing of the first line of the main input file. +.TP +.BI -progname \ name +.rb +Pretend to be program +.IR name . +This affects both the format used and the search paths. +.TP +.B -recorder +.rb +Enable the filename recorder. +This leaves a trace of the files opened for input and output +in a file with extension +.IR .fls . +.TP +.B -shell-escape +.rb +Enable the +.BI \ewrite18{ command } +construct. The +.I command +can be any shell command. This construct is normally +disallowed for security reasons. +.TP +.B -no-shell-escape +.rb +Disable the +.BI \ewrite18{ command } +construct, even if it is enabled in the +.I texmf.cnf +file. +.TP +.B -src-specials +.rb +In +.I DVI +mode, insert source specials into the +.I DVI +file. +This option is ignored in +.I PDF +mode. +.TP +.BI -src-specials \ where +.rb +In +.I DVI +mode, insert source specials in certain placed of the +.I DVI +file. +.I where +is a comma-separated value list: +.IR cr , +.IR display , +.IR hbox , +.IR math , +.IR par , +.IR parent , +or +.IR vbox . +This option is ignored in +.I PDF +mode. +.TP +.BI -translate-file \ tcxname +.rb +Use the +.I tcxname +translation table to set the mapping of input characters and +re-mapping of output characters. +.TP +.BI -default-translate-file \ tcxname +.rb +Like +.B -translate-file +except that a +.I %& +line can overrule this setting. +.TP +.B -version +.rb +Print version information and exit. +.\"===================================================================== +.SH ENVIRONMENT +See the Kpathsearch library documentation (the `Path specifications' +node) for precise details of how the environment variables are used. +The +.B kpsewhich +utility can be used to query the values of the variables. +.PP +One caveat: In most pdfx\*(TX formats, you cannot use ~ in a filename you +give directly to pdfx\*(TX, because ~ is an active character, and hence is +expanded, not taken as part of the filename. Other programs, such as +\*(MF, do not have this problem. +.PP +.TP +TEXMFOUTPUT +Normally, pdfx\*(TX puts its output files in the current directory. If +any output file cannot be opened there, it tries to open it in the +directory specified in the environment variable TEXMFOUTPUT. +There is no default value for that variable. For example, if you say +.I pdfxtex paper +and the current directory is not writable, if TEXMFOUTPUT has +the value +.IR /tmp , +pdfx\*(TX attempts to create +.I /tmp/paper.log +(and +.IR /tmp/paper.pdf , +if any output is produced.) +.TP +TEXINPUTS +Search path for +.I \einput +and +.I \eopenin +files. +This should probably start with ``.'', so +that user files are found before system files. An empty path +component will be replaced with the paths defined in the +.I texmf.cnf +file. For example, set TEXINPUTS to ".:/home/usr/tex:" to prepend the +current direcory and ``/home/user/tex'' to the standard search path. +.TP +TEXFORMATS +Search path for format files. +.TP +TEXPOOL +search path for +.B pdfxtex +internal strings. +.TP +TEXEDIT +Command template for switching to editor. The default, usually +.BR vi , +is set when pdfx\*(TX is compiled. +.TP +TFMFONTS +Search path for font metric +.RI ( .tfm ) +files. +.\"===================================================================== +.SH FILES +The location of the files mentioned below varies from system to +system. Use the +.B kpsewhich +utility to find their locations. +.TP +.I pdfxtex.pool +Text file containing pdfx\*(TX's internal strings. +.TP +.I pdftex.map +Filename mapping definitions. +.TP +.I *.tfm +Metric files for pdfx\*(TX's fonts. +.TP +.I *.fmt +Predigested pdfx\*(TX format (.\|fmt) files. +.br +.\"===================================================================== +.SH NOTES +This manual page is not meant to be exhaustive. The complete +documentation for this version of pdfx\*(TX can be found in the info +manual +.IR "Web2C: A TeX implementation" . +.\"===================================================================== +.SH BUGS +This version of pdfx\*(TX implements a number of optional extensions. +In fact, many of these extensions conflict to a greater or lesser +extent with the definition of pdfx\*(TX. When such extensions are +enabled, the banner printed when pdfx\*(TX starts is changed to print +.B pdfxTeXk +instead of +.BR pdfxTeX . +.PP +This version of pdfx\*(TX fails to trap arithmetic overflow when +dimensions are added or subtracted. Cases where this occurs are rare, +but when it does the generated +.I DVI +file will be invalid. Whether a generated +.I PDF +file would be usable is unknown. +.\"===================================================================== +.SH AVAILABILITY +pdfx\*(TX is available for a large variety of machine architectures +and operation systems. +pdfx\*(TX is part of all major \*(TX distributions. +.P +Information on how to get pdfx\*(TX and related information +is available at the +.BI "http://tug.org" \ TUG +website. +The most recent version of pdfx\*(TX is available for anonymous +ftp at the +.B http://www.pdftex.de/tex/pdftex/ +.IR "pdfx\*(TX development site" . +.P +The following pdfx\*(TX related mailing list is available: +.BR pdftex@tug.org . +This is a mailman list; +to subscribe send a message containing +.I subscribe +to +.BR pdftex-request@tug.org . +More about the list can be found at the +.B "http://tug.org/mailman/listinfo/pdftex" +.I mailing list +website. +.\"===================================================================== +.SH "SEE ALSO" +.BR tex (1), +.BR mf (1), +.BR etex (1), +.BR pdftex (1). +.\"===================================================================== +.SH AUTHORS +The primary authors of pdf\*(TX are Han The Thanh, Petr Sojka, and +Jiri Zlatuska. +.PP +\*(TX was designed by Donald E. Knuth, +who implemented it using his \*(WB system for Pascal programs. +It was ported to Unix at Stanford by Howard Trickey, and +at Cornell by Pavel Curtis. +The version now offered with the Unix \*(TX distribution is that +generated by the \*(WB to C system +.RB ( web2c ), +originally written by Tomas Rokicki and Tim Morgan. +.PP +The enc\*(TX extensions were written by Petr Olsak. diff --git a/Build/source/texk/web2c/man/pktogf.man b/Build/source/texk/web2c/man/pktogf.man new file mode 100644 index 00000000000..808ec870af6 --- /dev/null +++ b/Build/source/texk/web2c/man/pktogf.man @@ -0,0 +1,103 @@ +.TH PKTOGF 1 "14 December 1993" "Web2C @VERSION@" +.\"===================================================================== +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.\"===================================================================== +.SH NAME +pktogf \- convert packed font files to generic font files +.SH SYNOPSIS +.B pktogf +[ +.B \-v +] +.I pk_file_name +[ +.I gf_file_name +] +.\"===================================================================== +.SH DESCRIPTION +This manual page is not meant to be exhaustive. The complete +documentation for this version of \*(TX can be found in the info file +or manual +.IR "Web2C: A TeX implementation" . +.PP +The +.B pktogf +program converts a packed font file +.RI ( pk ) +to a generic font file +.RI ( gf ). +Packed +font files are much smaller than the corresponding +.I gf +files, +but some DVI readers only understand +.I gf +files. +.PP +The +.I pk_file_name +on the command line must be complete. Because +the resolution is part of the extension, it would not make +sense to append a default extension as is done with \*(TX or +DVI-reading software. The +.I gf_file_name +defaults to the same (stripped) name as +.IR pk_file_name , +and it is placed in the current +working directory with the +.I gf +suffix replacing +.IR pk . +For example, the input file +.I io.300pk +would become +.IR io.300gf . +.\"===================================================================== +.SH OPTIONS +Unless the +.B \-v +switch is given, +.B pktogf +operates silently. With +.BR \-v , +the version number of the program and statistics about the +unpacking are output to +.IR stdout . +.\"===================================================================== +.SH ENVIRONMENT +.B pktogf +looks for +.I pk_file_name +using the +environment variable PKFONTS. If that is not set, it uses the variable +TEXPKS. If that is not set, it uses TEXFONTS. If that is not set, it +uses the system default. +.PP +See +.BR tex (1) +for the details of the searching. +.\"===================================================================== +.SH "SEE ALSO" +.BR gftopk (1), +.BR gftype (1), +.BR pktype (1). +.br +Donald E. Knuth et al., +.IR \*(MFware . +.\"===================================================================== +.SH AUTHORS +Tomas Rokicki wrote the program. +Pierre MacKay adapted it for compilation with +.BR web2c . diff --git a/Build/source/texk/web2c/man/pktype.man b/Build/source/texk/web2c/man/pktype.man new file mode 100644 index 00000000000..9cb3508e79f --- /dev/null +++ b/Build/source/texk/web2c/man/pktype.man @@ -0,0 +1,85 @@ +.TH PKTYPE 1 "13 March 1996" "Web2C @VERSION@" +.\"===================================================================== +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.\"===================================================================== +.SH NAME +pktype \- verify and translate a packed font bitmap file to plain text +.SH SYNOPSIS +.B pktype +.I pk_file +[ +.I output_file +] +.\"===================================================================== +.SH DESCRIPTION +This manual page is not meant to be exhaustive. The complete +documentation for this version of \*(TX can be found in the info file +or manual +.IR "Web2C: A TeX implementation" . +.PP +The +.B pktype +program translates a packed font file +.RI ( pk ) +(output by, for example, +.BR gftopk (1) +to a file that humans can read. It also serves as a +.I pk +file-validating program (i.e., if +.B pktype +can read it, it's correct) and as an example of a +.IR pk -reading +program for other software that wants to read +.I pk +files. +.PP +The +.I pk_file +on the command line must be complete. Because +the resolution is part of the extension, it would not make +sense to append a default extension as is done with \*(TX or +DVI-reading software. If no +.I output_file +is specified, the plain text translation is written to standard output. +.PP +The output file gives a compact encoding of the packed encoding, using +conventions described in the source code. Run lengths of black pixels +alternate with parenthesized run lengths of white pixels, and brackets +are used to indicate when a row should be repeated. +.\"===================================================================== +.SH ENVIRONMENT +.B pktype +looks for +.I pk_file +using the environment variable PKFONTS. If that is not set, it uses +the variable TEXPKS. If that is not set, it uses TEXFONTS. If that +is not set, it uses the system default. +.PP +See +.BR tex (1) +for the details of the searching. +.\"===================================================================== +.SH "SEE ALSO" +.BR dvitype (1), +.BR gftopk (1), +.BR gftype (1). +.br +Donald E. Knuth et al., +.IR \*(MFware . +.\"===================================================================== +.SH AUTHORS +Tomas Rokicki wrote the program. +Donald E. Knuth originally ported it to Unix. +Pierre MacKay adapted it for compilation with Web2c. diff --git a/Build/source/texk/web2c/man/pltotf.man b/Build/source/texk/web2c/man/pltotf.man new file mode 100644 index 00000000000..60a3b703cb1 --- /dev/null +++ b/Build/source/texk/web2c/man/pltotf.man @@ -0,0 +1,74 @@ +.TH PLTOTF 1 "27 December 1992" "Web2C @VERSION@" +.\"===================================================================== +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.if n .ds WB Web +.if t .ds WB W\s-2EB\s0 +.\"===================================================================== +.SH NAME +pltotf \- convert property list files to TeX font metric (tfm) format +.SH SYNOPSIS +.B pltotf +[ +.B \-verbose +] +.I pl_file_name +.I tfm_file_name +.\"===================================================================== +.SH DESCRIPTION +This manual page is not meant to be exhaustive. The complete +documentation for this version of \*(TX can be found in the info file +or manual +.IR "Web2C: A TeX implementation" . +.PP +The +.B pltotf +program translates a (human-oriented) \*(WB property list file to a +(program-oriented) \*(TX font metric file. Thus, after editing the property +list file, a TFM file can be generated for use with, for example, +.BR tex (1). +.PP +Both the +.I pl_file_name +and the +.I tfm_file_name +must be complete; no adding of default extensions or path searching is done. +.\"===================================================================== +.SH OPTIONS +Without the +.B \-verbose +option, +.B pltotf +operates silently. With it, a banner and progress report are printed on +.IR stdout . +.\"===================================================================== +.SH "SEE ALSO" +.BR tftopl (1). +.br +Donald E. Knuth, +.IR "\*(OXware" . +.br +Donald E. Knuth, +.IR "The \*(MFbook" , +(Volume C of +.IR "Computers and Typesetting" ), +Addison-Wesley, 1986, ISBN 0-201-13445-4. +.\"===================================================================== +.SH AUTHORS +Donald E. Knuth wrote the program. It was published as +part of the +.I \*(OXware +technical report, available from the \*(TX Users Group. +Howard Trickey, Pavel Curtis, and Richard Furuta originally ported it to +Unix. diff --git a/Build/source/texk/web2c/man/pooltype.man b/Build/source/texk/web2c/man/pooltype.man new file mode 100644 index 00000000000..bc7dabe36af --- /dev/null +++ b/Build/source/texk/web2c/man/pooltype.man @@ -0,0 +1,45 @@ +.TH POOLTYPE 1 "27 December 1992" "Web2C @VERSION@" +.\"===================================================================== +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.if n .ds WB Web +.if t .ds WB W\s-2EB\s0 +.\"===================================================================== +.SH NAME +pooltype \- display a WEB pool file +.SH SYNOPSIS +.B pooltype +.I pool_file_name +.\"===================================================================== +.SH DESCRIPTION +This manual page is not meant to be exhaustive. The complete +documentation for this version of \*(TX can be found in the info file +or manual +.IR "Web2C: A TeX implementation" . +.PP +The +.B pooltype +program translates a (program-oriented) \*(WB string pool file to a +(human-oriented) text file. +.PP +The +.I pool_file_name +must be complete; no adding of default extensions or path searching is done. +.\"===================================================================== +.SH "SEE ALSO" +.BR tangle (1). +.\"===================================================================== +.SH AUTHORS +Donald E. Knuth wrote the program and originally ported it to Unix. It was +published as part of the +.I \*(OXware +technical report, available from the \*(TX Users Group. diff --git a/Build/source/texk/web2c/man/slitex.min b/Build/source/texk/web2c/man/slitex.min new file mode 100644 index 00000000000..37031db8b60 --- /dev/null +++ b/Build/source/texk/web2c/man/slitex.min @@ -0,0 +1,39 @@ +.TH SLITEX 1 "27 December 1992" +.\"===================================================================== +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.\"===================================================================== +.SH NAME +slitex \- make LaTeX slides +.SH SYNOPSIS +.B slitex +[ first-line ] +.\"===================================================================== +.SH DESCRIPTION +The +.B slitex +program is a variant of +.BR latex (1), +designed for generating slides. +It is described in Appendix A of +.IR "\*(LX \- A Document Preparation System" . +All the capabilities described in +.BR tex (1) +are present. +.\"===================================================================== +.SH "SEE ALSO" +.BR latex (1), +.BR tex (1). +.br +Leslie Lamport, +.IR "\*(LX \- A Document Preparation System" , +Addison-Wesley, 1985, ISBN 0-201-15790-X. diff --git a/Build/source/texk/web2c/man/spell.add b/Build/source/texk/web2c/man/spell.add new file mode 100644 index 00000000000..0d9bbd4159f --- /dev/null +++ b/Build/source/texk/web2c/man/spell.add @@ -0,0 +1,236 @@ +AMSLATEX +AMSTEX +AY +AmSLaTeX +AmSTeX +Atari +BI +BIBINPUTS +BIBTEX +BX +BibTeX +Breitenlohner +CONTENTS.tex +CS +DOC +DVI +DVITYPE +DeVice +Furuta +GFFONTS +GFTODVI +GFTOPK +GFTYPE +INITEX +ISBN +Ignacio +LX +LaTeX +Lamport +Liang +MAGSTEP +MF +MFBASES +MFEDIT +MFINPUTS +MFPOOL +MFT +MFTERM +MacKay +ONLINE +Oren +PATGEN +PKFONTS +PKTOGF +PKTYPE +PLTOTF +POOLTYPE +Patashnik +Pavel +Rokicki +SLITEX +Sewell +Spivak +SunView +TEX +TEXEDIT +TEXFONTS +TEXFORMATS +TEXINPUTS +TEXMFOUTPUT +TEXPKS +TEXPOOL +TFM +TFTOPL +TUGboat +TW +TeX +Tek +Tomas +Trickey +VF +VFFONTS +VFTOVP +VIRTEX +VPTOVF +WB +Zabala +a.out +al +amsart +amsbook +amslatex +amslatex.tex +amstex +amstexl +amstexl.fmt +aux +auxname +batchmode +bbl +bibtex +bitmap +bitmaps +blecchhh +bst +btxbst.doc +btxdoc.bib +btxdoc.tex +btxhak.tex +ch +changefile +charcode +cmbase.mf +cmbase.mft +cmmf.base +cmr8 +cmtt10 +com +controlsequence +def +defs +dpi +ds +dvi +dvitype +emacs +font.mf +foo +foo.base +footex +footex.fmt +gf +gf,pk +gftodvi +gftopk +gftype +gray.mf +gray.tfm +grayfont +grayfontarea +hp2627 +hy +hyphen.tex +iffalse +ing +inimf +initex +io.2602gf +io.300gf +io.300pk +io.dvi +jobname +karl +lamstex +lamstex.fmt +lamstex.tmp +latex.fmt +letterforms +linenumber +litprog +localfont +lplain +lplain.fmt +mag +magstep +magsteps +mf +mf.pool +mf.tbl +mfput +mft +mftmac.tex +modes.mf +mybase +myfmt +myfonts +mylib +mytex +mytex.fmt +na +nl +nnn +nocite +nput +nr +null.mf +null.tex +online +openin +paper.dvi +paper.log +paper.tex +patgen +phen +pk +pktogf +pktype +pl +plain.fmt +plain.mf +plain.mft +plain.tex +pltotf +pooltype +prettyprinting +printengine +puter +setenv +shsu.edu +site.h +slantfont +slantimagen6 +slitex +slitex.fmt +splain +splain.fmt +supercedes +sy +tek +testart.tex +testbook.tex +tex +tex.fmt +tex.pool +texinfo +texput +tfm +tftopl +tion +typesettable +ucb +ump +uniterm +username +vf +vfm +vftovp +virmf +virtex +vpl +vptovf +web2c +webfile +webmac.tex +xampl.bib +xterm diff --git a/Build/source/texk/web2c/man/tangle.man b/Build/source/texk/web2c/man/tangle.man new file mode 100644 index 00000000000..4cf40586f8d --- /dev/null +++ b/Build/source/texk/web2c/man/tangle.man @@ -0,0 +1,180 @@ +.TH TANGLE 1 "20 October 2002" "Web2C @VERSION@" +.\"===================================================================== +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.if n .ds WB Web +.if t .ds WB W\s-2EB\s0 +.\"===================================================================== +.SH NAME +tangle \- translate WEB to Pascal +.SH SYNOPSIS +.B tangle +[ +.RI options +] +.I webfile[.web] +[ +.I changefile[.ch] +] +.\"===================================================================== +.SH DESCRIPTION +This manual page is not meant to be exhaustive. The complete +documentation for this version of \*(TX can be found in the info file +or manual +.IR "Web2C: A TeX implementation" . +.PP +The +.B tangle +program converts a \*(WB +source document into a Pascal program that may be compiled in the usual +way with the on-line Pascal compiler (e.g., +.BR pc (1)). +The output file is packed into lines of 72 characters or less, with +the only concession to readability being the termination of lines at +semicolons when this can be done conveniently. +.PP +The \*(WB language allows you to prepare a single document containing all +the information that is needed both to produce a compilable Pascal +program and to produce a well-formatted document describing the program +in as much detail as the writer may desire. The user of \*(WB must be +familiar with both \*(TX and Pascal. \*(WB also provides a relatively +simple, although adequate, macro facility that permits a Pascal program +to be written in small easily-understood modules. +.PP +The command line should have either one or two names on it. +The first is taken as the \*(WB file (and +.I .web +is added if there is no +extension). +If there is another name, it is a change file (and +.I .ch +is added if there is +no extension). The change file overrides parts of the \*(WB file, +as described in the \*(WB system documentation. +.PP +The output files are a Pascal file and a string pool file, +whose names are formed by adding +.I .p +and +.I .pool +respectively to the root of the \*(WB file name. +.\"===================================================================== +.SH "OPTIONS" +This version of +.B tangle +understands the following options. Note that some of these options +may render the output unsuitable for processing by a Pascal compiler. +.TP +.B --help +.rb +Print help message and exit. +.TP +.BI --length \ number +.rb +Compare only the first +.I number +characters of identifiers when checking for collisions. The default +is 32, the original +.B tangle +used 7. +.TP +.B --loose +.rb +When checking for collisions between identifiers, honor the settings +of the +.BR --lowercase , +.BR --mixedcase , +.BR --uppercase , +and +.B --underline +options. This is the default. +.TP +.B --lowercase +.rb +Convert all identifiers to lowercase. +.TP +.B --mixedcase +.rb +Retain the case of identifiers. This is the default. +.TP +.B --strict +.rb +When checking for collisions between identifiers, strip underlines and +convert all identifiers to uppercase first. +.TP +.B --underline +.rb +Retain underlines (also known as underscores) in identifiers. +.TP +.B --uppercase +.rb +Convert all identifiers to uppercase. This is the behaviour of the +original +.BR tangle . +.TP +.B --version +.rb +Print version information and exit. +.\"===================================================================== +.SH "SEE ALSO" +.BR pc (1), +.BR pxp (1) +(for formatting +.B tangle +output when debugging), +.BR tex (1). +.PP +Donald E. Knuth, +.IR "The \*(WB System of Structured Documentation" . +.PP +Donald E. Knuth, +.IR "Literate Programming" , +Computer Journal +.BR 27 , +97\-111, 1984. +.PP +Wayne Sewell, +.IR "Weaving a Program" , +Van Nostrand Reinhold, 1989, ISBN 0-442-31946-0. +.PP +Donald E. Knuth, +.I "\*(OX: The Program" +(Volume B of +.IR "Computers and Typesetting" ), +Addison-Wesley, 1986, ISBN 0-201-13437-3. +.PP +Donald E. Knuth, +.I "\*(MF: The Program" +(Volume D of +.IR "Computers and Typesetting" ), +Addison-Wesley, 1986, ISBN 0-201-13438-1. +.PP +These last two are by far the largest extant examples of \*(WB +programs. +.PP +There is an active Internet electronic mail discussion list on the +subject of literate programming; send a subscription request to +.I litprog-request@shsu.edu +to join. +.\"===================================================================== +.SH AUTHORS +\*(WB was designed by Donald E. Knuth, based on an earlier system +called DOC (implemented by Ignacio Zabala). +The +.B tangle +and +.B weave +programs are themselves written in \*(WB. The system +was originally ported to Unix at Stanford by Howard Trickey, and at +Cornell by Pavel Curtis. diff --git a/Build/source/texk/web2c/man/tex.man b/Build/source/texk/web2c/man/tex.man new file mode 100644 index 00000000000..349be90923e --- /dev/null +++ b/Build/source/texk/web2c/man/tex.man @@ -0,0 +1,541 @@ +.TH TEX 1 "21 August 2004" "Web2C @VERSION@" +.\"===================================================================== +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.if n .ds WB Web +.if t .ds WB W\s-2EB\s0 +.\" EX and EE are used for displays that are pure code +.de EX +.nf +.ft CW +.. +.de EE +.ft R +.fi +.. +.\"===================================================================== +.SH NAME +tex, virtex, initex \- text formatting and typesetting +.SH SYNOPSIS +.B tex +.RI [ options ] +[\fB&\fR \fIformat\fR ] +[ \fIfile\fR | \fB\e\fR \fIcommands\fR ] +.\"===================================================================== +.SH DESCRIPTION +Run the \*(TX typesetter on +.IR file , +usually creating +.IR file.dvi . +If the file argument has no extension, ".tex" will be appended to it. +Instead of a filename, a set of \*(TX commands can be given, the first +of which must start with a backslash. +With a +.BI & format +argument \*(TX uses a different set of precompiled commands, +contained in +.IR format.fmt ; +it is usually better to use the +.B -fmt +.I format +option instead. +.PP +\*(TX +formats the interspersed text and commands contained in the named +files +and outputs a typesetter independent file (called +.IR DVI , +which is short for +.IR "DeVice Independent" ). +\*(TX's capabilities and language are described in +.IR "The \*(OXbook" . +\*(TX +is normally used with a large body of precompiled macros, +and there are several specific formatting systems, such as +\*(LX, +which require the support of several macro files. +.PP +This version of \*(TX looks at its command line to see what name it +was called under. If they exist, then both +.B initex +and +.B virtex +are symbolic links to the +.B tex +executable. When called as +.BR initex +(or when the +.B -ini +option is given) it can be used to precompile macros into a +.I .fmt +file. When called as +.B virtex +it will use the +.I plain +format. When called under any other name, \*(TX will use that name as +the name of the format to use. For example, when called as +.B tex +the +.I tex +format is used, which is identical to the +.I plain +format. The commands defined by the +.I plain +format are documented in +.IR "The \*(OXbook" . +Other formats that are often available include +.I latex +and +.IR amstex . +.PP +The non-option command line arguments to the +\*(TX +program are passed to it as the first input line. (But it is often +easier to type extended arguments as the first input line, since UNIX +shells tend to gobble up or misinterpret \*(TX's favorite symbols, +like backslashes, unless you quote them.) +As described in +.IR "The \*(OXbook" , +that first line should begin with a filename, a +.IR \econtrolsequence , +or a +.IR &formatname . +.PP +The normal usage is to say +.EX +tex paper +.EE +to start processing +.IR paper.tex . +The name +.I paper +will be the ``jobname'', and is used in forming +output filenames. +If \*(TX doesn't get a filename in the first line, the jobname is +.IR texput . +When looking for a file, \*(TX looks for the name with and without the +default extension +.RI ( .tex ) +appended, unless the name already contains that extension. If +.I paper +is the ``jobname'', +a log of error messages, with rather more detail than normally appears +on the screen, will appear in +.IR paper.log , +and the output file will be in +.IR paper.dvi . +.PP +This version of \*(TX can look in the first line of the file +.I paper.tex +to see if it begins with the magic sequence +.IR %& . +If the first line begins with +.BI %& format +.BI -translate-file \ tcxname +then \*(TX will use the named format and transation table +.I tcxname +to process the source file. Either the format name or the +.B -translate-file +specification may be omitted, but not both. This overrides the +format selection based on the name by which the program is invoked. +The +.B -parse-first-line +option or the +.B parse_first_line +configuration variable controls whether this behaviour is enabled. +.PP +The +.I e +response to \*(TX's error prompt causes the system default editor to +start up at the current line of the current file. The environment +variable TEXEDIT can be used to change the editor used. It may +contain a string with "%s" indicating where the filename goes and "%d" +indicating where the decimal line number (if any) goes. For example, +a TEXEDIT string for +.B emacs +can be set with the +.B sh +command +.EX +\fITEXEDIT="emacs +%d %s"; export TEXEDIT\fP +.EE +.PP +A convenient file in the library is +.IR null.tex , +containing nothing. +When \*(TX can't find a file it thinks you want to input, it keeps +asking you for another filename; responding `null' gets you out +of the loop if you don't want to input anything. You can also type your +EOF character (usually control-D). +.PP +.\"===================================================================== +.SH OPTIONS +This version of \*(TX understands the following command line options. +.TP +.B -enc +.rb +Enable the enc\*(TX extensions. This option is only effective in +combination with +.BR -ini . +For documentation of the enc\*(TX extensions see +.BR http://www.olsak.net/enctex.html . +.TP +.B -file-line-error +.rb +Print error messages in the form +.I file:line:error +which is similar to the way many compilers format them. +.TP +.B -no-file-line-error +.rb +Disable printing error messages in the +.I file:line:error +style. +.TP +.B -file-line-error-style +.rb +This is the old name of the +.B -file-line-error +option. +.TP +.BI -fmt \ format +.rb +Use +.I format +as the name of the format to be used, instead of the name by which +\*(TX was called or a +.I %& +line. +.TP +.B -halt-on-error +.rb +Exit with an error code when an error is encountered during processing. +.TP +.B -help +.rb +Print help message and exit. +.TP +.B -ini +.rb +Start in +.I INI +mode, which is used to dump formats. The +.I INI +mode can be used for typesetting, but no format is preloaded, and +basic initializations like setting catcodes may be required. +.TP +.BI -interaction \ mode +.rb +Sets the interaction mode. The mode can be either +.IR batchmode , +.IR nonstopmode , +.IR scrollmode , +and +.IR errorstopmode . +The meaning of these modes is the same as that of the corresponding +\ecommands. +.TP +.B -ipc +.rb +Send DVI output to a socket as well as the usual output file. Whether +this option is available is the choice of the installer. +.TP +.B -ipc-start +.rb +As +.BR -ipc , +and starts the server at the other end as well. Whether this option +is available is the choice of the installer. +.TP +.BI -jobname \ name +.rb +Use +.I name +for the job name, instead of deriving it from the name of the input file. +.TP +.BI -kpathsea-debug \ bitmask +.rb +Sets path searching debugging flags according to the bitmask. See the +.I Kpathsea +manual for details. +.TP +.BI -mktex \ fmt +.rb +Enable +.RI mktex fmt , +where +.I fmt +must be either +.I tex +or +.IR tfm . +.TP +.B -mltex +.rb +Enable ML\*(TX extensions. Only effective in combination with +.BR -ini . +.TP +.BI -no-mktex \ fmt +.rb +Disable +.RI mktex fmt , +where +.I fmt +must be either +.I tex +or +.IR tfm . +.TP +.BI -output-comment \ string +.rb +Use +.I string +for the +.I DVI +file comment instead of the date. +.TP +.BI -output-directory \ directory +.rb Write output files in +.I directory +instead of the current directory. Look up input files in +.I directory +first, the along the normal search path. +.TP +.B -parse-first-line +.rb +If the first line of the main input file begins with +.I %& +parse it to look for a dump name or a +.B -translate-file +option. +.TP +.B -no-parse-first-line +.rb +Disable parsing of the first line of the main input file. +.TP +.BI -progname \ name +.rb +Pretend to be program +.IR name . +This affects both the format used and the search paths. +.TP +.B -recorder +.rb +Enable the filename recorder. This leaves a trace of the files opened +for input and output in a file with extension +.IR .fls . +.TP +.B -shell-escape +.rb +Enable the +.BI \ewrite18{ command } +construct. The +.I command +can be any shell command. This construct is normally +disallowed for security reasons. +.TP +.B -no-shell-escape +.rb +Disable the +.BI \ewrite18{ command } +construct, even if it is enabled in the +.I texmf.cnf +file. +.TP +.B -src-specials +.rb +Insert source specials into the +.I DVI +file. +.TP +.BI -src-specials \ where +.rb +Insert source specials in certain places of the +.I DVI +file. +.I where +is a comma-separated value list: +.IR cr , +.IR display , +.IR hbox , +.IR math , +.IR par , +.IR parent , +or +.IR vbox . +.TP +.BI -translate-file \ tcxname +.rb +Use the +.I tcxname +translation table to set the mapping of input characters and +re-mapping of output characters. +.TP +.BI -default-translate-file \ tcxname +.rb +Like +.B -translate-file +except that a +.I %& +line can overrule this setting. +.TP +.B -version +.rb +Print version information and exit. +.\"===================================================================== +.SH ENVIRONMENT +See the Kpathsearch library documentation (the `Path specifications' +node) for precise details of how the environment variables are used. +The +.B kpsewhich +utility can be used to query the values of the variables. +.PP +One caveat: In most \*(TX formats, you cannot use ~ in a filename you +give directly to \*(TX, because ~ is an active character, and hence is +expanded, not taken as part of the filename. Other programs, such as +\*(MF, do not have this problem. +.PP +.TP +TEXMFOUTPUT +Normally, \*(TX puts its output files in the current directory. If +any output file cannot be opened there, it tries to open it in the +directory specified in the environment variable TEXMFOUTPUT. +There is no default value for that variable. For example, if you say +.I tex paper +and the current directory is not writable, if TEXMFOUTPUT has +the value +.IR /tmp , +\*(TX attempts to create +.I /tmp/paper.log +(and +.IR /tmp/paper.dvi , +if any output is produced.) +.TP +TEXINPUTS +Search path for +.I \einput +and +.I \eopenin +files. +This should probably start with ``.'', so +that user files are found before system files. An empty path +component will be replaced with the paths defined in the +.I texmf.cnf +file. For example, set TEXINPUTS to ".:/home/usr/tex:" to prepend the +current direcory and ``/home/user/tex'' to the standard search path. +.TP +TEXFORMATS +Search path for format files. +.TP +TEXPOOL +search path for +.B tex +internal strings. +.TP +TEXEDIT +Command template for switching to editor. The default, usually +.BR vi , +is set when \*(TX is compiled. +.TP +TFMFONTS +Search path for font metric +.RI ( .tfm ) +files. +.\"===================================================================== +.SH FILES +The location of the files mentioned below varies from system to +system. Use the +.B kpsewhich +utility to find their locations. +.TP +.I texmf.cnf +Configuration file. This contains definitions of search paths as well +as other configuration parameters like +.BR parse_first_line . +.TP +.I tex.pool +Text file containing \*(TX's internal strings. +.TP +.I texfonts.map +Filename mapping definitions. +.TP +.I *.tfm +Metric files for \*(TX's fonts. +.TP +.I *.fmt +Predigested \*(TX format (.\|fmt) files. +.TP +.I $TEXMFMAIN/tex/plain/base/plain.tex +The basic macro package described in the \*(OXbook. +.br +.\"===================================================================== +.SH NOTES +This manual page is not meant to be exhaustive. The complete +documentation for this version of \*(TX can be found in the info manual +.IR "Web2C: A TeX implementation" . +.\"===================================================================== +.SH BUGS +This version of \*(TX implements a number of optional extensions. +In fact, many of these extensions conflict to a greater or lesser +extent with the definition of \*(TX. When such extensions are +enabled, the banner printed when \*(TX starts is changed to print +.B TeXk +instead of +.BR TeX . +.PP +This version of \*(TX fails to trap arithmetic overflow when +dimensions are added or subtracted. Cases where this occurs are rare, +but when it does the generated +.I DVI +file will be invalid. +.\"===================================================================== +.SH "SEE ALSO" +.BR mf (1), +.br +Donald E. Knuth, +.IR "The \*(OXbook" , +Addison-Wesley, 1986, ISBN 0-201-13447-0. +.br +Leslie Lamport, +.IR "\*(LX \- A Document Preparation System" , +Addison-Wesley, 1985, ISBN 0-201-15790-X. +.br +K. Berry, +.IR "Eplain: Expanded plain \*(TX" , +ftp://ftp.cs.umb.edu/pub/tex/eplain/doc. +.br +Michael Spivak, +.IR "The Joy of \*(OX" , +2nd edition, Addison-Wesley, 1990, ISBN 0-8218-2997-1. +.br +.I TUGboat +(the journal of the \*(TX Users Group). +.\"===================================================================== +.SH TRIVIA +\*(TX, pronounced properly, rhymes with ``blecchhh.'' The proper +spelling in typewriter-like fonts is ``TeX'' and not ``TEX'' or ``tex.'' +.\"===================================================================== +.SH AUTHORS +\*(TX was designed by Donald E. Knuth, +who implemented it using his \*(WB system for Pascal programs. +It was ported to Unix at Stanford by Howard Trickey, and +at Cornell by Pavel Curtis. +The version now offered with the Unix \*(TX distribution is that +generated by the \*(WB to C system +.RB ( web2c ), +originally written by Tomas Rokicki and Tim Morgan. +.PP +The enc\*(TX extensions were written by Petr Olsak. diff --git a/Build/source/texk/web2c/man/tftopl.man b/Build/source/texk/web2c/man/tftopl.man new file mode 100644 index 00000000000..ffd5690df13 --- /dev/null +++ b/Build/source/texk/web2c/man/tftopl.man @@ -0,0 +1,117 @@ +.TH TFTOPL 1 "17 December 1994" "Web2C @VERSION@" +.\"===================================================================== +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.\"===================================================================== +.SH NAME +tftopl \- convert TeX font metric (tfm) files to property lists +.SH SYNOPSIS +.B tftopl +[ +.BI \-charcode-format =format +] +[ +.B \-verbose +] +.I tfm_name[.tfm] +[ +.I pl_name[.pl] +] +.\"===================================================================== +.SH DESCRIPTION +This manual page is not meant to be exhaustive. The complete +documentation for this version of \*(TX can be found in the info file +or manual +.IR "Web2C: A TeX implementation" . +.PP +The +.B tftopl +program translates a (program-oriented) font metric file to a +(human-oriented) property list file. Thus, you can edit the contents of +the TFM files, if the font designer has not done his or her job +properly, or if you're encountering strange difficulties, or if you're +just curious. It also serves as a TFM-file validating program, i.e., if +no error messages are given, the input file is correct. +.PP +The +.I pl_name +is extended with +.I .pl +if it lacks a suffix. +If +.I pl_name +is not given, standard output is used. Likewise, +.I tfm_name +is extended with +.I .tfm +if it lacks a suffix. Also, path searching is done for the +.I .tfm +file +using the environment variable TEXFONTS. If that is not set, +.B tftopl +uses the system default. +.PP +See +.BR tex (1) +for the details of the searching. +.\"===================================================================== +.SH OPTIONS +The argument +.I format +to +.B \-charcode-format +specifies how character codes are output in the PL file. By +default, only letters and digits are output using the +.B C +integer code (i.e., in ASCII); the others are output in octal. (Unless +the font's coding scheme starts with +.B "TeX math sy" +or +.BR "TeX math ex" , +in which case all character codes are output in octal.) If +.I format +is +.BR ascii , +all character codes that correspond to graphic characters, besides the +left and right parentheses, are output in ASCII. Finally, if +.I format +is +.BR octal , +all character codes are output in octal. +.PP +Without the +.B \-verbose +option, +.B tftopl +operates silently. With it, a banner and progress report are printed on +.IR stdout . +.\"===================================================================== +.SH "SEE ALSO" +.BR pltotf (1), +.br +Donald E. Knuth, +.IR "\*(OXware" . +.br +Donald E. Knuth, +.I "The \*(MFbook" +(Volume C of +.IR "Computers and Typesetting" ), +Addison-Wesley, 1986, ISBN 0-201-13445-4. +.\"===================================================================== +.SH AUTHORS +Donald E. Knuth wrote the program. It was published as +part of the +.I \*(OXware +technical report, available from the \*(TX Users Group. +Howard Trickey and Pavel Curtis originally ported it to Unix. diff --git a/Build/source/texk/web2c/man/vftovp.man b/Build/source/texk/web2c/man/vftovp.man new file mode 100644 index 00000000000..22d45bb2653 --- /dev/null +++ b/Build/source/texk/web2c/man/vftovp.man @@ -0,0 +1,100 @@ +.TH VFTOVP 1 "19 December 1994" "Web2C @VERSION@" +.\"===================================================================== +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.\"===================================================================== +.SH NAME +vftovp \- convert virtual font (vf) files to virtual property lists (vpl) +.SH SYNOPSIS +.B vftovp +[ +.BI \-charcode-format =format +] +[ +.B \-verbose +] +.I vf_name[.vf] +.I tfm_name[.tfm] +[ +.I vpl_name[.vpl] +] +.\"===================================================================== +.SH DESCRIPTION +This manual page is not meant to be exhaustive. The complete +documentation for this version of \*(TX can be found in the info file +or manual +.IR "Web2C: A TeX implementation" . +.PP +The +.B vftovp +program translates a (program-oriented) virtual font file and its +accompanying \*(TX font metric file to a (human-oriented) property list file. +Thus, the virtual font can be edited, and its exact contents can be +displayed mnemonically. It also serves as a VF-file validating program; +if no error messages are given, the input files are correct. +.PP +The filenames are extended with the appropriate extension if necessary. +.\"===================================================================== +.SH OPTIONS +The argument +.I format +to +.B \-charcode-format +specifies how character codes are output in the VPL file. By +default, only letters and digits are output using the +.B C +integer code (i.e., in ASCII); the others are output in octal. (Unless +the font's coding scheme starts with +.B "TeX math sy" +or +.BR "TeX math ex" , +when all are output in octal.) If +.I format +is +.BR ascii , +all character codes that correspond to graphic characters, besides the +left and right parentheses, are output in ASCII. On the other hand, if +.I format +is +.BR octal , +all character codes are output in octal. +.PP +Without the +.B \-verbose +option, +.B vftovp +operates silently. With it, a banner and progress report are printed on +.IR stdout . +.\"===================================================================== +.SH ENVIRONMENT +.B vftovp +looks for +.I vf_name +using the +environment variable VFFONTS. If that is not set, it uses the variable +TEXFONTS. If that is not set, it uses the system default. +.PP +See +.BR tex (1) +for the details of the searching. +.\"===================================================================== +.SH "SEE ALSO" +.BR pltotf (1), +.BR tftopl (1), +.BR vptovf (1). +.\"===================================================================== +.SH AUTHORS +Donald E. Knuth wrote the program, based in part on an idea of David Fuchs, +starting with the code for +.BR tftopl (1). +Karl Berry adapted it for compilation with +.BR web2c . diff --git a/Build/source/texk/web2c/man/virtex.min b/Build/source/texk/web2c/man/virtex.min new file mode 100644 index 00000000000..8d490e9ea15 --- /dev/null +++ b/Build/source/texk/web2c/man/virtex.min @@ -0,0 +1,81 @@ +.TH VIRTEX 1 "14 December 1993" +.\"===================================================================== +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.if t .ds AX \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(TX +.if n .ds AX AmSTeX +.if t .ds AY \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(LX +.if n .ds AY AmSLaTeX +.\"===================================================================== +.SH NAME +virtex \- virgin TeX for production typesetting +.SH DESCRIPTION +.B virtex +is a version of the \*(TX program that has no +preloaded macro packages, but is capable of +loading a special preformatted binary file, called +a +.I format +.RI ( .fmt ) +file produced by the +.BR initex (1) +program. +.PP +Preprocessing of large macro files and font +definitions by +.B initex +makes it possible to rapidly load complex +packages, like plain \*(TX, \*(AX, \*(AY, or \*(LX, +without the overhead of macro parsing and file +opening that would otherwise be experienced. +.PP +.B virtex +can be invoked directly, providing it with a name +of a format file specially prefixed by an +ampersand: +.RS +.I "virtex '&plain' filename" +.RE +This causes it to load the binary file named +.I plain.fmt +from a directory in the standard TEXINPUTS search +path, and then load the text file +.I filename +and process it. The quotes are needed to protect +the ampersand from Unix shell interpretation. +.PP +Because this need occurs frequently, Unix +.B virtex +provides a convenient shorthand. If it is invoked +under a name other than +.BR virtex , +such as +.BR footex , +it will behave as if it had been invoked as +.I "virtex '&footex'" +and first load a file named +.IR footex.fmt . +Thus, +.BR amslatex , +.BR amstex , +.BR lamstex , +.BR latex , +.BR slitex , +.BR tex , +.BR texinfo , +and others can all be file system links to +.BR virtex , +without requiring additional disk space. +.\"===================================================================== +.SH "SEE ALSO" +.BR initex (1), +.BR tex (1). diff --git a/Build/source/texk/web2c/man/vptovf.man b/Build/source/texk/web2c/man/vptovf.man new file mode 100644 index 00000000000..fbba8245e06 --- /dev/null +++ b/Build/source/texk/web2c/man/vptovf.man @@ -0,0 +1,68 @@ +.TH VPTOVF 1 "16 December 1994" "Web2C @VERSION@" +.\"===================================================================== +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.el .ds OX TeX for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.\"===================================================================== +.SH NAME +vptovf \- convert virtual property lists to virtual font metrics +.SH SYNOPSIS +.B vptovf +[ +.B \-verbose +] +.I vpl_name[.vpl] +.I vfm_name[.vf] +.I tfm_name[.tfm] +.\"===================================================================== +.SH DESCRIPTION +This manual page is not meant to be exhaustive. The complete +documentation for this version of \*(TX can be found in the info file +or manual +.IR "Web2C: A TeX implementation" . +.PP +The +.B vptovf +program translates a (human-oriented) property list file to a pair of +(program-oriented) files in the VF (virtual font) and TFM (\*(TX font metric) +formats. Thus, a virtual font +file can be edited and its exact contents +can be displayed mnemonically. +New virtual fonts, which map characters as seen by \*(TX into an arbitrary +sequence of low-level typesetting operations, +can also be created in this way. +.PP +All three filenames, +.I vpl_name, +.I vf_name, +and +.I tfm_name, +are extended with the appropriate suffix, if they lack one. +.\"===================================================================== +.SH OPTIONS +Without the +.B \-verbose +option, +.B vptovf +operates silently. With it, a banner and progress report are printed on +.IR stdout . +.\"===================================================================== +.SH "SEE ALSO" +.BR pltotf (1), +.BR tftopl (1), +.BR vftovp (1). +.\"===================================================================== +.SH AUTHORS +Donald E. Knuth wrote the program, based in part on an idea of David Fuchs, +starting with the code for +.BR pltotf (1). +Karl Berry adapted it for compilation with +.BR web2c . diff --git a/Build/source/texk/web2c/man/weave.man b/Build/source/texk/web2c/man/weave.man new file mode 100644 index 00000000000..b87cb84ff45 --- /dev/null +++ b/Build/source/texk/web2c/man/weave.man @@ -0,0 +1,77 @@ +.TH WEAVE 1 "4 May 1993" "Web2C @VERSION@" +.\"===================================================================== +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.if n .ds TX TeX +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.\" the same but obliqued +.el .ds OX TeX for nroff +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff +.\" BX definition must follow TX so BX can use TX +.if n .ds BX BibTeX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.\" LX definition must follow TX so LX can use TX +.if n .ds LX LaTeX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds WB Web +.if t .ds WB W\s-2EB\s0 +.\"===================================================================== +.SH NAME +weave \- translate WEB to TeX +.SH SYNOPSIS +.B weave +[ +.B \-x +] +.I webfile[.web] +[ +.I changefile[.ch] +] +.\"===================================================================== +.SH DESCRIPTION +This manual page is not meant to be exhaustive. The complete +documentation for this version of \*(TX can be found in the info file +or manual +.IR "Web2C: A TeX implementation" . +.PP +The +.B weave +program is used to create a \*(TX file for viewing a \*(WB program. +It takes appropriate care of typographic details like page +layout and the use of indentation, italics, boldface, etc., and it supplies +extensive cross-index information that it gathers automatically. +The command line arguments are the same as for +.B tangle +except for the option: +.B \-x +says to omit the index, module name list, and table of contents pages. +(A +.I CONTENTS.tex +file will still be written when the \*(TX file is processed, +however, unless some macros in +.I webmac.tex +are redefined.) +.PP +The output \*(TX file name is formed by adding +.I .tex +to the root of the \*(WB file name. +.PP +There are several macros +that probably should be redefined by +the programmer at the beginning of the \*(WB file. +It is a good idea to set \\title +to the name of the program. +And, to cause output of only changed modules, one can say +\\let\\maybe=\\iffalse (usually as the first change in the +change file). +.\"===================================================================== +.SH FILES +.TP \w'@@'u+2n +.I $TEXMFMAIN/tex/plain/base/webmac.tex +\*(TX macros used by +.B weave +output. +.\"===================================================================== +.SH "SEE ALSO" +.BR tangle (1) +for references, authors, and other information. diff --git a/Build/source/texk/web2c/man/win32.mak b/Build/source/texk/web2c/man/win32.mak new file mode 100644 index 00000000000..969dd0ce05a --- /dev/null +++ b/Build/source/texk/web2c/man/win32.mak @@ -0,0 +1,72 @@ +################################################################################ +# +# Makefile : Web2C / man +# Author : Fabrice Popineau <Fabrice.Popineau@supelec.fr> +# Platform : Win32, Microsoft VC++ 6.0, depends upon fpTeX 0.5 sources +# Time-stamp: <03/02/19 17:37:40 popineau> +# +################################################################################ +root_srcdir = ..\..\.. +!ifdef DEVELOPMENT +INCLUDE=$(INCLUDE);$(root_srcdir)\texk.development +!else +INCLUDE=$(INCLUDE);$(root_srcdir)\texk +!endif + +!include <msvc/common.mak> + +localmodes = modes + +# If you like, delete the man pages for programs you aren't installing. +# The programs are listed in alphabetical order. +# +manfiles= \ + amstex.1 \ + bibtex.1 \ + dmp.1 \ + dvicopy.1 \ + dvitype.1 \ + eplain.1 \ + etex.1 \ + gftodvi.1 \ + gftopk.1 \ + gftype.1 \ + latex.1 \ + makempx.1 \ + mf.1 \ + mft.1 \ + mpost.1 \ + mpto.1 \ + newer.1 \ + omega.1 \ + patgen.1 \ + pdftex.1 \ + pktogf.1 \ + pktype.1 \ + pltotf.1 \ + pooltype.1 \ + tangle.1 \ + tex.1 \ + tftopl.1 \ + vftovp.1 \ + vptovf.1 \ + weave.1 \ + tie.1 + +default all: man + +tie.1: ..\tiedir\tie.1 + if not exist tie.1 @$(copy) ..\tiedir\tie.1 tie.1 + +cweb.1: ..\cwebdir\cweb.1 + if not exist cweb.1 @$(copy) ..\cwebdir\cweb.1 cweb.1 + +!include <msvc/install.mak> + +!include <msvc/clean.mak> + +# +# Local variables: +# page-delimiter: "^# \f" +# mode: Makefile +# End: |