Xref:	news2.mv.net comp.os.msdos.djgpp:3418
From:	dpsm AT en DOT com (Dale P. Smith)
Newsgroups:	comp.os.msdos.djgpp
Subject:	Re: DJGPP manuals?
Date:	Fri, 03 May 1996 17:30:19 GMT
Organization:	RheoActive
Lines:	155
Message-ID:	<318a41c4.15639564@news.en.com>
References:	<Pine DOT OSF DOT 3 DOT 91 DOT 960504004328 DOT 21230A-100000 AT bud DOT cc DOT swin DOT edu DOT au>
NNTP-Posting-Host:	p28-ts5.en.net
To:	djgpp AT delorie DOT com
DJ-Gateway:	from newsgroup comp.os.msdos.djgpp

Daniel Josef Dekok <080970 AT bud DOT cc DOT swin DOT edu DOT au> wrote:

>On Fri, 3 May 1996, Shawn Lee wrote:
>
>> Daniel Josef Dekok wrote:
>> > 
>> > On 30 Apr 1996, Thomas Womack wrote:
>> > 
>> > > Does there exist a program for converting TexInfo manuals to Windows help-file
>> > > format? I tend to work under Windows95, and I like the idea of having a help-file
>> > > in a 'nice-looking' window on one bit of screen whilst I code in Notepad or its
>> > > equivalent on the other.
>> > 
>> > Well since windows help files are created from a RTF format, you could
>> > change the Texinfo files into RTF, and then compile using the Help Compiler
>> > 
>> > I would have a go, but i don't know anything about RTF or a help
>> > compiler.
>> > 
>> > >
>> > > TIA, Tom
>> > >
>> How would you do all of this?  Has it been tried?
>> 
>> Mr.Lee
>> 
>Once you knew how help files were created, you could either write a 
>program to convert it for you, or i think texinfo would do it, although 
>im not sure.

Someone wrote it already.  It's called makertf.  The GNU makeinfo
program is patched to emit rtf instead of an info file.  I have been
playing around with it for a few days and it works great!

Below is the README

Dale
-------------------------------------------------
Readme File for `makertf' version 1.04.

Copyright (C) 1994, 1995, 1996 Christian Schenk

This is the Readme File for Makertf version 1.04.

What is Makertf
===============

Makertf converts "Texinfo" file into "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 1.64, which is a part of the GNU
Texinfo documentation system.

How to install Makertf
======================

Copy the files `makertf.exe' and `cwsdpmi.exe' into a directory of
your
choice. Make sure that this directory is reachable via the environment
variable `PATH'.

How to Run Makertf
==================

The usual way to invoke Makertf is as follows:

     makertf [OPTIONS] INFILE

Makertf accepts most of the command line options available for
Makeinfo. This is a list of the most common options:

`--output FILE'
`-o FILE'
     Specify that the output should be directed to FILE.

`--verbose'
     Cause Makertf to display messages saying what it is doing.

`--version'
     Report the version number of this copy of Makertf.

In addition, Makertf accepts the following option:

`--hpj FILE'
     Cause Makertf to create a help project file.

Help Project Files
==================

You specify options for the Windows Help Compiler by editing a "Help
Project File" (HPJ File). For example, this is the HPJ File for
`makertf.hlp':

     [options]
     title=Makertf 1.04
     compress=yes
     contents=top
     
     [files]
     makertf.rtf

With the `--hpj' option you can tell Makertf to create an HPJ file for
you.

Changes to `makeinfo.c'
=======================

Changes to the source code of Makeinfo 1.64 are listed in the file
`makertf.pat', which is distributed together with Makertf. You can
apply the change with the help of the GNU Patch Utility:

     patch --output=makertf.c makeinfo.c makertf.pat

Makeinfo is part of the GNU Texinfo documentation system.  You can get
GNU Texinfo from host `prep.ai.mit.edu' using anonymous FTP:

     ftp://prep.ai.mit.edu/pub/gnu/texinfo-3.7.tar.gz

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
`http://www.delorie.com/' for more information.

Getting the Help Compiler
=========================

The Windows Help Compiler is available via anonymous FTP from host
`ftp.microsoft.com':

     ftp://ftp.microsoft.com/Softlib/MSLFILES/HC305.EXE

Copying
=======

Makertf is free software. You are welcome to redistribute it under the
terms of the GNU General Public License (see file `COPYING').

Reporting Bugs
==============

Please send suggestions and bug reports to:

     Christian Schenk
     Richard-Wagner-Str. 49
     10585 Berlin
     Germany
     
     e-mail: cschenk AT berlin DOT snafu DOT de



Dale P. Smith
dpsm AT en DOT com        home
dpsm AT lubrizol DOT com  work

- Raw text -