summaryrefslogtreecommitdiff
path: root/macros/text1/docs/readme.tex
blob: 90677f14b9e6cd4940ed43034e2ee0c04148665e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
%  tb27textone.tex
\input tugboat.sty
 
\font\bi=cmbxti10
 
\begingroup
\def\text#1{{\it\TeX T1}}
 
 
\title * {\bi\TeX T1} Goes Public Domain *
\author * Dean Guenther *
\address * Computer Service Center \\
           Washington State University \\
           Computer Science Building \\
           Pullman, WA 99164 *
\netaddress[\network{Bitnet}] *GUENTHER@WSUVM1*
 
\article
 
\text1  is a macro package for use with \plain{} and has been
available for purchase for several years. Beginning in January 1990,
\text1\ went into the \TeX\ public domain collection of macros.
 
In 1983, a decision was made at Washington State University
to put time   into creating a set of macros to be used with \TeX.
This macro set was to provide many of the functions found in \LaTeX:
multiple columns, table of contents, indexing\footnote{$^*$}{The
three different index styles illustrated in Appendix A in
\TUB~{\bf1}(1) can all be achieved with \text1's index.}, chapters, lists,
boxes, margin notes, etc.  Yet there were to be two important differences:
\list[\numbered]
\item The {\tt PLAIN.TEX} commands would be able to be used in
\text1.
\item Modifying the \text1\ formats would be considerably easier than
modifying \LaTeX\ styles.
\endlist
 
The resulting set of macros met the above criteria.  One important
exception was that no attempt was made to give \text1\ a picture
environment such as was in \LaTeX.  The documentation you may
purchase for \text1\
consists of a 300 page Reference Manual and a 100 page Users Guide.
 
\head * Changing the Formats *
 
As an example of how easy it is to modify the \text1\ formats, if the
user wants to increase the bottom margin from 6 to 7 picas, they
can simply specify:
||\pageformat{\bottommargin{7pc}}||
Or if you wanted your running head to contain the chapter title
left-justified and the page number right-justified on odd pages, and
the chapter title right-justified and the page number left-justified
on even pages, you could say:
\verbatim
\runningheadformat{
  \oddpages{\line{\lft{\chaptertitle}
    \rt{\pagenumber}}}
  \evenpages{\line{\lft{\pagenumber}
    \rt{\chaptertitle}}}
  }
\endverbatim
 
For one last example, it is often desirable to change the text embedded
within macros. For example, by default if you say:
||\chapter{Introduction}||
you would get ``Chapter 1'' at the top of the next page in bold, with
``Introduction'' centered below that. If you were using \text1\ in
Germany, you would probably prefer ``Kapitel'' instead of
``Chapter'', so you could change the chapter's format to say:
\verbatim
\chapterformat{
  \titleformat{\newpage
    \centerline{%
        \bf Kapitel \chapternumber}
    \centerline{\bf\chaptertitle}
    \vs{1\bl}
    }
  \incontents{yes}}
\endverbatim
Then in your text you would specify the introduction (first
chapter) as:
||\chapter{Einleitung}||
 
\head * Additional Products *
 
Other products that came out of this pro\-ject and are now going into
the public domain are a typesetter driver for the Compugraphics 8600
and additional fonts.
 
\subhead * Typesetter Driver *
 
The Compugraphics driver is written in \WEB. It has the ability to
add line numbering to the DVI output as it is printed on the 8600.
The program does include some Pascal statements unique to IBM's
Pascal/VS, so a change file would be necessary for any operating
system other than IBM's VM/CMS.
 
\subhead * Additional Fonts *
 
Extra fonts were created from the base Computer Modern. These were
Computer Modern at 11, 12, 14, 18, 24 and 36 point sizes. I do not
know yet if I can call these Computer Modern, but I have asked
Professor Knuth for permission to do so.
 
In addition to the larger Computer Modern fonts, we also created an
International Phonetic Alphabet in 9, 10, 11 and 12 point sizes.  The
IPA font is illustrated at the end of this article.
 
\head * How to get {\bi\text1} *
 
You can get any of the above \text1\ products on diskette or by
anonymous FTP.  Also, I will be distributing \text1\ to the various
site coordinators who can determine whether to place it on their
distribution.
 
To obtain \text1\ on diskette from Jon Radel, send a note to
\address[\display]
Jon Radel \\
P.O. Box 2276 \\
Reston, VA \\
22090-0276
\endaddress
and ask for \text1 (4 disks).  To cover postage and other expenses,
if you are in North America, please enclose \$1.50/disk if you send
blank disks or \$5.00/disk if you don't; if you are anywhere else in
the world, enclose \$2.00/disk if you send blank disks or \$6.00/disk
if you don't.  $\mu$\TeX\ and \PCTeX\ use different directories, so
specify which of these two you are using. If you are using neither of
these, then just specify \PCTeX. You should also specify whether you
want |pk| (3 disks) or |gf| (5 disks) font files for the additional fonts
(these do not include the IPA fonts).
 
You may also request \text1\ for a Macintosh from Jon (1 disk).
It is set up to run with \TeXtures.
 
To order the IPA fonts from Jon,  request the WSU IPA font. This
consists of two diskettes: 1)~the IPA source files and Users Guide,
and 2)~|pk| or |gf| files.
 
