summaryrefslogtreecommitdiff
path: root/support/imaketex/README
blob: 5448334e13279b16d410f2c4531e237c7e0edf4f (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


                     I m a k e - T e X   1 . 0 0
                     ===========================

                     Copyright 1993 Rainer Klute
                <klute@irb.informatik.uni-dortmund.de>


This is Imake-TeX, an Imake support for creating documents with the TeX
typesetting system and the LaTeX macro package. It helps you in using TeX (not
in installing) it.

With Imake-TeX, you will never again have to fiddle around with calling latex
and its various utility programs (makeindex, bibtex). Simply type "make" and
your document's DVI file will be up-to-date. All you have to do is to write a
simple Imakefile and let Imake generate a suitable Makefile for you. Here is
such an Imakefile:

	#include "TeX.tmpl"
	PaperFormatA4()
	SimpleLatexTarget(document)

The generated Makefile provides the following commands:

    make depend:    Searching the TeX source files for dependencies like
                    \input{somefile}

    make dvi:       Generate an up-to-date DVI file

    make viewdvi:   Display it on your screen

    make ps:        Generate a PostScript version of your document

    make viewps:    Display it

    make clean:     Remove unnecessary things

    make veryclean: Remove even the DVI file

    make Makefiles: Generate Makefiles in subdirectories


Installation:
-------------

Imake-TeX basically consists of a shell script "texmkmf" (TeX make makefile)
and a template file "TeX.tmpl". Their installation is (of course) performed
with the help of Imake. You should proceed as follows:

1. Edit the configuration file Imake-TeX.cf as needed.

2. Create an initial Makefile. You have to do this in two steps:

   2.1 Type the command "xmkmf". It will issue an error message ("Can't find
       include file TeX.tmpl"), but it will also display the imake command it
       tried to execute. This will be useful in the following step.

   2.2 Type the imake command as shown the xmkmf output, but add the option
       -DInstallImakeTex before you execute it. For example, on my machine I
       run the command

           imake -DUseInstalled \
                 -I/usr/local/X11R5/lib/X11/config -DInstallImakeTex

3. The command "make install" will make and install the texmkmf and TeX.tmpl at
   their appropriate places. Beware: An error message like

	/bin/sh /usr/bin/X11/mkdirhier.sh /destdir/lib/config 
	/usr/bin/X11/mkdirhier.sh: /usr/bin/X11/mkdirhier.sh: 
	No such file or directory

   indicates that the installation directory (here: /destdir/lib/config) does
   not yet exist and Imake fails to create it because the script mkdirhier.sh
   is missing. The solution is to create the installation directory manually
   and then to rerun "make install".

4. The command "texmkmf -a" replaces the initial Makefile with a full-blown
   one. You will need it to create the Imake-TeX documentation. Don't be
   alarmed when you get some warnings:
       Warning: chapter1.tex not found
       Warning: chapter2.tex not found
       Warning: chapter3.tex not found
       Warning: \([^ not found
       Warning: \([^.tex not found
   These messages are normal. If you wonder about them, look into the
   documentation where the reason is explained.

5. Enter one of "make dvi", "make ps", "make viewdvi", or "make viewps". They
   create the Imake-TeX documentation in DVI resp. PortScript format. The
   "view..." targets display it on your X11 screen.

6. Have fun.