<?
xml version="1.0" encoding="UTF-8"?>
<
refentry id="
mkintex1">
<
refmeta>
<
refentrytitle>
mkintex
</
refentrytitle>
<
manvolnum>
1
</
manvolnum>
<
refmiscinfo>
intex 1.8.0
</
refmiscinfo>
</
refmeta>
<
refnamediv id="
name">
<
refname>
mkintex
</
refname>
<
refpurpose>
index preprocessor for the
<
refentrytitle>
InTeX
</
refentrytitle>
<
manvolnum>
5
</
manvolnum>
<
refentrytitle>
LaTeX
</
refentrytitle>
<
manvolnum>
1
</
manvolnum>
package
</
refpurpose>
</
refnamediv>
Default handler: <!-- body begins here -->
<
refsynopsisdiv id="
synopsis">
<
cmdsynopsis>
<
command>
mkintex
</
command>
<
arg choice="
opt">
<
replaceable>
options
</
replaceable>
</
arg>
<
arg choice="
plain">
<
replaceable>
<
InTeX-index
>
</
replaceable>
</
arg>
<
arg choice="
opt"
rep="
repeat">
<
replaceable>
InTeX-index
</
replaceable>
</
arg>
</
cmdsynopsis>
</
refsynopsisdiv>
<
refsect1 id="
description">
<
title>
DESCRIPTION
</
title>
<
para>
The
<
citerefentry>
<
refentrytitle>
InTeX
</
refentrytitle>
<
manvolnum>
5
</
manvolnum>
</
citerefentry>
package adds functionality
to LaTeX that eases typesetting and indexing of phrases, acronyms,
and proper names in a consistent manner throughout documents of
arbitrary length.
</
para>
<
para>
<
citerefentry>
<
refentrytitle>
mkintex
</
refentrytitle>
<
manvolnum>
1
</
manvolnum>
</
citerefentry>
is a preprocessor that
interprets index entries specified in .itx files and generates
appropriate entries for LaTeX and
<
citerefentry>
<
refentrytitle>
makeindex
</
refentrytitle>
<
manvolnum>
1
</
manvolnum>
</
citerefentry>
.
</
para>
</
refsect1>
<
refsect1 id="
options">
<
title>
OPTIONS
</
title>
<
variablelist remap="
TP">
<
varlistentry>
<
term>
<
option>
--version
</
option>
</
term>
<
listitem>
<
para>
show program's version number and exit
</
para>
</
listitem>
</
varlistentry>
<
varlistentry>
<
term>
<
option>
-h, --help
</
option>
</
term>
<
listitem>
<
para>
show this help message and exit
</
para>
</
listitem>
</
varlistentry>
<
varlistentry>
<
term>
<
option>
-D, --debug
</
option>
</
term>
<
listitem>
<
para>
whether or not to output debug information
</
para>
</
listitem>
</
varlistentry>
<
varlistentry>
<
term>
<
option>
-V, --verbose
</
option>
</
term>
<
listitem>
<
para>
whether or not to output verbose information
</
para>
</
listitem>
</
varlistentry>
<
varlistentry>
<
term>
<
option>
-I, --only-build-index
</
option>
</
term>
<
listitem>
<
para>
only build the internal model of the index
</
para>
</
listitem>
</
varlistentry>
<
varlistentry>
<
term>
<
option>
-O
<
</
option>
<
emphasis remap="
I">
file
</
emphasis>
<
emphasis remap="
P->B">
>
, --ito-file=
<
</
emphasis>
<
emphasis remap="
I">
file
</
emphasis>
<
emphasis remap="
P->B">
>
</
emphasis>
</
term>
<
listitem>
<
para>
output the new internal InTeX information to
<
<
emphasis remap="
I">
file
</
emphasis>
>
(default: none)
</
para>
</
listitem>
</
varlistentry>
<
varlistentry>
<
term>
<
option>
-o
<
</
option>
<
emphasis remap="
I">
file
</
emphasis>
<
emphasis remap="
P->B">
>
, --index-file=
<
</
emphasis>
<
emphasis remap="
I">
file
</
emphasis>
<
emphasis remap="
P->B">
>
</
emphasis>
</
term>
<
listitem>
<
para>
output the new indexing information to
<
<
emphasis remap="
I">
file
</
emphasis>
>
(default: none)
</
para>
</
listitem>
</
varlistentry>
<
varlistentry>
<
term>
<
option>
-a
<
</
option>
<
emphasis remap="
I">
file
</
emphasis>
<
emphasis remap="
P->B">
>
, --acrodef-output=
<
</
emphasis>
<
emphasis remap="
I">
file
</
emphasis>
<
emphasis remap="
P->B">
>
</
emphasis>
</
term>
<
listitem>
<
para>
output acronym definitions to
<
<
emphasis remap="
I">
file
</
emphasis>
>
(default: none)
</
para>
</
listitem>
</
varlistentry>
<
varlistentry>
<
term>
<
option>
-p
<
</
option>
<
emphasis remap="
I">
file
</
emphasis>
<
emphasis remap="
P->B">
>
, --persondef-output=
<
</
emphasis>
<
emphasis remap="
I">
file
</
emphasis>
<
emphasis remap="
P->B">
>
</
emphasis>
</
term>
<
listitem>
<
para>
output (person) name definitions to
<
<
emphasis remap="
I">
file
</
emphasis>
>
(default: none)
</
para>
</
listitem>
</
varlistentry>
</
variablelist>
</
refsect1>
<
refsect1 id="
examples">
<
title>
EXAMPLES
</
title>
<
para>
Let us assume that you have already written a
<
citerefentry>
<
refentrytitle>
latex
</
refentrytitle>
<
manvolnum>
1
</
manvolnum>
</
citerefentry>
document, named
<
<
emphasis remap="
I">
document_name
</
emphasis>
>
.tex, that uses the
<
citerefentry>
<
refentrytitle>
InTeX
</
refentrytitle>
<
manvolnum>
5
</
manvolnum>
</
citerefentry>
package. Furthermore, we assume that you have defined a set of
concepts, acronyms, and proper nouns for indexing in a file named
<
<
emphasis remap="
I">
document_name
</
emphasis>
>
.itx. Then, to
run this program the standard way, first process the document with
<
citerefentry>
<
refentrytitle>
latex
</
refentrytitle>
<
manvolnum>
1
</
manvolnum>
</
citerefentry>
(or
<
citerefentry>
<
refentrytitle>
pdflatex
</
refentrytitle>
<
manvolnum>
1
</
manvolnum>
</
citerefentry>
)
by issuing the command
</
para>
<
para>
latex
<
<
emphasis remap="
I">
document_name
</
emphasis>
>
</
para>
<
para>
This will process the document once and generate both a DVI
file (
<
<
emphasis remap="
I">
document_name
</
emphasis>
>
.dvi)---or
a PDF file (
<
<
emphasis remap="
I">
document_name
</
emphasis>
>
.pdf)---and an auxiliary file
(
<
<
emphasis remap="
I">
document_name
</
emphasis>
>
.aux).
</
para>
<
para>
Next, run the
<
citerefentry>
<
refentrytitle>
mkintex
</
refentrytitle>
<
manvolnum>
1
</
manvolnum>
</
citerefentry>
program
</
para>
<
para>
mkintex
<
<
emphasis remap="
I">
document_name
</
emphasis>
>
--index-file=
<
<
emphasis remap="
I">
document_name
</
emphasis>
>
.rix
</
para>
<
para>
that will use as input both
<
<
emphasis remap="
I">
document_name
</
emphasis>
>
.aux and
<
<
emphasis remap="
I">
document_name
</
emphasis>
>
.itx to produce two new output
files. The first file is
<
<
emphasis remap="
I">
document_name
</
emphasis>
>
.ito, which will be used by
<
citerefentry>
<
refentrytitle>
latex
</
refentrytitle>
<
manvolnum>
1
</
manvolnum>
</
citerefentry>
in following compilations of
<
<
emphasis remap="
I">
document_name
</
emphasis>
>
.tex, and
<
<
emphasis remap="
I">
document_name
</
emphasis>
>
.rix, which will be used by
<
citerefentry>
<
refentrytitle>
makeindex
</
refentrytitle>
<
manvolnum>
1
</
manvolnum>
</
citerefentry>
to produce a proper index for LaTeX to typeset:
</
para>
<
para>
makeindex -o intex.rid intex.rix
</
para>
<
para>
After that, we have to run
<
citerefentry>
<
refentrytitle>
latex
</
refentrytitle>
<
manvolnum>
1
</
manvolnum>
</
citerefentry>
again to generate a version of the document with the defined
concepts, acronyms, and proper names properly typeset and
indexed:
</
para>
<
para>
latex
<
<
emphasis remap="
I">
document_name
</
emphasis>
>
</
para>
<
para>
Please note that in the examples above,
<
<
emphasis remap="
I">
document_name
</
emphasis>
>
is the name of the main LaTeX
document, without the .tex ending.
</
para>
<
para>
For more information and examples of how to use the
<
refentrytitle>
InTeX
</
refentrytitle>
<
manvolnum>
5
</
manvolnum>
<
refentrytitle>
LaTeX
</
refentrytitle>
<
manvolnum>
1
</
manvolnum>
package, please see the file intex.pdf.
</
para>
</
refsect1>
<
refsect1 id="
authors">
<
title>
AUTHORS
</
title>
<
para>
<
contrib>
Original author:
</
contrib>
<
author>
<
firstname>
Martin
</
firstname>
<
othername>
Thorsen
</
othername>
<
surname>
Ranang
</
surname>
</
author>
<
email>
[email protected]
</
email>
.
</
para>
</
refsect1>
<
refsect1 id="
copying">
<
title>
COPYING
</
title>
<
para>
InTeX is free software: you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
</
para>
<
para>
InTeX is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
</
para>
<
para>
You should have received a copy of the GNU General Public License
along with InTeX. If not, see
<
http://www.gnu.org/licenses/
>
.
</
para>
</
refsect1>
<
refsect1 id="
see_also">
<
title>
SEE ALSO
</
title>
<
para>
<
citerefentry>
<
refentrytitle>
intex
</
refentrytitle>
<
manvolnum>
5
</
manvolnum>
</
citerefentry>
<
citerefentry>
<
refentrytitle>
makeindex
</
refentrytitle>
<
manvolnum>
1
</
manvolnum>
</
citerefentry>
<
citerefentry>
<
refentrytitle>
latex
</
refentrytitle>
<
manvolnum>
1
</
manvolnum>
</
citerefentry>
</
para>
</
refsect1>
</
refentry>