\documentclass{article} % Must use LaTeX 2e
\usepackage{html,makeidx,color}
\internal[figure]{s1} % Include internal information
\internal[figure]{s2} % from children
\internal[sections]{s1}
\internal[sections]{s2}
\internal[contents]{s1}
\internal[contents]{s2}
\internal[index]{s1}
\internal[index]{s2}
\begin{document} % The start of the document
\title{A Segmentation Example}
\date{\today}
\maketitle
\tableofcontents
\listoffigures
% Process the child segments:
\segment{sec1}{section}{Section 1 title}
\segment{sec2}{section}{Section 2 title}
\printindex
\end{document}
This file obtains the information necessary to build an
index, a table of contents and a list of figures from the
child segments. It then proceeds to typeset these.
\documentclass{article}
\usepackage{html,color,makeidx}
\input{sec1.ptr}
\internal{s2}
\startdocument
Here is some text.
\subsection{First subsection}
Here is subsection 1\label{first}.
\begin{figure}
\colorbox{red}{Some red text\index{Color text}}
\caption[List of figure caption]{Figure 1 caption}
\end{figure}
Reference\index{Reference} to \ref{second}.
The first thing this child segment does is establish the LATEX
packages it requires, then loads the counter information that
was written by the \segment command that invoked it.
Since this segment contains a symbolic reference (second)
to the second segment, it must load the internal labels from
that segment.
\documentclass{article}
\usepackage{html,makeidx}
\input{sec2.ptr}
\internal{s1}
\startdocument
Here is another section\label{second}.
Plus another\index{Reference, another} reference\ref{first}.
\begin{figure}
\fbox{The figure}
\caption{The caption}
\end{figure}
96.1f
In the above example, all segments are built within the same sub-directory
report/ of the directory containing the LATEX source files.
This is achieved simply by using the option -dir report with each.
All the images and <prefix><type>.pl files
are created and stored within this directory.
Sometimes it is desirable to build one or more segments within
separate sub-directories.
This is especially so when a segment has a large number of images,
or if it is required to be part of more than one combined document.
In this case the -dir <dir> options can be different,
or omitted entirely. For inter-segment referencing to work,
a ``relative path'' must be included as part of the <prefix>
with each \internal command; e.g.
\internal[figure]{../sect1/s1}