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

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

@titlepage
@title Readme File for Makertf @value{VERSION}
@author Christian Schenk

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

@ifinfo
@node top, What is Makertf?, (dir), (dir)

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

@menu
* What is Makertf?::            What is Makertf?
* Installation::                How to install Makertf
* makertf Invocation::          How to run 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 Makertf

Makertf converts @dfn{Texinfo} file into @dfn{Rich Text Format} (RTF)
files.  You can use Makertf in conjunction with the Windows Help
Compiler to make Windows Help Files from documentation written in
Texinfo.

Makertf is derived from 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 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 environment variable @samp{PATH}.

@node makertf Invocation, Help Project Files, Installation, top
@unnumberedsec How to Run Makertf

The usual way to invoke Makertf is as follows:

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

Makertf accepts most of the command line options available for
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 Makertf to display messages saying what it is doing.

@need 100
@item --version
Report the version number of this copy of Makertf.
@end table

In addition, Makertf accepts the following option:

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

@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

With the @samp{--hpj} option you can tell Makertf to create an HPJ file
for you.

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

Changes to the source code of Makeinfo @value{MAKEINFO_VERSION} are
listed in the file @file{makertf.pat}, which is distributed together
with Makertf. You can apply the change with the help of the GNU Patch
Utility:

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

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

@example
ftp://prep.ai.mit.edu/pub/gnu/texinfo-@value{TEXINFO_VERSION}.tar.gz
@end example

To build the DOS/Windows95 version of Makertf, you will need DJGPP 2.0,
a port of GNU C/C++ for DOS.  See the web page
@file{http://www.delorie.com/} for more information.

@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}:

@example
ftp://ftp.microsoft.com/Softlib/MSLFILES/HC305.EXE
@end example

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

Makertf is free software. You are welcome to redistribute it under the
terms 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
Richard-Wagner-Str. 49
10585 Berlin
Germany

e-mail: cschenk@@berlin.snafu.de
@end example

@bye
