tex2rtf.tex

Wxpython Implemented on Windows CE, Source code

Version 1.39:

\begin{itemize}
\itemsep=0pt
\item Option for using Word's INCLUDEPICTURE or IMPORT field, since the method that
works for Works, doesn't work for Word! See {\it bitmapMethod} in the
settings section.
\end{itemize}

Version 1.37-1.38:

\begin{itemize}
\itemsep=0pt
\item Improved bibliography reading and cured some minor bugs
\item Added \verb$\ss$ German sharp s
\item Added rudimentary \verb$\special$ command (simply copies the argument
to the output)
\item Added missing '.' in subsubsection reference
\item Added primitive internationalisation support with contentsName, tablesName etc.
\end{itemize}

Version 1.36:

\begin{itemize}
\itemsep=0pt
\item All HTML special characters now correctly delimited by a semicolon.
\item Cured HTML section-duplicating bug I introduced in 1.35.
\item Cured too much spacing after sections in RTF, introduced in 1.35.
\end{itemize}

Version 1.35:

\begin{itemize}
\itemsep=0pt
\item Added TCHECK tool, to help track down common Tex2RTF syntax problems.
\item Included Kresten Thorup's LACHECK \LaTeX\ checking tool with DOS executable.
\item Now ignores \verb|\@| command.
\item Table of contents now includes numbered subsubsections.
\end{itemize}

Version 1.34:

\begin{itemize}
\itemsep=0pt
\item Added \verb$\multicolumn$ `support' to stop RTF readers crashing.
\item Added {\it useWord, defaultColumnWidth, compatibility} options to {\tt .ini} file.
\item \verb$\comment$ environment now doesn't complain about unknown syntax.
\item Added \verb$\toocomplex$ environment that treats its contents as
verbatim in output, treated as normal output in true \LaTeX.
\item End-of-line comments allowed in in {\tt .ini} files, using semicolon,
percent or hash characters to denote a comment.
\item For linear RTF, Word for Windows support for \verb$\printindex$,\rtfsp
\verb$\index$, \verb$\pageref$, \verb$\listoftables$, \verb$\listoffigures$, contents page.
\item Added RTF support for various symbols.
\item Added colour support, with \verb$\definecolour$, \verb$\fcol$ and \verb$\bcol$ commands.
\item Fixed some bugs: page numbering problems, macros deleted after first pass.
\end{itemize}

Version 1.33:

\begin{itemize}
\itemsep=0pt
\item Added -charset command-line switch.
\item Added \verb$\itemsep$, \verb$\twocolumn$, \verb$\onecolumn$, \verb$\setfooter$, \verb$\setheader$, \verb$\pagestyle$,
\verb$\pagenumbering$, \verb$\thechapter$, \verb$\thesection$, \verb$\thepage$, \verb$\thebibliography$, \verb$\bibitem$ commands.
\item New environment called \verb$\twocollist$ for making two-column lists,
with formatting optimized for target file format.
\item New \verb$\indented$ environment for controlling indentation.
\item List indentation and bulleting improved.
\item Added commands \verb$\normalbox$, \verb$\normalboxd$ for putting borders around text.
\item Many options can now be specified in the {\tt .ini} file along with custom macros.
\item Cured bug that put too much vertical space after some commands.
\item Improved table formatting.
\item Optional `Up' button in WinHelp files for easier navigation.
\item Verbatim lines followed by \verb$\par$ in RTF, to improve WinHelp wrapping.
\item Conversion may now be aborted under Windows by attempting to close the application.
\item Added conditional output for all formats: \verb$\latexignore$, \verb$\latexonly$, \verb$\rtfignore$, \verb$\rtfonly$,
\verb$\winhelpignore$, \verb$\winhelponly$, \verb$\htmlignore$, \verb$\htmlonly$, \verb$\xlpignore$, \verb$\xlponly$.
\item HTML generator can now add Contents, Up, $<<$ and $>>$ buttons (text or bitmap) to
each page except titlepage.
\end{itemize}

Version 1.32:

\begin{itemize}
\itemsep=0pt
\item \verb$\footnote$ command now supported in WinHelp RTF, and \verb$\footnotepopup$\rtfsp
added.
\end{itemize}

