summaryrefslogtreecommitdiff
path: root/obsolete/macros/inrstex/pc/readme.txt
blob: 21db003ce7c164a16c45aab2d977342fcc3fbd84 (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
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258

Michael Ferguson -- Aug. 1991
mike@inrs-telecom.uquebec.ca
(514)765-7834

INRSTeX is a complete document preparation package, including graphics for
document preparation. It was designed from the beginning for use in a
bilingual (French/English) environement. 
The system, excluding its graphics component, is usable
with any TeX system but is most useful, when using ordinary "cm"
fonts with an MLTeX system. TeXGraph will work with any reasonable
PostScript driver ans has been specialized here to work with a modified
modified version of Nelson~Beebe's DVIALW on the IBM~PC and
uses Tom~Rokiki's DVIPS on the UNIX workstations. The PC Version of the
package includes an MSDOS  version of the modified DVIALW. 

The INRSTeX macro package kernel is built on top of PLAIN. All the
facilties of plain are left intact and available. Additional facilities are
included for

* section and chapter heads,
* lists,
* easy tables,
* floating figure and table insertions, 
* footnotes,
* automatic generation of table of contents, list of figures, and
  list of tables, 
* automatic numbering of equations, section heads, etc.,
* symbolic referencing of equations, sections, etc.,
* optional margin notes to aid in keeping track of symbolic
  references, 
* automatic generation of citation lists (IEEE style only)
* a subdocument feature for building large documents in pieces.
* a verbatim style using {\tt typewriter} fonts for such things as
  program listings,
* a several document styles including a paperstyle and  bookstyle.
* TeXgraph, a graphics system for drawing figures and inserting
  external figures. This uses the graphics primitives of PostScript.
  It is inside rather than outside the TeX system.
* slide making including graphics for letterhead, 
Installation Guide for INRSTeX with MLTeX 3.+ or TeX 3.+

-------------------------------------------------------------------

The system is supplied as compressed *.zip files that can be unpacked with
PKUNZIP. The file list is as follows:

README   TXT     7032   8-22-91   7:53a --- This file

DVIALW   TXT     1251   8-23-91  10:43a --- List of command line options
	for DVIALW

INRSTEX  ZIP   117630   8-04-91   7:47a --- INRSTeX sources ... These are
	only needed for creating an INRSTeX format file.
INRSINPU ZIP    36841   8-04-91   7:54a --- This is a complete set of
	additional macros, including the graphics that may be called as 
	needed by INRSTeX. These should be put in your TEXINPUTS directory.
TEXGRAPH ZIP   115632   8-04-91   7:59a --- These are the TeXgraph macros,
	both for INRSTeX and LaTeX. It also the INRS modified includes
	DVIALW.
DOC_TEX  ZIP   201034   8-22-91   8:31p --- These are the TeX source files
	for the INRSTeX Refernce book.
DOC_DVI  ZIP   256912   8-22-91   8:28p --- These are DVI files, for each
	chapter of the Reference Book. The file THGRAPH.DVI is the
	documentation for TeXGraph.
PKZIP    EXE    31408  10-01-89   1:02a 
PKUNZIP  EXE    22022  10-01-89   1:02a
BATCH    ZIP     1532   8-04-91   8:05a --- These are some batch files,
	including INRSTEX.BAT that should be used for invoking INRSTeX.

-----------------------------------------------------------------------





INRSTeX is a multilingual document preparation system. It comes in many
flavors, unfortunately, and is easily customized. The main documentation is
the "INRSTeX Reference Manual". The graphics part of INRSTeX requires a
driver that will interpret inline PostScript correctly and process the
information in the *.dvi file in the order that it occurs. An INRS modified
version of Nelson Beebe's DVIALW driver does this  and is included with the
TeXGraph files. The only documentation of TeXGraph at the moment is in the
detailed comments in the texgraph.sty file. This requires that your print
driver be able to interpret a few commands. Plot files are assumed to be
Encapsulated PostScript with a correct bounding box. TeXGraph reads this
box and leaves the appropriate space. It is also possible to rotate and/or
scale a graph. 


INRSTeX as supplied gives messages in English and French. These messages
should be changed for other languages. Most of the messages are found in 
inrsdef.tex 


Customizing INRSTeX

Different flavors of INRSTeX are needed for different operating systems and
versions of TeX. Changes are made by editing the file inrs.tex or one of the
specialized files. These files are very heavily documented ... to make
changes easier. The master file inrs.tex brings in the specialized files for
various services. In some cases, this file must be editied to bring in the
correct version of the file for a particular installation. A good example is
given below for fonts. 

Customizing changes may be necessary in the following areas:

1. Fonts

TeX 3.0 uses Computer Modern (cm...) fonts. This version of INRSTeX does not
require the new 256 character extended fonts. Modifications to include
these fonts should be quite easy when they become available.  The current
INRSTeX book was made with (am...) fonts and includes many fonts that are
not available on the current distribution. INRSTeX, in addition to defining
point families, adds fonts necessary to complete font families at various
point sizes. It may be necessary to add/delete fonts and font families for
your specific installation. 

In addition there is a file spfont.tex that defines an arbitrarily scaled
family of \tenpoint. It is used only in the slide package and is the
(cm...) version only. Some TeX distribution tapes do not have diminished
pixel versions of the fonts. 

2. File Naming:

INRSTeX writes out a number of auxiliary files. They have the same name as
the input file but with different extensions. These are used to create
tables of contents, figures, tables, .... The design is such that the page
numbers for the "table of contents", for example may be in the table of
contents. If INRSTeX has already opened the "job.toc" file and then tries
to bring in the "job.toc" file to write the table of contents, it will
bring in the previous version. For systems without versions, such as MSDOS
or Unix, this is done by inputting files with the name "@job.toc" or
"job.toc~" respectively. This means that INRSTeX must be invoked using an
INRSTEX.BAT file for MSDOS or a shell script like INRSTEX.SH for Unix.

To build an INRSTeX format file for MSDOS, it is necessary to 

\input writdos 

This is included in the INRS3_PC.TEX master file. 

For Unix, the \input writdos should be replaced by 

\input writunix 

For systems with version numbers, and the concept of version "-1" such as
VAX/VMS, neither of these are required.  

The auxiliary files normally written have the extensions: 

.toc -- table of contents
.tbl -- list of tables
.fig -- list of figures
.ctg -- list of citations
.tag -- list of internal references such as equations or sections

In addition, for the INRSTeX reference manual a chapter status file and
an index file

masth.sta 
masth.ind

are written. 


3. inrsdef.tex

All of the default spacings, fonts, etc. for INRSTeX are given in this file.
For information this file also includes any defaults set in PLAIN. Those
defaults may be changed in this file. In fact, it was intended that all of
the defaults would be found in this file. 

4. Graphics and INRSTeX

This version of INRSTeX includes TeXGraph, a system for creating graphics
and including EPSF (Encapsulated PostScript Format) files in a TeX
document. In order to make the package self contained, we have included a
modified version of Nelson Beebe's DVIALW (for MSDOS only). 
This, along with a PostScript printer will allow you to produce "complete"
documents.


5. Installation: 

To create a format file for INRSTeX, with French and English hyphenation
patterns, you should INITEX the inrs3_pc file. inrs3_pc brings in a version
of plain.tex, called plain_nh.tex that does not call the hyphenation
tables. The hyphenation tables are called later in masthyph.tex. 

The inrs3_pc.tex file has a switch that checks to see if \charsubdef is
defined in the INITEX to distinguish between MLTeX 3.+ and TeX 3.+. It then
brings in the appropriate files to access and define extended characters.

If necessary, you might have to increase some of TeX's internal parameters
such as font memory. For TeX 2.+, it was necessary to have \f 25000 when
invoking PCTeX. 

6. Documentation

The INRSTeX reference manual is included on these floppies. It is over 200
pages longs so that printing it all at once might either break your printer
and/or cause you to be accused of antisocial behaviour. 

The complete sources and a complete set of .DVI files are included in the
\inrsdoc directory in .ZIP compressed form. Both PKZIP and PKUNZIP are
included. They have been supplied as approximately one chapter per file. To
obtain the .DVI files just type

pkunzip doc_dvi

The uncompressed .dvi files are approximately 1 megabyte. This set also
includes IEEELOGO.PS which is needed to create the corresponding .PS files.
To create the corresponding PostScript files just execute MASTPS.BAT 

mastps 

The PostScript files take up about 3.5 meg while the uncompressed .DVI
files take up about 1 meg. 

In addition, the complete sources for the Reference Book are included. 
These are uncompressed by 

pkunzip doc_tex

To create a new set of .dvi files, if you should follow this path. 

a) Tex the master file masth.tex to create a complete set of index,
status, and table of contents files by 

tex masth

b) Massage and sort the index file MASTH.IND to create a MASTH.SOR by
running the program 

indsort

The C sources for this program are included. 

c) Create .dvi files for each chapter by running the MASTH.BAT file. 

masth

d) Create the PostScript files by running the MASTPS.BAT file.

mastps

e) To print the all of the resulting files use the MASTPR.BAT file. 

mastpr

This, after feeding paper to your printer will give you the complete book.

Yours 
Michael J. Ferguson