From e0c6872cf40896c7be36b11dcc744620f10adf1d Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Mon, 2 Sep 2019 13:46:59 +0900 Subject: Initial commit --- support/imaketex/README | 93 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 93 insertions(+) create mode 100644 support/imaketex/README (limited to 'support/imaketex/README') 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 + + + +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. -- cgit v1.2.3