Version 1.31:

\begin{itemize}
\itemsep=0pt
\item \verb$\footnote$ command now supported, in linear RTF only.
\item Added {\tt -bufsize} option, for converting large documents.
\end{itemize}

Version 1.30:

\begin{itemize}
\itemsep=0pt
\item \verb$\image$ command now scales metafiles (but not bitmaps).
\item Fixed macro loading bug, now informs the user of the found macro filename.
\item Now supports paragraph and subparagraph commands.
\item Support for some accents added.
\item \verb$\verb$ command now supported.
\item Bug in subsubsection handling fixed.
\item Can save conversion log in a text file.
\end{itemize}

Version 1.22:

\begin{itemize}
\itemsep=0pt
\item More informative, warns against use of some commands.
\item Added compile-time support for non-GUI environments (such as plain UNIX).
\item Improved HTML support.
\end{itemize}

\chapter{Running Tex2RTF}\index{running Tex2RTF}%
\setheader{{\it CHAPTER \thechapter}}{}{}{}{}{{\it CHAPTER \thechapter}}%
\setfooter{\thepage}{}{}{}{}{\thepage}%

Tex2RTF may be run in a number of ways: with or without command line arguments,
interactively or in batch mode, and with an optional initialisation file
for specifying \LaTeX\ macros and detailed options.

Tex2RTF accepts two arguments (input and output filenames) and trailing
(optional) switches.  If both filenames are given, the utility will work
in batch mode.  Otherwise, if Tex2RTF has been compiled for GUI
operation, a main window will be shown, with appropriate menu items for
selecting input and output filenames, starting off the conversion
process, and so on.

