MiKTEX Manual

Revision 2.0 (MiKTEX 2.0) December 2000

Christian Schenk <cs@[Link]>

Copyright c 2000 Christian Schenk Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies. Permission is granted to copy and distribute modied versions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one. Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modied versions, except that this permission notice may be stated in a translation approved by the Free Software Foundation.

Chapter 1: What is MiKTEX?

1 What is MiKTEX?
1.1 MiKTEX Features
MiKTEX is a TEX distribution for Windows (95/98/NT/2000). Its main features include: Native Windows implementation with support for long le names. On-the-y generation of missing fonts. TDS (TEX directory structure) compliant. Open Source. Advanced TEX compiler features:

- TEX can insert source le information (aka source specials) into the DVI le. This feature improves Editor/Previewer interaction. - TEX is able to read compressed (gzipped) input les. - The input encoding can be changed via TCX tables. Previewer features: Supports graphics (PostScript, BMP, WMF, TPIC, . . . ) Supports colored text (through color specials) Supports PostScript fonts Supports TrueType fonts Understands HyperTEX (html:) specials Understands source (src:) specials Customizable magnifying glasses

MiKTEX is network friendly: - integrates into a heterogeneous TEX environment - supports UNC le names - supports multiple TEXMF directory trees - uses a le name database for ecient le access - Setup Wizard can be run unattended The MiKTEX distribution consists of the following components: TEX: The traditional TEX compiler. e-TEX: A feature-extended version of TEX. Yap: DVI previewer. pdfTEX: A variant of TEX that creates PDF les. dvipdfm: Converts DVI (TEX output) les into PDF. Omega: An enhanced version of TEX with support for 16-bit character sets. METAFONT: Converts font specications into raster fonts. MetaPost: Converts picture specications into PostScript commands.

Chapter 1: What is MiKTEX?

dvips: Converts DVI (TEX output) les into PostScript. MakeIndex: Composes indexes. BibTEX: Composes bibliographies. Standard LaTEX Packages: AMS-LaTEX, Babel, PSNFSS, ... TeXinfo, PSutils, . . . : Lots of utilities.

1.2 How to get MiKTEX

MiKTEX
The ocial (i.e. most recent & stable) MiKTEX release is archived in the CTAN1 directory systems/win32/miktex/. Visit the Project Page (see Section 1.3 [Project Page], page 2) for detailed download instructions.

