Skip to content

Commit 69d7d4a

Browse files
larrykollarlarrykollar
committed
Initial upload.
1 parent c093092 commit 69d7d4a

1 file changed

Lines changed: 99 additions & 2 deletions

File tree

‎README.md‎

Lines changed: 99 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,99 @@
1-
# Unix-Text-Processing
2-
Recreated sources for the book "UNIX Text Processing," published in 1987.
1+
# <img alt="Original book cover" href="unixtextprocess_s.gif" align="right"/>Unix Text Processing
2+
3+
<div style="text-align:right">
4+
*UTP is one of the best books on Unix from a user's perspective.*
5+
-- Jack Redman
6+
</div>
7+
8+
Originally published in 1987,
9+
Unix Text Processing (UTP) (written by Dale Dougherty and Tim O'Reilly)
10+
provides one of the few comprehensive looks at all the tools
11+
involved in a typical *troff*-based writing workflow.
12+
It covers:
13+
14+
- UNIX and *troff* basics
15+
- text editors (*vi*, *ex*, and *sed*)
16+
- the *ms* and *mm* macro packages
17+
- scripting with *sh*, *awk*, and *sed*
18+
- the *tbl*, *eqn* and *pic* preprocessors
19+
- macro writing
20+
21+
The appendices provide a collection of reference material and other
22+
useful pointers.
23+
24+
UTP was originally published by Hayden Books (which was acquired by
25+
Howard W. Sams before the book was actually published).
26+
In the early 21^st^ century, the authors made the book available at
27+
the [Open Books Project](http://www.oreilly.com/openbook/)
28+
under the Creative Commons
29+
[Attribution License](http://creativecommons.org/licenses/by/1.0).
30+
Scanned pages are [available](ftp://ftp.oreilly.com/pub/utp/) in
31+
PBM (Portable BitMap) and PDF formats.
32+
The original [troff](http://troff.org/) markup is lost.
33+
34+
In 2002,
35+
some members of the [GNU Troff](https://www.gnu.org/software/groff/)
36+
(*groff*) mailing list
37+
began transcribing the book and recreating the source code.
38+
It took a little over a year of manic activity,
39+
punctuated by long naps,
40+
and we released "UTP Revival" in 2004.
41+
We still hope to modernize the book ("UTP Revisited").
42+
Whether you want to use GNU Troff,
43+
or Plan 9 or one of its derivatives (Heirloom Troff and Neatroff),
44+
UTP is still an excellent guide to the nuts and bolts of print publishing.
45+
46+
The UTP Revival Release is
47+
distributed according to the terms of the
48+
Creative Commons Attribution License.
49+
A copy of the license is available at
50+
[http://creativecommons.org/licenses/by/1.0](/http://creativecommons.org/licenses/by/1.0).
51+
52+
**Note**: The transcription project predated Plan 9 and its derivatives.
53+
Thus, the recreated source and macros were written for *groff*,
54+
and we made no attempt to be compatible with the original *troff*.
55+
Patches for Heirloom or Neatroff (if needed) are welcome!
56+
57+
------------------------------------------------------------------------
58+
59+
## Acknowledgements
60+
61+
- First, a big thanks to the original authors
62+
for making the book available in the first place.
63+
Nothing else could have happened without that first step.
64+
- Jon Snader provided the scripts to build the table of contents.
65+
- Michael Hobgood and Andreas Kähäri handled proofreading chores.
66+
- Deri James added PDF links for the contents and index.
67+
68+
Individuals who worked on various chapters:
69+
70+
| Chapter Title | Transcriber | Markup | Indexing |
71+
|-------------------------------------|---------------------|---------------------|---------------------|
72+
| Front matter | Ralph Corderoy | Ralph Corderoy | n/a |
73+
| Preface | Stewart Russell | Larry Kollar | n/a |
74+
| From Typewriters to Word Processors | Stewart Russell | Michael Hobgood | Michael Hobgood |
75+
| UNIX Fundamentals | Stewart Russell | Michael Hobgood | Heinz-Jürgen Oertel |
76+
| Learning vi | Heinz-Jürgen Oertel | Heinz-Jürgen Oertel | Jack Redman |
77+
| nroff and troff | Colin Watson | Michael Hobgood | Heinz-Jürgen Oertel |
78+
| The ms macros | Larry Kollar | Larry Kollar | Larry Kollar |
79+
| The mm macros | Larry Kollar | Larry Kollar | Larry Kollar |
80+
| Advanced Editing | Heinz-Jürgen Oertel | Heinz-Jürgen Oertel | Jack Redman |
81+
| Formatting with tbl | Michael Hobgood | Michael Hobgood | Michael Hobgood |
82+
| Typesetting Equations with eqn | Michael Hobgood | Michael Hobgood | Jack Redman |
83+
| Drawing Pictures | Michael Hobgood | Michael Hobgood | Jack Redman |
84+
| A Miscellany of UNIX Commands | Manas Laha | Manas Laha | Manas Laha |
85+
| Let the Computer do the Dirty Work | Larry Kollar | Larry Kollar | Larry Kollar |
86+
| The awk Programming Language | Larry Kollar | Larry Kollar | Jack Redman |
87+
| Writing nroff and troff Macros | Michael Hobgood | Michael Hobgood | |
88+
| Figures and Special Effects | Michael Hobgood | Michael Hobgood | Larry Kollar |
89+
| What's in a Macro Package? | Michael Hobgood | Michael Hobgood | |
90+
| An Extended ms Macro Package | Michael Hobgood | Michael Hobgood | |
91+
| Putting it All Together | Michael Hobgood | Michael Hobgood | Michael Hobgood |
92+
| Editor Command Summary | Heinz-Jürgen Oertel | Heinz-Jürgen Oertel | Heinz-Jürgen Oertel |
93+
| Formatter Command Summary | Manas Laha | Manas Laha | Manas Laha |
94+
| Shell Command Summary | Ralph Corderoy | Ralph Corderoy | |
95+
| Format of troff Width Tables | Ralph Corderoy | Ralph Corderoy | |
96+
| Comparing mm and ms | Ralph Corderoy | Ralph Corderoy | |
97+
| The format Macros | Ralph Corderoy | Ralph Corderoy | |
98+
| Selected Readings | Ralph Corderoy | Ralph Corderoy | |
99+

0 commit comments

Comments
 (0)