summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/man/man1/tangle.1
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf/doc/man/man1/tangle.1')
-rw-r--r--Master/texmf/doc/man/man1/tangle.1173
1 files changed, 0 insertions, 173 deletions
diff --git a/Master/texmf/doc/man/man1/tangle.1 b/Master/texmf/doc/man/man1/tangle.1
deleted file mode 100644
index a89f1726c41..00000000000
--- a/Master/texmf/doc/man/man1/tangle.1
+++ /dev/null
@@ -1,173 +0,0 @@
-.TH TANGLE 1 "1 March 2011" "Web2C 2012"
-.\"=====================================================================
-.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 ]
-.IR webfile [ \fB.web\fP ]
-.RI [ changefile [ \fB.ch\fP ]]
-.\"=====================================================================
-.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
-.B .web
-is added if there is no
-extension).
-If there is another name, it is a change file (and
-.B .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
-.B .p
-and
-.B .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
-Print help message and exit.
-.TP
-.BI --length \ number
-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
-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
-Convert all identifiers to lowercase.
-.TP
-.B --mixedcase
-Retain the case of identifiers. This is the default.
-.TP
-.B --strict
-When checking for collisions between identifiers, strip underlines and
-convert all identifiers to uppercase first.
-.TP
-.B --underline
-Retain underlines (also known as underscores) in identifiers.
-.TP
-.B --uppercase
-Convert all identifiers to uppercase. This is the behaviour of the
-original
-.BR tangle .
-.TP
-.B --version
-Print version information and exit.
-.\"=====================================================================
-.SH ENVIRONMENT
-The environment variable WEBINPUTS is used to search for the input files,
-or the system default if WEBINPUTS is not set. See
-.BR tex (1)
-for the details of the searching.
-.\"=====================================================================
-.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.