Penguin
Recent Changes
Annotated edit history of otangle(1) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 TANGLE
2 !!!TANGLE
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 SEE ALSO
7 AUTHORS
8 ----
9 !!NAME
10
11
12 tangle - translate WEB to Pascal
13 !!SYNOPSIS
14
15
16 __tangle__ ''webfile[[.web]'' [[ ''changefile[[.ch]''
17 ]
18 !!DESCRIPTION
19
20
21 This manual page is not meant to be exhaustive. The complete
22 documentation for this version of TEX can be found in the
23 info file or manual ''Web2C: A TeX
24 implementation''.
25
26
27 The __tangle__ program converts a W EB
28 source document into a Pascal program that may be compiled
29 in the usual way with the on-line Pascal compiler (e.g.,
30 pc(1)). The output file is all in lower case and
31 packed into lines of 72 characters or less, with the only
32 concession to readability being the termination of lines at
33 semicolons when this can be done conveniently.
34
35
36 The W EB language allows you to prepare a
37 single document containing all the information that is
38 needed both to produce a compilable Pascal program and to
39 produce a well-formatted document describing the program in
40 as much detail as the writer may desire. The user of W
41 EB must be familiar with both TEX and Pascal.
42 W EB also provides a relatively simple,
43 although adequate, macro facility that permits a Pascal
44 program to be written in small easily-understood
45 modules.
46
47
48 The command line should have either one or two names on it.
49 The first is taken as the W EB file (and
50 ''.web'' is added if there is no extension). If there is
51 another name, it is a change file (and ''.ch'' is added
52 if there is no extension). The change file overrides parts
53 of the W EB file, as described in the W
54 EB system documentation.
55
56
57 The output files are a Pascal file and a string pool file,
58 whose names are formed by adding ''.p'' and ''.pool''
59 respectively to the root of the W EB file
60 name.
61 !!SEE ALSO
62
63
64 pc(1), pxp(1) (for formatting __tangle__
65 output when debugging), tex(1).
66
67
68 Donald E. Knuth, ''The W EB System of
69 Structured Documentation''.
70
71
72 Donald E. Knuth, ''Literate Programming'', Computer
73 Journal __27__, 97-111, 1984.
74
75
76 Wayne Sewell, ''Weaving a Program'', Van Nostrand
77 Reinhold, 1989, ISBN 0-442-31946-0.
78
79
80 Donald E. Knuth, ''TEX: The Program'' (Volume B of
81 ''Computers and Typesetting''), Addison-Wesley, 1986,
82 ISBN 0-201-13437-3.
83
84
85 Donald E. Knuth, ''M ETAFONT : The
86 Program'' (Volume D of ''Computers and Typesetting''),
87 Addison-Wesley, 1986, ISBN 0-201-13438-1.
88
89
90 These last two are by far the largest extant examples of W
91 EB programs.
92
93
94 There is an active Internet electronic mail discussion list
95 on the subject of literate programming; send a subscription
96 request to ''litprog-request@shsu.edu'' to
97 join.
98 !!AUTHORS
99
100
101 W EB was designed by Donald E. Knuth, based
102 on an earlier system called DOC (implemented by Ignacio
103 Zabala). The __tangle__ and __weave__ programs are
104 themselves written in W EB . The system was
105 originally ported to Unix at Stanford by Howard Trickey, and
106 at Cornell by Pavel Curtis.
107 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.