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