<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id='mkintex1'>
<refmeta>
<refentrytitle>mkintex</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo>@PACKAGE@ @VERSION@</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>
<!-- 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>mtr@ranang.org</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>