summaryrefslogtreecommitdiff
path: root/obsolete/macros/inrstex/pc/readme.txt
diff options
context:
space:
mode:
Diffstat (limited to 'obsolete/macros/inrstex/pc/readme.txt')
-rw-r--r--obsolete/macros/inrstex/pc/readme.txt258
1 files changed, 258 insertions, 0 deletions
diff --git a/obsolete/macros/inrstex/pc/readme.txt b/obsolete/macros/inrstex/pc/readme.txt
new file mode 100644
index 0000000000..21db003ce7
--- /dev/null
+++ b/obsolete/macros/inrstex/pc/readme.txt
@@ -0,0 +1,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
+
+
+ \ No newline at end of file