Other Packages
Here is a list of other packages you should take into consideration: Aladdin Ghostscript ([Link] Ghostscript is an interpreter for the PostScript language. Yap uses Ghostscript to display embedded EPS graphics. Adobe Acrobat Reader ([Link] A PDF viewer. WinEdt ([Link] WinEdt is a shareware TEX editor/shell. It cooperates with MiKTEX with respect to forward and inverse DVI search (see Section 5.2 [Source Specials], page 25). ActivePerl ([Link] ActivePerl is an implementation of Perl for the Windows platform. A few MiKTEX utilities (e.g. psmerge) are Perl scripts. You should install Perl if you want to use these utilities.

1.3 The MiKTEX Project Page

You can visit the MiKTeX Project Page for information about new releases, patches and so on.
1

CTAN: Comprehensive TeX Archive Network

Chapter 1: What is MiKTEX?

1.4 The MiKTEX Mailing List

MiKTEX Mailing List
There is a discussion list for MiKTEX. To join this list, send an e-mail to <miktexrequest@[Link]> which contains the word subscribe as the rst line in the message body. This list is archived at [Link].

1.5 Documentation
The MiKTEX Manual (which you are reading right now) concentrates on documenting MiKTEX specic features. Other MiKTEX related documentation includes: Frequently Asked Questions Lists answers to frequently asked questions. Tips & Tricks Lists useful tips. Shortcuts to these documents can be found in the MiKTEX program folder (see Section 3.2 [Start Menu], page 16).

Chapter 2: Whats new in MiKTEX 2.0?

2 Whats new in MiKTEX 2.0?

New Applications
MiKTeX Options: A graphical front-end to the MiKTEX conguration utility (initexmf). Remove MiKTEX! Wizard: Assists in removing MiKTEX from the computer. pdfeTEX 0.14f/2.1: A pdfTEX/e-TEX merger.

Updated Applications
Dvipdfm 0.13.2 LaTEX 2000/06/01 Omega 1.11 pdfTEX 0.14f

Setup Wizard Changes

You can specify the order by which the TEXMF root directories are searched. The MiKTEX bin directory is added to the PATH environment variable.

File Searching Changes

It is now possible to place the local root directory (usually C:\Local TeXMF) in the front of the search path. On-the-y generated les (e.g. PK fonts) are automatically added to the le name database.

TEX Compiler Changes New Options

--include-directory=dir prepends dir to the search path. --output-directory=dir sets the destination directory for all output les. --enable-write18 enables the \write18 primitive (see below). \write18 primitive: starts a command interpreter to carry out the specied command

New Features
TEX automatically renews the format le, if it is unacceptable. This should eliminate the (Fatal format file error; Im stymied) problem.

Texify Changes
New option --max-iterations=n limits the number of iterations. This prevents endless processing. The default for n is 5.

Chapter 2: Whats new in MiKTEX 2.0?

Yap Changes
New button Double-Page to turn on double-page view (view two pages side-by-side). Yap supports EEPIC drawing primitives (also known as tpic specials). Presentation (full-screen) mode.

Chapter 3: Installing MiKTEX

3 Installing MiKTEX
3.1 Running Setup Wizard
1. You should rst remove any previous MiKTEX installation: MiKTEX 1.11 users can use the uninstall program. MiKTEX 1.20 users must remove MiKTEX by hand. See the Local Guide of version 1.20, for more information. MiKTEX 2.0 users can use the uninstall program. 2. Make sure that you have enough disk space. A complete MiKTEX installation consumes approximately 70MB of disk space. 3. It is highly recommended that you login as Administrator, if youre installing MiKTEX on a Windows NT/2000 computer. 4. Choose a location for the installation folder (e.g. C:\Program Files\MiKTeX). This folder receives the les of the MiKTEX distribution. 5. You can cause MiKTEX to deposit newly created les (fonts, format les, le name databases) in a separate hierarchy of folders, called the Local TEXMF tree. If you decide to use a local TEXMF tree, then you must choose a location for its root folder (e.g. C:\Local TeXMF). Benets that a local TEXMF tree provides include the following: You can use it for your own additions (macros, fonts). Easier updates: You dont have to worry about future MiKTEX updates, since the local TEXMF tree wont be touched by the setup program. 6. Decide whether you want to incorporate an existing TEXMF tree. For example, if you have a TEXLive CD inserted in your CD-ROM drive E:, then it would be possible to include E:\texmf (the root of the TEXLive TEXMF tree) in the MiKTEX search procedure. 7. Start MiKTEX Setup Wizard ([Link]). You will presented with the welcome page:

Chapter 3: Installing MiKTEX

8. Click Next> to go to the next page:

Chapter 3: Installing MiKTEX

You have the option to create a shared installation, so that other users are able to use MiKTEX. Under Windows NT/2000, this option requires administrator privileges. 9. Click Next> to go to the next page:

Chapter 3: Installing MiKTEX

Enter the full path to the desired installation folder (see step 4). 10. Click Next> to go to the next page:

Chapter 3: Installing MiKTEX

10

Choose the components that you want to install. 11. Click Next> to go to the next page:

Chapter 3: Installing MiKTEX

11

Enter the full path to the desired local TEXMF folder (see step 5). Check the button No local TEXMF tree, if you dont want to use a local TEXMF tree. 12. Click Next> to go to the next page:

Chapter 3: Installing MiKTEX

12

You are asked about whether you want to incorporate existing TEXMF trees. If you check the button Incorporate existing TEXMF directory trees, then you must specify the locations of those trees on a subsequent page. 13. Click Next> to go to the next page:

Chapter 3: Installing MiKTEX

13

You should now review the installation options. 14. Click Next> to start the installation process. The selected components will be copied to the installation folder chosen in step 9. 15. When the les have been copied to your computer, you have the option to register the path to the MiKTEX bin directory:

Chapter 3: Installing MiKTEX

14

16. Click Next> to go to the nal page:

Chapter 3: Installing MiKTEX

15

Click Finish to close Setup Wizard.

3.1.1 Setup Options

For the purpose of an unattended setup, some settings can be specied on the commandline and/or in a separate text le named [Link]. You can invoke the MiKTEX Setup Wizard with the following command-line options: --additional-directory-trees DIRS Specify additional TEXMF directories. --allow-unattended-reboot Allow a reboot in unattended mode. --dry-run Simulate the installation process. No les will be installed. The log le will be written to the temporary directory. --installation-directory DIR Specify the installation directory. --help Show available options and exit.

Chapter 3: Installing MiKTEX

16

--no-additional-directory-trees Prevent MiKTEX from using additional directory trees. --no-local-directory Prevent MiKTEX from using a local directory. --program-folder FOLDER Specify the MiKTEX program folder. --unattended Run Setup Wizard in unattended mode. No user input is required. Command-line options can also be specied in a text le named [Link]. This le must be in the same directory as [Link].

3.2 Items in the Start Menu

The Setup Wizard inserts the following menu items into the start menu:

Shortcuts to help les

MiKTeX 2.0 | Help | Frequently Asked Questions Answers to frequently asked questions. MiKTeX 2.0 | Help | LaTeX2e Reference LaTEX2e reference manual. MiKTeX 2.0 | Help | Local Guide The MiKTEX Manual. MiKTeX 2.0 | Help | Release Notes Last-minute release notes. MiKTeX 2.0 | Help | Tips and Tricks Useful tips.

Program links
MiKTeX 2.0 | DVI viewer A shortcut to the DVI viewer. MiKTeX 2.0 | MiKTeX Options A shortcut to the conguration utility.

3.3 The TEXMF Folder Hierarchy

Setup Wizard creates a TDS-compliant folder hierarchy: 1. The installation folder (usually C:\Program Files\MiKTeX) contains the subfolder and les of the MiKTEX distribution. The contents of the installation folder is meant to be read-only, i.e. no les should be added, removed or changed.

Chapter 3: Installing MiKTEX

17

2. The local TEXMF folder (usually C:\Local TeXMF) receives all les that are created on-the-y by certain utilities. You can incorporate additional TEXMF folders, if the need arises. For example, you could create a TDS-compliant folder hierarchy rooted at C:\My TeXMF Files. This would serve as a repository for your own TEX les. See Section 4.1 [Dening TEXMF Root Directories], page 19, for more information.

3.3.1 Installation Folder

The installation folder (usually C:\Program Files\MiKTeX) is the root of a TDS-compliant folder hierarchy. If you have installed the complete distribution, then the installation folder contains the following subfolders: bibtex, dvips, makeindex, . . . These subfolders contain application related input les. doc fonts miktex This subfolder contains all user documentation. This subfolder contains fonts in various formats. The miktex subfolder is reserved for MiKTEX related les: miktex\bin Contains all executables. miktex\config Contains the global conguration le [Link] and the MiKTEX font mapping le [Link]. The MiKTEX Setup Wizard deposits its own log le in this subfolder. miktex\base Contains the METAFONT string pool le [Link]. miktex\fmt Contains TEX string pool les: [Link], [Link]. miktex\mem Contains the MetaPost string pool le [Link]. [Link], [Link],

3.3.2 Local TEXMF Folder

The local TEXMF folder (usually C:\Local TeXMF) receives les that are generated onthe-y. For example, if the TEX compiler needs a TEX Font Metric (TFM) le that is not available yet, then it creates that le (if possible) and installs it in an appropriate subfolder of the local TEXMF folder. Typically, the local TEXMF folder contains the following subfolders: fonts Contains font les that are not part of the MiKTEX distribution, but that were created on-the-y.

miktex\config This subfolder contains the le name database les.

Chapter 3: Installing MiKTEX

18

miktex\base This subfolder contains METAFONT format les. miktex\fmt This subfolder contains TEX format les. miktex\mem This subfolder contains MetaPost format les.

3.4 Removing MiKTEX

MiKTEX can be removed with the help of the Remove MiKTeX! Wizard : 1. Open Control Panel (usually via Start | Settings | Control Panel). 2. Click on the Software (or Add/Remve Programs) icon. 3. Select MiKTeX 2.0.

Chapter 4: Conguring MiKTEX

19

4 Conguring MiKTEX
4.1 Managing TEXMF Folder Hierarchies
The standard setup process creates two TEXMF root folders: C:\Program Files\MiKTeX: the installation folder (see Section 3.3.1 [Installation Folder], page 17). C:\Local TeXMF: the local TEXMF folder (see Section 3.3.2 [Local TEXMF Folder], page 17). You can incorporate additional TEXMF folder hierarchies with the help of MiKTeX Options: 1. Click Start | Programs | MiKTeX 2.0 | MiKTeX Options. 2. The MiKTeX Options window opens. Click on the Roots tab. The Roots window displays a list of TEXMF root folders that are used by MiKTEX:

Chapter 4: Conguring MiKTEX

20

Click Up and Down to change the order by which the TEXMF folders are searched for input les. Click Add... to append a new TEXMF root folder to the list. Click Refresh FNDB to scan the selected folders for new les and update the le name database (see Section 4.2 [FNDB Refresh], page 20) accordingly. Click Remove to remove selected folders from the list. Click Declare Local to declare the selected folder as the local TEXMF folder (see Section 3.3.2 [Local TEXMF Folder], page 17).

4.2 Refreshing the File Name Database

To speed up le search, MiKTEX makes use of a list of known le names. This list is called the le name database (FNDB).

Chapter 4: Conguring MiKTEX

21

It is strongly recommended that you update the le name database whenever les are added to or removed from one of the TEXMF directories. You can update the le name database with the help of MiKTeX Options: 1. Click Start | Programs | MiKTeX 2.0 | MiKTeX Options. 2. The MiKTeX Options window opens:

Chapter 4: Conguring MiKTEX

22

3. Click Refresh Now

4.3 Managing Format Files

Some programs initialize itself by reading parts of the memory from an external le. For the TEX family of programs, such a le is called a Format File.

4.3.1 Building Format Files

MiKTEX Setup Wizard has created standard format les in course of the installation process. You can refresh those format les with the help of MiKTeX Options: 1. Click Start | Programs | MiKTeX 2.0 | MiKTeX Options. 2. The MiKTeX Options window opens. 3. Click Update Now.

Chapter 4: Conguring MiKTEX

23

4.3.2 Dening New Format Files

1. Click Start | Programs | MiKTeX 2.0 | MiKTeX Options. 2. The MiKTeX Options window opens. 3. Click on the TeX Formats tab. You are presented with a list of well known TEX formats. To add an entry to this list, click New.... You have to supply the following information: Format Name The name of the format. Compiler The TEX compiler variant which must be used to create the format le. Input File The name of the main input le. Output File The name of the output le. Preloaded Format Optional: The name of another format, which must be loaded before creating the actual format le. Description A one-line comment which describes the new format. A new executable with the the name of the format will be created.

4.4 Selecting Hyphenation Rules

You can control the loading of hyphenation patterns with the help of MiKTEX Options: 1. Click Start | Programs | MiKTeX 2.0 | MiKTeX Options. 2. The MiKTeX Options window opens. 3. Click on the Languages tab. You can choose which hyphenation patterns are to be loaded by TEX.

4.5 Expert Topics

4.5.1 Maintaining the PostScript resource database
The PostScript resource database (PSres) is used by some utilities in order to locate PostScript resources (font outlines/metrics/encodings). The database is located in the local MiKTEX cong folder (usually C:\Local TeXMF\miktex\config). The name of the database le is [Link]. It is a text le, i.e. you can view it with a conventional text editor. It is strongly recommended that you update the database whenever PostScript resources (*.pfb;*.afm;*.enc) are added to or removed from one of the TEXMF trees. You update the database les by invoking initexmf with the command line switch --mkpsres: C:\> initexmf --mkpsres

Chapter 4: Conguring MiKTEX

24

[Link] Incorporating External Font Directories

It is possible to add non-MiKTEX font directories to the PostScript resource database. The --mkpsres switch accepts as an optional argument the name of an external font directory. You can use several --mkpsres switches with one invocation of initexmf. By specifying the command line ag --search, you can cause initexmf to automatically search your workstation for third party PostScript resource les (e.g. Acrobat Reader fonts): C:\> initexmf --mkpsres --search

Chapter 5: Non-standard TEX Features

25

5 Non-standard TEX Features

This chapter describes features, that were added to the MiKTEX implementation of Donald Knuths TEX.

5.1 Suppressing Screen Output

The command-line option --quiet suppresses all diagnostic messages. You will see no screen output, unless there are errors. These are shown in a C style form and do not stop the compilation process. For example, the input le [Link]: \documentclass{article} \begin{document} Whats \This? \end{documnt} would cause TEX to print one error message, as in C:\> latex --quiet [Link] [Link]: Undefined control sequence C:\>

5.2 Auto-insertion of Source Specials

What are source specials?
Source specials are pieces of information embedded in a DVI le, which make a connection between the source le location (e.g. line 100 in [Link]) and the DVI location (e.g. page 2 in [Link]). Source specials can improve the Edit-TEX-View-Edit cycle: 1. You edit your source le. 2. You compile the source le to get a DVI le. 3. You execute a special editor command to open Yap, going directly to the DVI page that corresponds to the cursor location in your source le. 4. You navigate inside the DVI le (e.g. PgUp/PgDn). 5. You double-click somewhere on the DVI view; this causes Yap to bring the editor window to the front, moving the text cursor directly to the line that corresponds to the view location.

How to insert source specials

The TEX compiler option --src inserts source specials into the DVI le. You would say C:\> latex --src [Link] to create the DVI le [Link] with embedded source specials.

Chapter 5: Non-standard TEX Features

26

5.3 Quoted File Names

The TEX compiler can handle quoted le names. This makes it possible to specify long le names that contain spaces. For example, to compile the input le long file [Link], you start TEX as follows: C:\> latex "long file name" This produces the DVI le long file [Link]. The log le is named long file [Link]. You can, to some extent, use quoted le names inside the TEX document. For example, \input{"extra long file name"} would cause TEX to read the le extra long file [Link]. Things get a little bit complicated if you want to use the LaTEX primitive \include. You have to write \include{"extra\space long\space file\space name"} in order to get the expected result.

5.4 Specifying Additional Input Directories

The command-line option --include-directory=dir allows you to extend the input search path for one invocation of TEX. For example, tex --include-directory="C:\My TeX" [Link] prepends C:\My TeX to the input search path, i.e. C:\My TeX will be searched rst, when TEX opens any input le (including [Link]). You can specify either absolute paths (as in the example above) or relative paths.

5.5 Specifying the Output Directory

The command-line option --output-directory=dir causes TEX to create all output les in another directory. Example: mkdir C:\texoutput latex --output-directory=C:\texoutput [Link] All output les ([Link], [Link], . . . ) will be created in C:\texoutput.

5.6 Running Programs

TEX handles output stream 18 in a special way: the token list is interpreted as a system command. If the \write18 feature is enabled (see below), then \write18{toklist} starts the command interpreter (usually [Link]) to carry out the command specied by toklist. For example: \write{dir} lists the les and subdirectories of the current directory. TEX ignores \write18 by default. You enable it by editing [Link] (search for write18) or by using the TEX compiler switch --enable-write18.

Chapter 5: Non-standard TEX Features

27

5.7 TCX les: Character translations

[ This section is borrowed from the Web2C manual ]. TCX (TEX character translation) les help TEX support direct input of 8-bit international characters if fonts containing those characters are being used. Specically, they map an input (keyboard) character code to the internal TEX character code (a superset of ASCII). Of the various proposals for handling more than one input encoding, TCX les were chosen because they follow Knuths original ideas for the use of the xchr and xord tables. He ventured that these would be changed in the WEB source in order to adjust the actual version to a given environment. It turned out, however, that recompiling the WEB sources is not as simple task as Knuth predicted; therefore, TCX les, providing the possibility of changing of the conversion tables on on-the-y, has been implemented instead. This approach limits the portability of TEX documents, as some implementations do not support it (or use a dierent method for input-internal reencoding). It may also be problematic to determine the encoding to use for a TEX document of unknown provenance; in the worst case, failure to do so correctly may result in subtle errors in the typeset output. While TCX les can be used with any format, using them breaks the LaTEX inputenc package. This is why you should either use tcxle or inputenc in LaTEX les, but never both. Specifying TCX les: You can specify a TCX le to be used for a particular TEX run by specifying the command-line option -translate-file=tcxle or (preferably) specifying it explicitly in the rst line of the main document %& -translate-file=tcxle. TCX les are searched for along the TCXPath path. INITEX ignores TCX les. The MiKTEX distribution comes with at least two TCX les, [Link] and [Link]. These support ISO Latin 1 and ISO Latin 2, respectively, with Cork-encoded fonts (a.k.a. the T1 encoding). TCX les for Czech, Polish, and Slovak are also provided. Syntax of TCX les: 1. Line-oriented. Blank lines are ignored. 2. Whitespace is ignored except as a separator. 3. Comments start with % and continue to the end of the line. 4. Otherwise, a line consists of one or two character codes: src [dest] 5. Each character code may be specied in octal with a leading 0, hexadecimal with a leading 0x, or decimal otherwise. Values must be between 0 and 255, inclusive (decimal). 6. If the dest code is not specied, it is taken to be the same as src. 7. If the same src code is specied more than once, it is the last denition that counts. Finally, heres what happens: when TEX sees an input character with code src, it 1) changes src to dest; and 2) makes code the dest printable, i.e., printed as-is in diagnostics and the log le instead of in ^^ notation.

Chapter 5: Non-standard TEX Features

28

By default, no characters are translated, and character codes between 32 and 126 inclusive (decimal) are printable. It is not possible to make these (or any) characters unprintable. Specifying translations for the printable ASCII characters (codes 32127) will yield unpredictable results. Additionally you shouldnt make the following characters printable: ^^I (TAB), ^^J (line feed), ^^M (carriage return), and ^^? (delete), since TEX uses them in various ways. Thus, the idea is to specify the input (keyboard) character code for src, and the output (font) character code for dest.

Chapter 6: TEXify: The MiKTEX Compiler Driver

29

6 TEXify: The MiKTEX Compiler Driver

texify is a command-line utility that simplies the creation of DVI (PDF) documents: texify automatically runs LaTEX (pdfLaTEX), MakeIndex and BibTEX as many times as necessary to produce a DVI (PDF) le with sorted indices and all cross-references resolved. To run texify on an input le [Link], do this: C:\> texify [Link] As shown in this example, the input le names to texify must include any extension (.tex, .ltx, etc.). There are several command-line optione you can use to control texify (see Section A.9 [texify], page 38). Here are some examples: texify --clean [Link] All auxiliary les will be removed, i.e. only the output [Link] le will be left in the current directory. texify --tex-opt=--src [Link] Passes the option --src to the TEX compiler. texify --run-viewer [Link] Opens the output le [Link] (unless there are compile erros). texify --tex-opt=--src --viewer-opt="-1 -s\"200 [Link]\"" --run-viewer [Link] Compiles [Link] with source le information (--src) and then initiates forward DVI search to open [Link] at the source special location 200 [Link]. The viewer option -1 activates the current viewer task (if there is already one running).

Appendix A: Manual Pages

30

Appendix A Manual Pages

This chapter includes manual pages for some few programs. Only programs with nonstandard command-line options are documented here. You should browse the document folder (usually C:\Program Files\MiKTeX\doc) if you are searching for real documentation.

A.1 Common Compiler Options

The following command-line switches are commonly supported by all variants of the TEX compiler. --alias=app Pretend to be app. --buf-size=n Set the internal buf_size to n. buf_size is the maximum number of characters simultaneously present in current lines of open les and in control sequences between \csname and \endcsname; must not exceed 1073741823. --c-style-errors Show C/C++ style error messages. This switch implies \scrollmode. --error-line=n Set the internal error_line to n. error_line us the width of context lines on terminal error messages. --half-error-line=n Set the internal half_error_line to n. half_error_line is the width of rst lines of contexts in terminal error messages; should be between 30 and (error_ line - 15). --halt-on-error Quit after the rst error. --initialize Initialize internal tables; these tables can be \dumped to a dump le. --include-directory=dir Prepend dir to the search path. --interaction=mode Set TEXs interaction mode (one of: batchmode, nonstopmode, scrollmode, errorstopmode). --job-name=name Specify the name of the job. This also sets the name of all output les. --job-time=lename Set the time of all output les to the time of lename. --help Show a help screen and exit.

Appendix A: Manual Pages

31

--max-in-open=n Set the internal max_in_open to n. max_in_open is the maximum number of input les and error insertions that can be going on simultaneously. --max-print-line=n Set the internal max-print-line to n. max-print-line is the width of longest text lines output; should be at least 60. --max-strings=n Set the internal max_strings to n. max_strings is the maximum number of strings; must not exceed 1073741823. --mem-bot=n Set the internal mem_bot to n. mem_bot is the smallest index in the code array dumped by INITEX (INIOMEGA, INIPDFTEX); must not be less than mem_min. --mem-max=n Set the internal mem_max to n. mem_max is the greatest index in the internal mem array; must be strictly less than 1073741823. --mem-min=n Set the internal mem_min to n. mem_min is the smallest index in the internal mem array; must be 0 or more; must be equal to mem_bot in INITEX (INIOMEGA, INIPDFTEX), otherwise <= mem_bot. --mem-top=n Set the internal mem_top to n. mem_top is the largest index in the mem array dumped by INITEX (INIOMEGA, INIPDFTEX); must be substantially larger than 0 and not greater than mem_max. --nest-size=n Set the internal nest_size to n. nest_size is the maximum number of semantic levels simultaneously active. --output-directory=dir Sets the output directory. --param-size=n Set the internal param_size to n. param_size is the maximum number of simultaneous macro parameters. --pool-size=n Set the internal pool-size to n. pool_size is the maximum number of characters in strings, including all error messages and help texts, and the names of all fonts and control sequences; must exceed string_vacancies by the total length of the programs own strings, which is currently about 30000. --quiet Suppress all output (except errors).

--save-size=n Set the internal save_size to n. save_size is the amount of space for saving values outside of current group; must be at most 1073741823. --shell-escape Same as --enable-write18.

Appendix A: Manual Pages

32

--silent

Same as --quiet.

--src-specials Insert source le information into the DVI le. --stack-size=n Set the internal stack_size to n. stack_size is the maximum number of simultaneous input sources. --string-vacancies=n Set the internal string_vacancies to n. string_vacancies is the minimum number of characters that should be available for the users control sequences and font names, after the programs own error messages are stored. --tcx=name --translate-file=name Causes TEX to process the TCX table name. --terminal=oem Causes TEX to use the current DOS codepage (e.g. cp850) for console output. --trace=traceags Set trace ags. --trie-size=n Set the internal trie_size to n. trie_size is the amount of space for hyphenation patterns; should be larger for INITEX (INIOMEGA, INIPDFTEX) than it is in production versions of the program. --trie-op-size=n Set the internal trie_op_size to n. trie_op_size is the amount of space for opcodes in the hyphenation patterns. --try-gz Try [Link] if [Link] cannot be found.

--undump=name Causes TEX to read the format le name. --version Print version information and exit. --enable-write18 Enable the \\write18 construct (see Section 5.6 [write18], page 26).

A.2 bibtex
BibTEX is a preprocessor for the LaTEX document-preparation system. It handles most of the formatting decisions required to produce a reference list, outputting a .bbl le; with this le LaTEX actually produces the reference list.

Synopsis
bibtex [option...] name Reads the le [Link] and outputs the le [Link].

Appendix A: Manual Pages

33

Options
--help Shows a help screen and exits successfully.

--min-crossrefs=N Sets the internal min_crossrefs parameter to N. --version Shows version information and exits successfully.

Documentation
See BibTEXing, available as le [Link].

A.3 dvicopy
dvicopy is a utility program that allows one to take a DVI le that references composite fonts (VF) and convert it into a DVI le that does not contain such references.

Synopsis
dvicopy [option...] old new Converts DVI le old into new.

Options
--help Shows a help screen and exits successfully.

--mag=MAG Sets magnication to MAG. --select=range Selects a range of pages to be copied. --version Prints version information and exits successfully.

A.4 initexmf (MiKTEX Conguration Utility)

initexmf is the MiKTEX Conguration Utility.

Synopsis
initexmf [option...]

Appendix A: Manual Pages

34

Options
--dump Refresh all format les (*.base;*.efmt;*.fmt;*.mem).

--dump=program Refresh the format les related to a specic program. program must be one of: elatex, etex, lambda, latex, metafont, metapost, omega, pdflatex, pdftex, tex. --find-elatex-input FILE Find e-LaTEX input le. --find-etex-input FILE Find e-TEX input le. --find-executable FILE Find a MiKTEX executable. --find-lambda-input FILE Find Lambda input le. --find-latex-input FILE Find LaTEX input le. --find-metafont-input FILE Find METAFONT input le. --find-metapost-input FILE Find MetaPost input le. --find-omega-input FILE Find Omega input le. --find-other-executable FILE Find an executable. --find-pdflatex-input FILE Find pdfLaTEX input le. --find-pdftex-input FILE Find pdfTEX input le. --find-tex-input FILE Find TEX input le. --list-modes List all known METAFONT modes. --local-root root Specify the local TEXMF root. --mkpsres Update the PostScript resource database [Link]. You can use this option in conjunction with --search (see below). --mkpsres=dir Add a new font directory to the PostScript resource database [Link].

Appendix A: Manual Pages

35

--personal -p Do not use a personal conguration le. --personal=lename -plename Dene the location of the personal conguration le. --print-only -n Print what would be done. Nothing is changed. --quiet Suppress screen output.

--reconfigure Recongure MiKTEX. --report Create a conguration report. --root-directories dirlist -r dirlist Specify the list of TEXMF root directories. --search Search for PS resource les (requires --mkpsres).

--update-fndb -u Refresh the whole le name database. --update-fndb=root -uroot Refresh the le name database for a specic TEXMF root. --verbose -v Print information on what is being done. --version -V Print the version number and exit.

A.5 mp (MetaPost)
MetaPost (installed as mp) reads a series of pictures specied in the MetaPost programming language, and outputs corresponding PostScript code.

Synopsis
mp [option...] [name[.mp]] [command...] mp [option...] "&format" [command...]

Options
--c-style-errors Show C/C++ style error messages. This switch implies \scrollmode. --initialize Initializes MetaPosts internal tables so that they can be dumped. --help Shows a short help screen and exits successfully.

Appendix A: Manual Pages

36

--tex=texprogram Uses texprogram instead of tex when compiling text labels. This ag overrides the environment variable TEX. --version Prints version information and exits successfully.

Aliases
inimp mpost virmp Equivalent to mp --ini. Equivalent to mp. Equivalent to mp.

Environment Variables
TEX Species the TEX compiler which should be used when compiling text labels.

Documentation
For a complete description of the MetaPost language, see AT&T technical report CSTR162, available as the le [Link].

A.6 omega
Omega is a 16-bit enhanced version of TEX.

Synposis
omega [option...] [name[.tex]] [command...]

Options
Omega supports the common compiler options (see Section A.1 [Common Compiler Options], page 30).

Aliases
iniomega viromega lambda Equivalent to omega --ini. Equivalent to omega. Equivalent to omega "&lambda".

Documentation
For a complete description of Omega, see the Omega manual, available as the le [Link].

Appendix A: Manual Pages

37

A.7 pdftex
pdfTEX is a special version of TEX that outputs PDF.

Synopsis
pdftex [option...] [name[.tex]] [command...] pdftex [option...] "&format" [command...]

Options
Besides the common command-line switches (see Section A.1 [Common Compiler Options], page 30), pdfTEX supports these options: --font-max=n Sets the internal font_max to n. font_max is the maximum internal font number; must not exceed 5000.

Aliases
inipdftex Equivalent to pdftex --ini. virpdftex Equivalent to pdftex. pdflatex Equivalent to pdftex "&pdflatex".

Documentation
For a complete description of pdfTEX, see the the pdfTEX User Manual, available as le [Link].

A.8 tex
tex is Donald Knuths TEX compiler.

Synopsis
tex [option...] [name[.tex]] [command...] tex [option...] "&format" [command...]

Options
Besides the common command-line switches (see Section A.1 [Common Compiler Options], page 30), tex supports the following options: --font-max=n Sets the internal font_max to n. font_max is the maximum internal font number; must not exceed 5000.

Appendix A: Manual Pages

38

Aliases
latex initex virtex Equivalent to tex. Equivalent to tex "&latex". Equivalent to tex --ini.

See Also
See Section A.9 [texify], page 38, for an alternative way to invoke TEX.

Documentation
For a complete description of TEX, see The TEXbook by Donald E. Knuth.

A.9 texify
texify runs Texinfo or LaTEX input les through TEX (pdfTEX) in turn until all crossreferences are resolved, building all indices.

Synopsis
texify [option]... le... The directory containing each le is searched for included les. The sux of le is used to determine its language (LaTEX or Texinfo). Makeinfo is used to perform Texinfo macro expansion before running TEX when needed.

Options
-@ -b --batch -c --clean -e --expand -I dir -h --help Use @input instead of \input; for preloaded Texinfo. No interaction. Remove all auxiliary les. Force macro expansion using makeinfo. Search dir for input les. Display this help and exit successfully.

-l lang --language=lang Specify the lang of le: latex or texinfo.

Appendix A: Manual Pages

39

--max-iterations=n Limits the number of iterations to prevent endless processing. The default for n is 5. --mkidx-option=option Pass option to the index generator. -p --pdf -q --quiet Use pdfTEX or pdfLaTEX for processing. No output unless errors (implies --batch).

--run-viewer Run a viewer on the resulting DVI/PDF le. -s --silent Same as --quiet.

-t cmd --texinfo=cmd Insert cmd after @setfilename in copy of input le. Multiple values accumulate. --tex-option=option Pass option to (La)(pdf)TEX. -v --version Display version information and exit successfully. --viewer-option=option Pass option to the viewer.

Environment Variables
The values of the BIBTEX, LATEX (or PDFLATEX), MAKEINDEX, MAKEINFO, TEX (or PDFTEX), and TEXINDEX environment variables are used to run those commands, if they are set.

Aliases
texi2dvi Equivalent to texify.

Appendix B: The MiKTEX Conguration File

40

Appendix B The MiKTEX Conguration File

This chapter describes the contents of the MiKTEX conguration le ([Link]).

B.1 Specifying search paths

Search paths are used by MiKTEX to nd special les (such as TEX input les) within a comprehensive directory hierarchy. A search path is a semicolon-separated list of directory paths. This list is traversed from left to right, i.e. the rst directory is searched rst. In a directory path, the following character sequences have a special meaning: %R // A placeholder for the list of TEXMF root directories. A ag, which causes MiKTEX to search recursively.

Example
Assuming that C:\Program Files\MiKTeX;\\myserver\texmf is the list of TEXMF root directories, the search path .;%R\tex\latex//;%R\tex\generic// causes LaTEX to search its input les in the following locations: 1. In the current directory (.). 2. In the directory C:\Program Files\MiKTeX\tex\latex and in all directories below it. 3. In the directory \\myserver\texmf\tex\latex and in all directories below it. 4. In the directory C:\Program Files\MiKTeX\tex\generic and in all directories below it 5. In the directory \\myserver\texmf\tex\generic and in all directories below it.

Testing a new search path

You can use the conguration utility initexmf to test whether an input le can be found via the current search path. For example, the command C:\> initexmf --find-latex-input [Link] searches for the LaTEX input le [Link]. The full path name is printed if the le was found.

B.2 Contents of a MiKTEX Conguration File

A MiKTEX conguration le is divided into several named sections. Each section contains conguration settings for a specic application or feature.

Appendix B: The MiKTEX Conguration File

41

B.2.1 [BibTeX]: BibTEX Conguration Settings

The section [BibTeX] contains BibTEX related conguration settings. Input Dirs Search path (see Section B.1 [Search Paths], page 40) for BibTEX input les (both databases and style les). min_crossrefs Minimum number of cross-refs required for automatic cite_list inclusion.

B.2.2 [Dvips]: Dvips Conguration Settings

The section [Dvips] contains Dvips related conguration settings. CONFIGPath Where Dvips searches its conguration les (e.g. [Link]). ENCPath Where Dvips searches for .enc les.

GraphicsPath Where Dvips searches for .eps les. MAPPath PSPath Where Dvips searches for .map les. Where Dvips searches for PS header les.

B.2.3 [Graphics]: Graphics Conversion Rules

The section [Graphics] contains graphics conversion rules. Each rule has the syntax .[Link]=commandline fromext is the le name extension of the source le. toext is the le name extension of the destination le. commandline is the command-line which does the conversion. The command-line may include the following placeholders: %i %o The name of the input le. The name of the output le. The standard MiKTEX conguration le contains the following rules: .[Link]=giftopnm %i | ppmtobmp -windows > %o .[Link]=pcxtoppm %i | ppmtobmp -windows > %o .[Link]=pngtopnm %i | ppmtobmp -windows > %o .[Link]=tgatoppm %i | ppmtobmp -windows > %o .[Link]=tifftopnm %i | ppmtobmp -windows > %o .[Link]=tifftopnm %i | ppmtobmp -windows > %o

B.2.4 [Magic]: Memory Settings for TEX & Friends

The section [Magic] contains memory related conguration settings. The values are used by TEX, pdfTEX and Omega for the dynamic allocation of certain data structures.

Appendix B: The MiKTEX Conguration File

42

Format-Independent Values
The following parameters can be changed at run time to extend or reduce TEXs capacity. They may have dierent values in INITEX and in production versions of TEX. mem_min mem_max buf_size Smallest index in TEXs internal mem array; must be 0 or more; must be equal to mem_bot in INITEX, otherwise <=mem_bot. Greatest index in TEXs internal mem array; must be strictly less than 1073741823. Maximum number of characters simultaneously present in current lines of open les and in control sequences between \csname and \endcsname; must not exceed 1073741823. Width of context lines on terminal error messages. half_error_line Width of rst lines of contexts in terminal error messages; should be between 30 and (error_line - 15). max_print_line Width of longest text lines output; should be at least 60. stack_size Maximum number of simultaneous input sources. max_in_open Maximum number of input les and error insertions that can be going on simultaneously. font_max Maximum internal font number; must not exceed 5000.

error_line

font_mem_size Number of words of font_info for all fonts. param_size Maximum number of simultaneous macro parameters. nest_size Maximum number of semantic levels simultaneously active. max_strings Maximum number of strings; must not exceed 1073741823. string_vacancies The minimum number of characters that should be available for the users control sequences and font names, after TEXs own error messages are stored. pool_size Maximum number of characters in strings, including all error messages and help texts, and the names of all fonts and control sequences; must exceed string_ vacancies by the total length of TEXs own strings, which is currently about 23000.

Appendix B: The MiKTEX Conguration File

43

save_size Space for saving values outside of current group; must be at most 1073741823. trie_size Space for hyphenation patterns; should be larger for INITEX than it is in production versions of TEX. trie_op_size Space for opcodes in the hyphenation patterns.

Format-Dependent Values
Like the preceding parameters, the following quantities can be changed at run time to extend or reduce TEXs capacity. But if they are changed, it is necessary to rerun the initialization program INITEX to generate new tables for the production TEX program. One cant simply make helter-skelter changes to the following constants, since certain rather complex initialization numbers are computed from them. mem_bot mem_top Smallest index in the mem array dumped by INITEX; must not be less than mem_min. Largest index in the mem array dumped by INITEX; must be substantially larger than 0 and not greater than mem_max.

B.2.5 [MakeIndex]: MakeIndex Conguration Settings

The section [MakeIndex] contains MakeIndex related conguration settings. INDEXSTYLE Search path (see Section B.1 [Search Paths], page 40) for MakeIndex style les.

B.2.6 [MakePK]: MakePK Conguration Settings

The section [MakePK] contains conguration settings that are related to the autocreation of packed raster fonts. DestDir The specication of a directory where newly created PK (Packed Raster Font) les are to be installed. The speciation may include special character sequences which will be replaced at search-time: %m %d %s %t The current METAFONT mode. The horizontal resolution (in dots per inch). The font supplier (e.g. public). The typeface name (e.g. cm).

Admin note: All MiKTEX users must have permission to create les in the specied directory.

Appendix B: The MiKTEX Conguration File

44

B.2.7 [MakeTFM]: MakeTFM Conguration Settings

DestDir Where new .tfm les are to be installed. The speciation may contain special character sequences which are replaced at search-time: %s %t The font supplier (e.g. public). The typeface name (e.g. cm).

Admin note: MiKTEX users must have permission to add les to the specied directory.

B.2.8 [METAFONT]: METAFONT Conguration Settings

The section [METAFONT] contains METAFONT related conguration settings. Input Dirs Search path (see Section B.1 [Search Paths], page 40) for METAFONT input les.

B.2.9 [MetaPost]: MetaPost Related Conguration Settings

The section [MetaPost] contains MetaPost related conguration settings. Input Dirs Where MetaPost searches for input les.

B.2.10 [MiKTeX]: General Conguration Settings

The section [MiKTeX] contains general conguration settings and search path specications.

General Conguration Settings

Trace This is a comma separated list of trace options: notrace fndb filesearch Traces the nd-le machinery. access process tcx error time TraceFile The name of the trace le. Traces le accesses. Traces secondary processes. Traces TCX tables. Traces error conditions. Traces execution time. Inhibits trace output to the console. Traces the le name database.

Appendix B: The MiKTEX Conguration File

45

Search Path Specications

AFMPath BASEPath ENCPath EXEPath FMTPath Used to locate Adobe font metric les (*.afm). Used to locate METAFONT base les (*.base). Used to locate *.enc les. Used to locate executables. Used to locate TEX format les (.fmt). Also used to locate e-TEX format les (.efmt).

GraphicsPath Used to locate graphics les (*.eps;*.bmp;...). MAPPath MEMPath OFMPath OVFPath PKPath PSPath TCXPath TFMPath TTFPath Type1Path Used to locate Type1 fonts (*.pfa;*.pfb). VFPath Used to locate virtual fonts (*.vf). Used to locate font map les (*.map). Used to locate MetaPost memory les (.mem). Used to locate Omega font metric les (*.ofm). Used to locate Omega virtual fonts (*.ovf). Used to locate packed font raster les (*.pk). Used to locate PostScript header les (*.enc;*.map); Used to locate character translation les (.tcx). Used to locate TEX font metric les (*.tfm). Used to locate TrueType fonts (*.ttc;*.ttf).

B.2.11 [Omega]: Omega Conguration Settings

The section [Omega] contains Omega related conguration settings: Input Dirs The search path (see Section B.1 [Search Paths], page 40) for Omega input les. OCPPath Where Omega searches for OCP les.

B.2.12 [otp2ocp]: otp2ocp Conguration Settings

Input Dirs Used by otp2ocp to locate OTP les (.otp).

Appendix B: The MiKTEX Conguration File

46

B.2.13 [pdfTeX]: pdfTEX Conguration Settings

The section [pdfTeX] contains pdfTEX related conguration settings. Input Dirs Where pdfTEX searches for input les. PSPath Where pdfTEX searches for font mapping les.

B.2.14 [ps2pk]: ps2pk Conguration Settings

The section [ps2pk] contains conguration settings for the ps2pk utility: PSResPath Where ps2pk searches for PS resource les.

B.2.15 [TeX]: TEX Conguration Settings

The section [TeX] contains TEX-related conguration settings. Editor The command to be started when you press e in the error menu. You can use the following placeholders: %f %h %l %m %t Will be replaced by the name of the input le that caused the error. Will be replaced by a help text. Will be replaced by the line number. Will be replaced by the error message. Will be replaced by the name of the transcript le.

For example, a suitable value for WinEdt would be winedt %f -G(1,%l,0) -S(12,+1,0). For NT Emacs, set Editor to gnulientw -F +%l %f. Input Dirs Used by TEX to locate input les.

B.2.16 [Yap]: Yap Conguration Settings

Input Dirs Used by Yap to locate DVI les (*.dvi).

Appendix C: Index

47

Appendix C Index
%
%d . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . %f . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . %h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . %l . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . %m . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43, %R . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . %s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43, %t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43, 44, 43 46 46 46 46 40 44 46 --mag=MAG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --max-in-open=n . . . . . . . . . . . . . . . . . . . . . . . . . . . . --max-iterations=n . . . . . . . . . . . . . . . . . . . . . . 4, --max-print-line=n . . . . . . . . . . . . . . . . . . . . . . . . . --max-strings=n . . . . . . . . . . . . . . . . . . . . . . . . . . . . --mem-bot=n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --mem-max=n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --mem-min=n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --mem-top=n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --min-crossrefs=N . . . . . . . . . . . . . . . . . . . . . . . . . --mkidx-option=option . . . . . . . . . . . . . . . . . . . . . . --mkpsres . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23, 24, --mkpsres=dir . . . . . . . . . . . . . . . . . . . . . . . . . . . . --nest-size=n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --no-additional-directory-trees . . . . . . . . . . . --no-local-directory . . . . . . . . . . . . . . . . . . . . . . . --output-directory=dir . . . . . . . . . . . . . . . 4, 26, --param-size=n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --pdf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --personal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --personal=lename . . . . . . . . . . . . . . . . . . . . . . . . . --pool-size=n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --print-only . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --program-folder . . . . . . . . . . . . . . . . . . . . . . . . . . . --quiet . . . . . . . . . . . . . . . . . . . . . . . . . . 25, 31, 35, --reconfigure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --report. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --root-directories dirlist . . . . . . . . . . . . . . . . . . . --run-viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29, --save-size=n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24, --select=range . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --shell-escape . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --silent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31, --src . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --src-specials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --stack-size=n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --string-vacancies=n . . . . . . . . . . . . . . . . . . . . . . --tcx=name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --terminal=mode . . . . . . . . . . . . . . . . . . . . . . . . . . . --tex-option=option . . . . . . . . . . . . . . . . . . . . . 29, --tex=texprogram . . . . . . . . . . . . . . . . . . . . . . . . . . . --texinfo=cmd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --trace=traceags . . . . . . . . . . . . . . . . . . . . . . . . . . . --translate-file=name . . . . . . . . . . . . . . . . . . . . . --trie-op-size=n . . . . . . . . . . . . . . . . . . . . . . . . . . . --trie-size=n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --try-gz. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --unattended . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --undump=name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --update-fndb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --update-fndb=root . . . . . . . . . . . . . . . . . . . . . . . . . 33 30 38 31 31 31 31 31 31 33 39 34 34 31 15 15 31 31 39 34 35 31 35 15 39 35 35 35 39 31 35 33 31 39 25 32 32 32 32 32 39 35 39 32 32 32 32 32 15 32 35 35

--additional-directory-trees . . . . . . . . . . . . . . --alias=name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --allow-unattended-reboot . . . . . . . . . . . . . . . . . --batch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --buf-size=n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --c-style-errors . . . . . . . . . . . . . . . . . . . . . . . 30, --clean . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29, --dry-run . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --dump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --dump=program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --enable-write18. . . . . . . . . . . . . . . . . . . . . . . . . 4, --error-line=n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --expand. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --find-elatex-input FILE . . . . . . . . . . . . . . . . . . --find-etex-input FILE . . . . . . . . . . . . . . . . . . . . --find-executable FILE . . . . . . . . . . . . . . . . . . . . --find-lambda-input FILE . . . . . . . . . . . . . . . . . . --find-latex-input . . . . . . . . . . . . . . . . . . . . . . . . . --find-latex-input FILE . . . . . . . . . . . . . . . . . . . --find-metafont-input FILE . . . . . . . . . . . . . . . . --find-metapost-input FILE . . . . . . . . . . . . . . . . --find-omega-input FILE . . . . . . . . . . . . . . . . . . . --find-other-executable FILE . . . . . . . . . . . . . . --find-pdflatex-input FILE . . . . . . . . . . . . . . . . --find-pdftex-input FILE . . . . . . . . . . . . . . . . . . --find-tex-input FILE . . . . . . . . . . . . . . . . . . . . . --font-max=n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --half-error-line=n . . . . . . . . . . . . . . . . . . . . . . . . --halt-on-error . . . . . . . . . . . . . . . . . . . . . . . . . . . . --help . . . . . . . . . . . . . . . . . . . . . . . . 15, 30, 33, 35, --include-directory=dir . . . . . . . . . . . . . . 4, 26, --initialize . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30, --installation-directory . . . . . . . . . . . . . . . . . . --interaction=mode . . . . . . . . . . . . . . . . . . . . . . . . --job-name=name . . . . . . . . . . . . . . . . . . . . . . . . . . . --job-time=lename . . . . . . . . . . . . . . . . . . . . . . . . . --language=lang . . . . . . . . . . . . . . . . . . . . . . . . . . . . --list-modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --local-directory . . . . . . . . . . . . . . . . . . . . . . . . . . --local-root root . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 30 15 38 30 35 38 15 34 34 32 30 38 34 34 34 34 40 34 34 34 34 34 34 34 34 37 30 30 38 30 35 15 30 30 30 38 34 15 34

Appendix C: Index

48

--verbose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . --version . . . . . . . . . . . . . . . . . . . . . 32, 33, 35, 36, --viewer-option=option . . . . . . . . . . . . . . . . . . 29, -@ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . -1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . -b . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . -c . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . -e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . -h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . -I dir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . -l lang . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . -n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . -p . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34, -plename . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . -q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . -r dirlist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . -s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29, -t cmd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . -u . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . -uroot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . -v . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35, -V . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

35 39 39 38 29 38 38 38 38 38 38 35 39 35 39 35 39 39 35 35 39 35

B
BASEPath. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . BIBTEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . blank lines, in TCX les . . . . . . . . . . . . . . . . . . . . . . BMP (Windows Bitmap). . . . . . . . . . . . . . . . . . . 1, buf_size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30, 45 39 27 41 42

C
character codes, in TCX les . . . . . . . . . . . . . . . . . 27 character translation les . . . . . . . . . . . . . . . . . . . . . 27 codepage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 color specials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 comments, in TCX les . . . . . . . . . . . . . . . . . . . . . . 27 compressed input les . . . . . . . . . . . . . . . . . . . . . 1, 32 [Link] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 CONFIGPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 conguration report, creating a . . . . . . . . . . . . . . . 35 Cork encoding and ISO input . . . . . . . . . . . . . . . . . 27 cp850 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 CTAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

.
.tcx character translation les . . . . . . . . . . . . . . . . 27

/
// . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

D
decimal character codes, in TCX les. . . . . . . . . . 27 DestDir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43, 44 disk space, required . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 double-page view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 [Link] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 DVI les, search path for . . . . . . . . . . . . . . . . . . . . . 46 Dvips, conguring . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

^
^^ notation, avoiding . . . . . . . . . . . . . . . . . . . . . . . . . 27

\
\write18 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

8
8-bit characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

E
Edit-TEX-View-Edit cycle . . . . . . . . . . . . . . . . . . . . 25 Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 EEPIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Emacs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 ENCPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41, 45 error messages, C-style . . . . . . . . . . . . . . . . 25, 30, 35 error messages, length of . . . . . . . . . . . . . . . . . . 30, 42 error_line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30, 42 execution time, tracing . . . . . . . . . . . . . . . . . . . . . . . 44 EXEPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

A
accented character . . . . . . . . . . . . . . . . . . . . . . . . . . . Acrobat Reader . . . . . . . . . . . . . . . . . . . . . . . . . . . 2, adding les to the TEXMF tree . . . . . . . . . . . 20, AFM (Adobe Font Metric) les, search path for ........................................ AFMPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . auxiliary les, removing . . . . . . . . . . . . . . . . . . . 29, 27 24 23 45 45 38

Appendix C: Index

49

F
FAQ, MiKTEX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 features, MiKTEX . . . . . . . . . . . . . . . . . . . . . . . . . 1, 25 le accesses, tracing . . . . . . . . . . . . . . . . . . . . . . . . . . 44 le name database, refreshing the . . . . . . . . . . . . . 35 le name databes, tracing the . . . . . . . . . . . . . . . . . 44 le search, tracing . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 FMTPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 FNDB (le name database) . . . . . . . . . . . . . . . . . . . 20 font character code, translating . . . . . . . . . . . . . . . 28 font directories, adding . . . . . . . . . . . . . . . . . . . . . . . 24 font mapping les, search path for . . . . . . . . . . . . 45 font supplier. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 font_max . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37, 42 font_mem_size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 format les, search path for . . . . . . . . . . . . . . . . . . . 45

L
[Link] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 LATEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 local folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 local TEXMF folder . . . . . . . . . . . . . . . . . . . 16, 17, 19 log files, Setup Wizard . . . . . . . . . . . . . . . . . . . . 17 long le names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 long le names, quoting of . . . . . . . . . . . . . . . . . . . . 26

M
mailing list, MiKTEX . . . . . . . . . . . . . . . . . . . . . . . . . 3 MAKEINDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 MAKEINFO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 MAPPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41, 45 max_in_open . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30, 42 max_print_line . . . . . . . . . . . . . . . . . . . . . . . . . . 31, 42 max_strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31, 42 Mekeindex, conguring . . . . . . . . . . . . . . . . . . . . . . . 43 mem_bot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31, 43 mem_max . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31, 42 mem_min . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31, 42 mem_top . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31, 43 memory allocation, dynamic . . . . . . . . . . . . . . . . . . 41 MEMPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 METAFONT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 METAFONT base les, search path for . . . . . . . . 45 METAFONT mode . . . . . . . . . . . . . . . . . . . . . . . . . . 43 MetaPost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35, 44 [Link] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 [Link] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 MiKTEX Compiler Driver . . . . . . . . . . . . . . . . . 29, 38 min_crossrefs . . . . . . . . . . . . . . . . . . . . . . . . . . . 33, 41

G
Ghostscript. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 GIF (Graphics Interchange Format) . . . . . . . . . . . 41 graphics, search path for . . . . . . . . . . . . . . . . . . . . . 45 GraphicsPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41, 45

H
half_error_line . . . . . . . . . . . . . . . . . . . . . . . . . 30, 42 hex character codes, in TCX les . . . . . . . . . . . . . 27 HyperTEX specials . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 hyphenation patterns, controling loading of . . . . 23 hyphenation patterns, space for . . . . . . . . . . . . . . . 43

I
[Link] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [Link] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . INDEXSTYLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Input Dirs. . . . . . . . . . . . . . . . . . . . . . . . 41, 44, 45, installation folder . . . . . . . . . . . . . . . . . . . 6, 16, 17, interaction mode, setting TEXs . . . . . . . . . . . . . . . international characters . . . . . . . . . . . . . . . . . . . . . . 27 27 43 46 19 30 27

N
nest_size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31, 42 network installation . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

O
OCPPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . octal character codes, in TCX les . . . . . . . . . . . . OEM mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OFMPAth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Omega, conguring . . . . . . . . . . . . . . . . . . . . . . . . . . output directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . output le, setting name of . . . . . . . . . . . . . . . . . . . OVFPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 27 32 45 45 26 30 45

J
job name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

K
keyboard character code, translating . . . . . . . . . . 28 Knuth, Donald E. . . . . . . . . . . . . . . . . . . . . . . . . 25, 37

Appendix C: Index

50

P
param_size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31, 42 PCX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 PDF, creating . . . . . . . . . . . . . . . . . . . . . . . . 29, 37, 38 PDFLATEX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 PDFTEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 pdfTEX, conguring . . . . . . . . . . . . . . . . . . . . . . . . . . 46 Perl. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 PK (Packed Raster Font) . . . . . . . . . . . . . . . . . . . . . 43 PK les, search path for . . . . . . . . . . . . . . . . . . . . . . 45 PKPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 PNG (Portable Network Graphics) . . . . . . . . . . . . 41 pool_size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31, 42 PostScrip resource database, maintaining the . . 23 PostScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 PostScript header les, search path for . . . . . . . . 45 printable characters, specifying . . . . . . . . . . . . . . . 27 processes, tracing . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 Project Page, MiKTEX . . . . . . . . . . . . . . . . . . . . . . . . 2 PSPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41, 45, 46 PSres (PostScript resource database) . . . . . . . . . . 23 PSResPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Q
quoted le names . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

R
Registry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 removing les from the TEXMF tree . . . . . . . 20, 23 resolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

TCX les, search path for . . . . . . . . . . . . . . . . . . . . 45 TCX les, syntax of. . . . . . . . . . . . . . . . . . . . . . . . . . 27 TCX les, tracing. . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 TCXPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 TCXPath, search path for TCX les . . . . . . . . . . . . 27 TDS (TEX directory structure) . . . . . . . . . . . . . . . . . 1 TDS (TEX folder hierarchy) . . . . . . . . . . . . . . . . . . 16 terminal mode, setting . . . . . . . . . . . . . . . . . . . . . . . 32 TEX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36, 39 TEX input les, search path for . . . . . . . . . . . . . . . 46 TEX, conguring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 TEXLive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 TEXINDEX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 Texinfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 TFM (TEX Font Metrics). . . . . . . . . . . . . . . . . . . . . 44 TFM les, search path for . . . . . . . . . . . . . . . . . . . . 45 TFMPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 TGA (TrueVision Targa) . . . . . . . . . . . . . . . . . . . . . 41 TIFF (Tagged Image File Format) . . . . . . . . . . . . 41 Tips & Tricks, MiKTEX . . . . . . . . . . . . . . . . . . . . . . . 3 tpic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Trace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 TraceFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 tracing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32, 44 trie_op_size . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32, 43 trie_size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32, 43 TrueType fonts, search path for . . . . . . . . . . . . . . . 45 TTFPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Type1 fonts, search path for . . . . . . . . . . . . . . . . . . 45 Type1Path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

S
save_size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31, 42 screen output, suppressing . . . . . . . . . 25, 31, 35, 39 screen output, witdh of . . . . . . . . . . . . . . . . . . . . . . . 42 search paths, specifying . . . . . . . . . . . . . . . . . . . . . . 40 Setup Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 [Link] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 source specials . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1, 25 source specials, inserting . . . . . . . . . . . . . . . . . . 25, 32 spaces in le names . . . . . . . . . . . . . . . . . . . . . . . . . . 26 stack_size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32, 42 start menu, Windows . . . . . . . . . . . . . . . . . . . . . . . . 16 string_vacancies . . . . . . . . . . . . . . . . . . . . . . . 32, 42

U
UNC (Universal Naming Code) . . . . . . . . . . . . . . . . 1 uninstalling MiKTEX. . . . . . . . . . . . . . . . . . . . . . . . . 18

V
VFPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 virtual fonts, search path for . . . . . . . . . . . . . . . . . . 45

W
whitespace, in TCX les. . . . . . . . . . . . . . . . . . . . . . 27 Windows NT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 WinEdt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2, 46 WMF (Windows Metale) . . . . . . . . . . . . . . . . . . . . . 1

T
T1 encoding and ISO input . . . . . . . . . . . . . . . . . . . 27 TCX (character translation) . . . . . . . . . . . . . . . . . . . 1 TCX character translation les . . . . . . . . . . . . . . . . . 27 TCX les, processing. . . . . . . . . . . . . . . . . . . . . . . . . 32

Y
Yap, conguring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Table of Contents
1 What is MiKTEX? . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.1 1.2 1.3 1.4 1.5 MiKTEX Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How to get MiKTEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . The MiKTEX Project Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . The MiKTEX Mailing List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 2 3 3

2 3

Whats new in MiKTEX 2.0? . . . . . . . . . . . . . . . 4 Installing MiKTEX . . . . . . . . . . . . . . . . . . . . . . . . . 6

Running Setup Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 3.1.1 Setup Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 3.2 Items in the Start Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 3.3 The TEXMF Folder Hierarchy . . . . . . . . . . . . . . . . . . . . . . . . . . 16 3.3.1 Installation Folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 3.3.2 Local TEXMF Folder . . . . . . . . . . . . . . . . . . . . . . . . . . 17 3.4 Removing MiKTEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 3.1

Conguring MiKTEX . . . . . . . . . . . . . . . . . . . . . 19
4.1 Managing TEXMF Folder Hierarchies. . . . . . . . . . . . . . . . . . . . 4.2 Refreshing the File Name Database . . . . . . . . . . . . . . . . . . . . . . 4.3 Managing Format Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.3.1 Building Format Files . . . . . . . . . . . . . . . . . . . . . . . . . . 4.3.2 Dening New Format Files . . . . . . . . . . . . . . . . . . . . . 4.4 Selecting Hyphenation Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.5 Expert Topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.5.1 Maintaining the PostScript resource database . . . . [Link] Incorporating External Font Directories ......................................... 19 20 22 22 23 23 23 23 24

Non-standard TEX Features . . . . . . . . . . . . . . . 25

5.1 5.2 5.3 5.4 5.5 5.6 5.7 Suppressing Screen Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Auto-insertion of Source Specials . . . . . . . . . . . . . . . . . . . . . . . . Quoted File Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Specifying Additional Input Directories . . . . . . . . . . . . . . . . . . Specifying the Output Directory . . . . . . . . . . . . . . . . . . . . . . . . . Running Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . TCX les: Character translations. . . . . . . . . . . . . . . . . . . . . . . . 25 25 26 26 26 26 27

TEXify: The MiKTEX Compiler Driver . . . . . 29

ii

Appendix A
A.1 A.2 A.3 A.4 A.5 A.6 A.7 A.8 A.9

Manual Pages . . . . . . . . . . . . . . . . . . 30
30 32 33 33 35 36 37 37 38

Common Compiler Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . bibtex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . dvicopy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . initexmf (MiKTEX Conguration Utility) . . . . . . . . . . . . . . . mp (MetaPost) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . omega. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . pdftex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . tex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . texify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Appendix B The MiKTEX Conguration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

B.1 Specifying search paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 B.2 Contents of a MiKTEX Conguration File . . . . . . . . . . . . . . . 40 B.2.1 [BibTeX]: BibTEX Conguration Settings . . . . . . . 41 B.2.2 [Dvips]: Dvips Conguration Settings . . . . . . . . . . . 41 B.2.3 [Graphics]: Graphics Conversion Rules . . . . . . . . . . 41 B.2.4 [Magic]: Memory Settings for TEX & Friends . . . . 41 B.2.5 [MakeIndex]: MakeIndex Conguration Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 B.2.6 [MakePK]: MakePK Conguration Settings. . . . . . 43 B.2.7 [MakeTFM]: MakeTFM Conguration Settings . . 44 B.2.8 [METAFONT]: METAFONT Conguration Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 B.2.9 [MetaPost]: MetaPost Related Conguration Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 B.2.10 [MiKTeX]: General Conguration Settings . . . . . 44 B.2.11 [Omega]: Omega Conguration Settings . . . . . . . 45 B.2.12 [otp2ocp]: otp2ocp Conguration Settings . . . . . 45 B.2.13 [pdfTeX]: pdfTEX Conguration Settings . . . . . . . 46 B.2.14 [ps2pk]: ps2pk Conguration Settings . . . . . . . . . 46 B.2.15 [TeX]: TEX Conguration Settings . . . . . . . . . . . . . 46 B.2.16 [Yap]: Yap Conguration Settings . . . . . . . . . . . . . 46

Appendix C

Index . . . . . . . . . . . . . . . . . . . . . . . . . . 47