Note that if the file {\tt bullet.bmp}\index{bullets} is found by Tex2RTF, this bitmap
will be used as the bullet for items in \verb$\itemize$ lists, for WinHelp
output. Otherwise, a symbol will be inserted (linear RTF) or bold `o'
will be used instead (all other formats).

Syntax error reporting is fairly minimal. Unrecognised macro errors may
actually be produced by an unbalanced brace or passing the wrong number of
arguments to a command, so look in the vicinity of the error for the
real cause.

\normalbox{Some of the syntax that is OK for true \LaTeX\ but which trips up
Tex2RTF, may be detected by the TCHECK\index{TCHECK} program included in the tools
directory of the Tex2RTF distribution. Some \LaTeX\ errors may be picked up
by the LACHECK\index{LACHECK} program, also found in the tools directory.}

It is recommended that you run Tex2RTF twice in order to be sure of
resolving all references and including an up-to-date contents page.

If importing RTF files into Word for Windows\index{Microsoft Word}, you may need to reformat
the document. The easiest way to do this is to select all text with
CTRL-A, then reformat with F9. Reformat again to ensure all references
are resolved. For the second format, respond with {\it Update Entire
Table} to prompts.

\winhelponly{
\section{Tex2RTF Interface}

This is the Tex2RTF interface under Windows. Click on an area of the
picture for more information.

$$\imagemap{1cm;0cm}{screen}{mapref}$$

\subsection{Menu bar}\label{menubar}

Use the menubar for interactive operations.

\subsection{Message area}\label{messagearea}

Tex2RTF writes warning and error messages on this window.

\subsection{Status line}\label{statusline}

Displays help on menu items as the user drags the cursor over the menus.

\subsection{Mode indicator}\label{modeindicator}

Displays the output mode Tex2RTF is currently in.
}

\section{Command line arguments}\index{command line arguments}%

These are the optional arguments you may give Tex2RTF on the command line.

\twocolwidtha{5cm}
\begin{twocollist}
\twocolitem{{\bf -bufsize}}{Specifies buffer size in K (default 60 under Windows,
500 under UNIX). Large files (particularly large verbatim environments)
may require a large buffer size, equal to the largest argument of a \LaTeX\ command.
Note that this value may not be larger than 64 under Windows.}
\twocolitem{{\bf -html}}{Specifies HTML (World Wide Web) output.}
\twocolitem{{\bf -interactive}}{Forces interactive mode even if both
filenames are given.}
\twocolitem{{\bf -charset charset}}{Specifies a character set for
RTF production. This can be one of ansi, mac, pc, and pca.
The default is ansi.}
\twocolitem{{\bf -macros filename}}{Specifies a file for the custom macro
file -- see \helpref{Macro not found error}{macronotfound}.}
\twocolitem{{\bf -rtf}}{Specifies linear RTF output.}
\twocolitem{{\bf -sync}}{Forces synchronous mode (no yielding to other
processes) -- usually use this in non-interactive mode.}
\twocolitem{{\bf -twice}}{Tells Tex2RTF to run the conversion twice to ensure all
references and citations are resolved and the contents page included.}
\twocolitem{{\bf -winhelp}}{Specifies Windows Help RTF output.}
\end{twocollist}

\section{Initialisation file syntax}\label{inifile}\index{initialisation file}%

The initialisation file contains further detailed options for
customising Tex2RTF's behaviour. A file may be specified
with the {\tt -macros} command line switch, otherwise Tex2RTF
looks for the file {\tt tex2rtf.ini} in the working directory
or input file directory.

The file may comprise macro\index{macros} (command) definitions or option settings.

The syntax for a macro definition is:

\begin{verbatim}
    \name [number of args] {...LaTeX code...}
\end{verbatim}

For example:

\begin{verbatim}
    \crazy      [2]{{\bf #2} is crazy but #1 is not}
    \something  [0]{}
    \julian     [0]{Julian Smart}
\end{verbatim}

The syntax for an option setting is:

\begin{verbatim}
    name = value
\end{verbatim}

or 

\begin{verbatim}
    name = "value"
\end{verbatim}

For example:

\begin{verbatim}
    conversionMode = RTF
    runTwice = true
    titleFontSize = 12
    authorFontSize = 10
    headerRule = yes
    footerRule = yes
\end{verbatim}

Options expecting boolean values accept {\it 1, 0, true, false, yes, no} in any combination of upper or
lower case.

End-of-line comments are allowed in an initialisation file, using the
hash, semicolon or percent signs to denote the start of a comment, which runs
until the end of the line.

\subsection{Tex2RTF options}\index{options in initialisation file}\index{tex2rtf.ini}\index{initialisation file}\index{macros}%

These are the allowable options in an initialisation file.

\subsubsection{General options}\label{generaloptions}

\twocolwidtha{5cm}
\begin{twocollist}
\htmlignore{\twocolitemruled{Option}{Description}}
\twocolitem{\inioption{compatibility}}{Set to true for maximum \LaTeX\ compatibility, e.g. if
tables crash RTF readers. Should be false (default) if the Tex2RTF guidelines
are followed, e.g. use of $\backslash${\tt row} command in tabular environment.}
\twocolitem{\inioption{conversionMode}}{One of RTF, WinHelp, XLP (or wxHelp), and HTML.}
\twocolitem{\inioption{ignoreInput}}{Adds the filename to the list of files ignored by the $\backslash${\tt input} command.
The only default filename in the list is {\tt psbox.tex}.}
\twocolitem{\inioption{isInteractive}}{If true, runs in interactive mode (the default).}
\twocolitem{\inioption{runTwice}}{If true, runs the converter twice.}
\twocolitem{\inioption{ignoreBadRefs}}{If true (or yes), ignores bad helpref references
and simply writes the text in the first argument. Useful when a program such as HelpGen
generates references to classes documented in another manual.}
\end{twocollist}

\subsubsection{Presentation options}\index{options, presentation}%

\begin{twocollist}
\htmlignore{\twocolitemruled{Option}{Description}}
\twocolitem{\inioption{authorFontSize}}{Specifies the point size for the author and date (RTF only).}
\twocolitem{\inioption{chapterFontSize}}{Specifies the point size for chapter headings (RTF only).}
\twocolitem{\inioption{documentFontSize}}{One of 10, 11 and 12, to specify the main font size
independently of the \LaTeX\ document style command.}
\twocolitem{\inioption{sectionFontSize}}{Specifies the point size for section headings (RTF only).}
\twocolitem{\inioption{subsectionFontSize}}{Specifies the point size for subsection headings (RTF only).}