summaryrefslogtreecommitdiff
path: root/systems/vtex/linux/readme-linux.eng
blob: c0395d191249e1eb5e132ae702a3c843f11aca2e (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
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
============================================================
Installation instructions for VTeX/Free 8.44.2 on Linux x86
                    ( = VTeX/Lnx 8.46a)
============================================================
                                                  2005-02-11
                                              Walter Schmidt



Contents
--------
  What is VTeX/Lnx?
  Prerequisites
  Required files
  Installing VTeX/Lnx
  Deleting obsolete files
  Installing the Adobe Euro fonts
  Creating the LaTeX format file
  Creating the plain TeX format file
  Documentation 
  Known bugs
  Support
  Legal stuff



What is VTeX/Lnx?
-----------------
VTeX/Lnx is a TeX program for Linux(x86) that generates PDF
or PostScript output immediately from the TeX source file.
It comes with a basic LaTeX system, including many
additional packages and fonts, as well as the Bibtex and
Makeindex programs.  Plain TeX is also included.  

In contrast to traditional TeX systems, no intermediate DVI
files need to be generated, no "dvi driver programs" are
required, and there is no need to take care of their --
sometimes fussy -- setup.

In contrast to pdfTeX, VTeX includes a full PostScript
interpreter, so that inclusion of EPS images as well as
inline PostScript programming, i.e., PSTricks, psfrag etc.
are fully supported,

The common PostScript and PDF viewers GSView and Adobe
Reader can be used for (pre)viewing and printing.

Output files from VTeX are immediately suitable for public
distribution, e.g., over the WWW, since PostScript and PDF
are standardized document formats -- as opposed to the
TeX-specific DVI format.  

The VTeX engine supports the eTeX extensions.



Prerequisites
-------------
VTeX/Lnx requires Linux on the Intel (x86) platfom and at
least 16Mb of physical memory.

VTeX/Lnx is an ELF executable requiring the "glibc"
libraries.

You must have installed Ghostscript, so as to provide a
PostScript and PDF reader.

It is highly recommended to provide also Adobe Reader,
because this is the "canonical" PDF reader, and because
certain hypertext features of the PDF format are not
supported by Ghostscript.  Make sure to use version 4.05 or
later!

VTeX/Lnx is to be installed on an ext2 filesystem, because
it makes use of long file names.  The complete TeX system
will require about 80MB of disk space.

|  VTeX/Lnx has been reported not to run on a freshly
|  installed SuSE Linux 9.1.  As a workaround put the
|  following command into /etc/profile.local or into
|  ~/.bashrc
|
|     export LD_ASSUME_KERNEL=2.4.1
|  
|  or, with the tcsh shell, say 
|
|     setenv LD_ASSUME_KERNEL 2.4.1
|
|  If you experience any further problems running VTeX/Lnx
|  with your Linux, please, report to the maillist, so we
|  can try to provide a workaround.



Required files
--------------

  vtexlnx-8442.zip
  vtex-base-8442.zip
  vtex-base2-8442.zip
  vtex-special-8442.zip
  vtex-fonts-8442.zip
  vtex-fonts2.zip
  vtex-doc-8422.zip 
  vtex-cbfonts.zip                      (optional)
  vtex-gex.zip                          (optional)
  vtex-koma.zip                         (optional)
  vtex-sem.zip                          (optional)

Remarks:

vtex-gex.zip is unchanged since v7.320.  vtex-fonts2.zip is
unchanged since v7.53.  You need not download them once 
again, if you have them already.

vtex-cbfonts.zip contains the Greek Computer Modren fonts, 
aka "CB fonts".  Omit this archive, if you do not intend to 
use them.

vtex-gex.zip includes the documentation of VTeX's built-in
PostScript interpreter; omit this file, if you want.  

The archive vtex-koma.zip includes the "KOMA-Script"
document classes for use with LaTeX.  In case you have
already installed these document classes yourself, or if you
don't intend to use them, omit this archive.

The archive vtex-sem.zip includes the LaTeX packages seminar
and prosper; you need not install it, unless you actually
want to use these packages. 

Optional files can be installed later, by simply unpacking 
the archives in directory /usr/local.



Installing VTeX/Lnx
-------------------

(0)

Any installed version of VTeX _prior_ to 7.10 is to be
entirely removed.  Later versions, however, can be updated
automatically.


(1)

In case you are already running a previous version of
VTeX/Lnx and have customized the following configuration
files, you should back up the files now:

/etc/vtex.ini
/usr/local/vtex/texmf/vtex/config/pdf.fm
/usr/local/vtex/texmf/vtex/config/ps.fm
/usr/local/vtex/texmf/vtex/config/hyphen.cfg
/usr/local/vtex/texmf/vtex/config/plain.cfg

| They will be overwritten in course of the subsequent
| installation procedure; please, check your settings
| against the new files afterwards!

| If you have previously installed the "CB fonts" package
| from <http://home.vr-web.de/cb4vtex>, do not add the
| record for cb.ali to the .fm files again.  
| Rationale:  Records for the CB fonts are now part of the
| default configuration, see the file cm.ali.


(2)

Unzip vtexlnx.zip in the directory /usr/local/vtex.
[Create, this directory, if it does not yet exist

  cd /usr/local
  mkdir vtex
]
  cd vtex
  unzip <path>/vtexlnx-8442

Doing so will create several subdirectories:  When updating
a previously installed VTeX, the unzip program will ask you
whether to overwrite existing files:  Enter "A" (i.e, "all
files").  This holds also for the next step.

|  Alternatively, you may install VTeX in a different
|  directory than /usr/local.  In this case, notice 
|  subsection (6) below!
 

(3)

Unzip the remaining ZIP files in the directory
/usr/local/vtex:

  unzip <path>/vtex-base-8442
  unzip <path>/vtex-base2-8442
  unzip <path>/vtex-special-8442
  unzip <path>/vtex-fonts-8442
  unzip <path>/vtex-doc-8442
  unzip <path>/vtex-fonts2
  unzip <path>/vtex-cbfonts
  unzip <path>/vtex-gex
  unzip <path>/vtex-koma
  unzip <path>/vtex-sem

Doing so will create a directory named texmf with several
subdirectories.


(4)
When installing over a previous release, certain obsolete
files may not be overwritten automatically during the above
steps, because they reside in other directories now or have
been renamed or abolished.  They need to be deleted manually
now.

Make sure that /usr/local/vtex is still the current
directory; then execute the Makefile install/cleanup.lnx
there:

  make -f install/cleanup.lnx


(5)
When VTeX/Lnx is installed for the first time, copy vtex.ini
from /usr/local/vtex/install to the directory /etc.  This is
the main configuration file, which can be customized -- see
section 2.2 of the VTeX/Free manual.  Do not remove the
unchanged "template" from the vtex/install directory!


(6)
In case you have installed VTeX in a different directory 
than /usr/local, you need either 

  to create a link /usr/local/vtex -> /your_install_dir/vtex
  
or

  edit the files etc/vtex.ini and texmf/vtex/config, and 
  replace every occurrence of /usr/local with the absolute 
  path to your install directory; note that you cannot use
  environment variables such as $HOME in these files.


(7)

When VTeX/Lnx is installed for the first time:  
Add /usr/local/vtex/bin to your $PATH .


(8)
Make sure that all of the texmf directory tree is readable
for everyone:

  chmod -R a+r /usr/local/vtex/texmf/*




Creating the LaTeX format file
------------------------------
Open a command line shell in an arbitrary working directory
(however, not inside the TeX directory tree) and execute the
following shell script:

  makevlatex

You should move the log file latex.log to the directory
/usr/local/vtex/fmt, so as to store it with the format file.

If there is a complaint in the log file about "BAD file
texsys.aux", then you have to delete any file texsys.aux
which may exist

  in the current directory, 
  or in the directory /usr/local/vtex/texmf/tex/latex/base
  or in the directory /usr/local/vtex/texmf/vtex/config 
  
and try again.

Make sure that the generated format file is readable for
everyone:

  chmod -R a+r /usr/local/vtex/fmt/*

Now you should check, whether the installation works:  Run
the file ltxcheck.tex through LaTeX, thus making sure that
the installation works.  The file resides in the directory
texmf/source/latex/base.  Switch to this directory

  cd /usr/local/vtex/texmf/source/latex/base
       
and execute the following command:

  vlatex ltxcheck
       
This will produce a number of messages, each of which should
be "OK".



Creating the plain TeX format file
----------------------------------
Omit this step, if you don't know what "plain TeX" is!

Execute the following command in an arbitrary working 
directory (however, not inside the TeX directory tree):

  makevplain

You should move the log file plain.log to the directory
/usr/local/vtex/fmt, so as to store it with the format file.
Make sure that the generated format file is readable for
everyone:

  chmod -R a+r /usr/local/vtex/fmt/*



Documentation
-------------
See the files in the directory texmf\doc\vtex:

local.eng        Preliminary LaTeX Local Guide
                 (READ THIS FIRST!)
plain.eng        plain TeX Local Guide
                 (ignore it, if you don't know
                 what "plain TeX" is)
vtex.pdf         The VTeX/Free manual
etex_man.pdf     eTeX manual
gex.pdf          GeX Manual
mm_man.pdf       How to use MM fonts with VTeX
forms.pdf        How to use PDF forms from TeX
animgif.pdf      How to include animated GIFs into
                  PDF documents
examples/*       Sample documents

The sample file tryanim.tex and part of the examples in the
document animgif.pdf may not work with Acrobat Reader 5 or
later, due to the "features" of the latest Acrobat.  They
do, however, work with Acrobat 4 and (almost) with Acrobat
Reader 3 on OS/2.


Known bugs and problems
-----------------------
The Bibtex and Makeindex programs cannot search recursively
for database and style files (.bst, .bib, .ist).  However,
all such files that come with the distribution, _are_ found.
Note that this affects only the Linux version!



Support
-------
The NTG hosts a mailing list that can be used both to ask
questions and to report bugs in the software and/or
installation.  The list has a web interface for subscribing,
unsubscribing, accessing the archives etc:

  <http://www.ntg.nl/mailman/listinfo/ntg-vtex>



Legal stuff
-----------
MicroPress and VTeX are trademarks of MicroPress, Inc.  
The MicroPress' components of the VTeX/Lnx distribution are

  Copyright (C) 1998--2005 by MicroPress Inc.

The MicroPress' components of the VTeX/Lnx distribution are
free for personal use, subject to the following restriction:
Redistribution is allowed only as a part of the complete
VTeX/Lnx system, and only if all of the following files
remain unchanged and are distributed as a whole:

  readme-linux.eng
  vtexlnx-8442.zip      
  vtex2-8442.zip        
  vtex-base-8442.zip    
  vtex-base2-8442.zip   
  vtex-special-8442.zip 
  vtex-fonts-8442.zip   
  vtex-fonts2.zip       
  vtex-doc-8422.zip     
  vtex-cbfonts.zip      
  vtex-gex.zip          
  vtex-koma.zip         
  vtex-sem.zip          
      

Adobe, Acrobat and PostScript are trademarks of Adobe
Systems Incorporated.


== finis