summaryrefslogtreecommitdiff
path: root/systems/os2/README.commontex
blob: d2bf651bd10423ab06b72a549b7cb44efda282ad (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
This is a port of Common TeX 3.3 for OS/2 using EMX-0.8f.

See the file COPYING for rights, responsibilities, and limitations.

One of the best TeX implementations around is EmTeX.  However, it has
one "feature" that doesn't utilize the full capabilities of OS/2,
especially when HPFS is used: long file names are not accepted.  This
port of Common TeX does not have this restriction.

Features and Limitations
------------------------

Some limitations of Common Tex:

	o Parts from EmTeX like the tfm and tex input files are
	  needed.  The DVI programs from EmTeX will also be need if
	  you want to see actual output.  


Here are some basic features of Common TeX:

	o Supports long file names on HPFS partitions.
	o Will not give "TeX out of memory" errors until you run out
	  of virtual memory.
	o Preloads formats, which (marginally) speeds up loading.
	o Doesn't need TeX format files.
	o Runs about twice as fast as btexp.

Installation
------------
Be sure to put the dll directory of this archive in your LIBPATH!!!
You can install the executables anywhere.  Then set the environment
variables TEXFONTS and TEXINPUTS.  If you have EmTeX, make TEXINPUTS
the same as TEXINPUT and TEXFONTS the same as TEXTFM.  However, you
must include the drive letter and replace all backslashes with forward
slashes.  For example, if you have

	set EMTEXDRV=f
	set TEXINPUT=.;\emtex\texinput
	set TEXTFM=.;\emtex\tfm;\emtex\fonts\tfm

then do

	set TEXINPUTS=.;f:/emtex/texinput
	set TEXFONTS=.;f:/emtex/tfm;f:/emtex/fonts/tfm

Usage
-----

If you want to run LaTeX, use

	latex texfile

You do not need to specify "^&lplain".  Typically, the equivalent
EmTeX command would be "btexp ^&lplain texfile".

For TeX plain format, use "tex".  This is equivalent to "btexp
^&plain" in EmTeX.

To create (or update) your own formats, give the following commands:

	initex mystyle \dump
	emxbind -x initex.exe a.out
	emxbind -ccore /emx/bin/emxl.exe mytex.exe
	del core
	del a.out

Your format is "mystyle" and the resulting command is "mytex.exe"
which will have "mystyle" preloaded.  Of course, to do this you need
emxbind to do this.

Recommendations
---------------

Get a copy of EmTeX first.  Follow the instructions that come with
EmTeX and make it work first.  Then install Common TeX.