To get \text1\ by anonymous FTP, you can connect to 
ftp.wsu.edu.
Log on as
|anonymous|,  and change to the
|/pub/tex/text1| directory. You will see ten   subdirectories which you can GET
files from:
\list[\numbered]
\item |BLOCKS|: this directory contains all of the default formats (or
building ``blocks'' such as the |chapterformat|, |runningheadformat|, etc.)
 
\item |CMS_HELP_FILES|: these are some of the help files used on the
CMS system at WSU. Some sites have taken these files and used them in creating
help files on a PC or on a \VAX.
 
\item |COMPUGRAPHICS_8600|: this is the Compugraphics 8600 phototypesetter
driver program, and its various utilities. Not very much documentation here,
so venture further on your own.
 
\item |FONTS|: This is the source for the additional Computer Modern
fonts generated, such as 11, 14, 18, 24 and 36pt sizes.
 
\item |MACINTOSH|: this contains the index sorting facility used with
\text1. It is written for Turbo Pascal. (The executable binary can
be obtained from Jon Radel if you do not have Turbo Pascal yourself.)
 
\item |MACROS|: this contains the \text1 macros. The file |TEXT1.TEX| is used
with Ini\TeX{} to create a new |fmt|.
 
\item |MODELS|: contains various simple models such as letter, resume,
etc.  It also contains a model (|MERGETXT|) which can be used as a
model for merge letters. For example, you could tell Dbase III to
create an address list, merge it with a standard letter, and using
the model print a
copy for each person.
 
\item |TEXIX|: the sorted index program used with \text1. Presently
the only systems this is running on is CMS and Macintosh. |TEXIX| for
\VAX{} and PC systems is  in the works.
 
\item |VAX_VMS|: when ready, this will have the sorted index for VMS
users.
 
\item |WSUIPA|: This contains the source for the International
Phonetic Alphabet, as well as the |tfm| and |300pk| files.
 
\endlist
 
\head * {\bi\text1} Documentation *
 
The documentation for \text1\ is not free. Pre\-sent\-ly, the
documentation must be ordered through:
\address[\display]
\text1\ Distribution\\
Computing Service Center \\
Washington State University \\
Pullman, WA. 99164-1220
\endaddress
The cost is \$35 for the Reference Manual and \$25 for the Users
Guide.  (Add \$5 postage if outside of the U.S.) The manuals are not
yet available through the \TeX\ Users Group, but I hope to have them
there as soon as I find a publisher.
 
If you have any questions, feel free to send me an email note on Bitnet
at {\tt GUENTHER@WSUVM1} or to {\tt GUENTHER@WSUVM1.WSU.EDU} on
Internet.
 
\makesignature
 
\endgroup
\endarticle