\input texinfo    @c -*-texinfo-*-
@comment %**start of header
@setfilename makertf.rtf
@settitle Makertf @value{VERSION}
@set VERSION 1.03
@set MAKEINFO_VERSION 1.63
@paragraphindent none
@comment %**end of header
@ifinfo
Readme File for @code{makertf} version @value{VERSION}.

Copyright (C) 1994, 1995 Christian Schenk
@end ifinfo

@titlepage
@title Makertf
@subtitle Converting Texinfo files into RTF files
@author Christian Schenk

@page
@vskip 0pt plus 1filll
Copyright @copyright{} 1994, 1995 Christian Schenk
@end titlepage

@ifinfo
@node top, What is makertf?, (dir), (dir)
@unnumbered @code{makertf}

This is the Readme File for @code{makertf} version @value{VERSION}.
@end ifinfo

@menu
* What is makertf?::            What is @code{makertf}?
* Installation::                How to install @code{makertf}
* makertf Invocation::          How to Run @code{makertf}
* Help Project Files::          Help Project Files
* Makeinfo changes::            Changes to @file{makeinfo.c}
* Getting the Help Compiler::   Getting the Help Compiler
* Copying::                     Copying
* Bugs::                        Reporting Bugs
@end menu

@node  What is makertf?, Installation, top, top
@unnumberedsec What is @code{makertf}?

@code{makertf} is a program for converting @dfn{Texinfo} files
into @dfn{Rich Text Format} (RTF) files. The Windows Help Compiler takes
RTF files as input. Therefore you can use @code{makertf} to convert
Texinfo documents into Windows Help Files.

@code{makertf} is derived from @code{makeinfo}
@value{MAKEINFO_VERSION}, which is a part of the GNU Texinfo documentation
system.

@node Installation, makertf Invocation, What is makertf?, top
@unnumberedsec How to install @code{makertf}

Copy the files @file{makertf.exe} and @file{cwsdpmi.exe} into a
directory of your choice. Make sure that this directory is reachable via
the environmental variable @samp{PATH}.

@node makertf Invocation, Help Project Files, Installation, top
@unnumberedsec How to Run @code{makertf}

The usual way to invoke @code{makertf} is as follows:

@example
makertf [@var{options}] @var{infile}
@end example

@code{makertf} accepts most of the command line options available for
@code{makeinfo}. This is a list of the most common options:

@table @code
@item --output @var{file}
@itemx -o @var{file}
Specify that the output should be directed to @var{file}.

@need 100
@item --verbose
Cause @code{makertf} to display messages saying what it is doing.

@need 100
@item --version
Report the version number of this copy of @code{makertf}.
@end table

In addition, @code{makertf} accepts the following option:

@table @code
@item --hpj @var{file}
Cause @code{makertf} to create a help project file.
@end table

For example, use this command to create the RTF file @file{makertf.rtf}
and the HPJ file @file{makertf.hpj}:

@example
makertf --output makertf.rtf --hpj makertf.hpj makertf.tex
@end example

The Windows Help File @file{makertf.hlp} is then created by running
the Help Compiler:

@example
hc31 makertf
@end example

@node Help Project Files, Makeinfo changes, makertf Invocation, top
@unnumberedsec Help Project Files

You specify options for the Windows Help Compiler by editing a @dfn{Help
Project File} (HPJ File). For example, this is the HPJ File for
@file{makertf.hlp}:

@example
[options]
title=Makertf @value{VERSION}
compress=yes
contents=top

[files]
makertf.rtf
@end example

@code{makertf} creates an HPJ File when you use the command line
option @samp{--hpj}.

@node Makeinfo changes, Getting the Help Compiler, Help Project Files, top
@unnumberedsec Changes to @file{makeinfo.c}

Changes to the source code of @code{makeinfo} @value{MAKEINFO_VERSION}
are listed in the file @file{makertf.pat}, which is distributed together
with @code{makertf}. If you have the Patch Utility, you can apply the
changes with the following command:

@example
patch --output=makertf.c makeinfo.c makertf.pat
@end example

@code{makeinfo} is part of the GNU Texinfo documentation system.  You
can get GNU Texinfo from host @file{prep.ai.mit.edu} using anonymous
FTP.

@node Getting the Help Compiler, Copying, Makeinfo changes, top
@unnumberedsec Getting the Help Compiler

The Windows Help Compiler is available via anonymous FTP from host
@file{ftp.microsoft.com}. Lookout for @file{HC505.EXE} in directory
@file{./Softlib/MSLFILES}.

@node Copying, Bugs, Getting the Help Compiler, top
@unnumberedsec Copying

@code{makertf} is free software, and you are welcome to redistribute it
under the conditions of the GNU General Public License (see file
@file{COPYING}).

@node Bugs,  , Copying, top
@unnumberedsec Reporting Bugs

Please send suggestions and bug reports to:

@example
Christian Schenk
Deutsche Telephonwerke AG & Co.
Abteilung GSS5
Zeughofstr. 1
10997 Berlin
Germany

Fon: +49 30 6104-4276
Fax: +49 30 6105-5302

e-mail: cschenk@@gs.detewe.de
@end example

@bye
