summaryrefslogtreecommitdiff
path: root/support/imaketex/README
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /support/imaketex/README
Initial commit
Diffstat (limited to 'support/imaketex/README')
-rw-r--r--support/imaketex/README93
1 files changed, 93 insertions, 0 deletions
diff --git a/support/imaketex/README b/support/imaketex/README
new file mode 100644
index 0000000000..5448334e13
--- /dev/null
+++ b/support/imaketex/README
@@ -0,0 +1,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.