RTF converter for WinOne
========================


What is the RTF converter?
--------------------------

This is a program that can be used to easily generate printable documentation
from a help file. RTF transforms the original .RTF file (that is used to create
the help file) into a new .RTF file. The transformation includes :-

	1. inserting all the bitmaps.
	2. converting all the topic title foot notes into table entries fields.
	3. converting all keyword foot notes into index entries.
	4. removing all foot notes.
	5. removing all hidden text.
	6. converting all context jumps to plain text.
	7. and some more things that escape me at the moment.

Once the RTF converter has finished, the new specified .RTF file is ready to be
loaded into Word for Windows or any other word processor that can read rich text
format files. To complete the conversion follow these simple steps :-

	1. Remove anything from the new file that you do not wish to be included.
	2. Add a 'Table of Contents' at the front of the file. From Word select 
	Insert|Table of Contents... and click on the "Use Table Entry Fields". 
	Word will automatically use the topic title foot notes that RTF converted
	to table entry fields. 
	3. Add an index to the end of the file. From Word select Insert|Index. Word
	will automatically use the keywords foot notes that RTF converted to index 
	entries.
	4. Save the file in the desired format. Word is capable of save the file
	as .DOC, .WRI etc.

If you are really keen, you can create a PostScript file by printing the document
to a file instead of a postscript printer.


Who is this program intended for?
---------------------------------

This program is intended to be used by anyone that writes help files and needs
to also provide identical (well almost) documentation in a form that can be
printed in one huge batch.

I use this utility to create all the documentation for WinOne (a shareware program).
This program is capable of working with huge files. Typically, the printable WinOne 
documentation included with WinOne is several megs in size.

This utility is NOT intended to decompile a .HLP file.


Running the RTF converter
-------------------------

Syntax:
	RTF inputfile outputfile

	inputfile	Specifies the .RTF input file
	outputfile	Specifies the .RTF output file.

Notes:
	RTF must be run in the same directory in which your .RTF file
	is located. This ensures that RTF will be able to find the 
	bitmap files.

	parameter inputfile and outputfile should NOT be the same name.

	The program requires the 32 bit version of WinOne to run. From
	CompuServe search the WINSHARE forum for WinOne. Currently WinOne
	lives in the WinNT/95 Util (14) library in a file ntcmd7.zip. This
	may change in the future. The only way to find it is by searching
	for it by keyword.

	The program has only been used on RTF type 1 files. I have never 
	used it on a RTF type 2 file.

	Your original .RTF file is opened in read only mode. This ensures 
	that nothing bad will happen to your original .RTF file.


Disclaimer
----------

This program is FREEWARE and my not be sold or included in any other package 
without the written approval from the author or modified in anyway, shape or 
form.

The standard DISCLAIMER follows :-

THE  AUTHOR  DISCLAIMS  ALL  WARRANTIES  WITH  REGARD  TO  THIS  SOFTWARE,  
INCLUDING  ALL  IMPLIED  WARRANTIES  OF  MERCHANTABILITY  AND  FITNESS,  IN  
NO  EVENT  SHALL  THE  AUTHOR  BE  LIABLE  FOR  ANY  SPECIAL,  INDIRECT  OR  
CONSEQUENTIAL  DAMAGES  OR  ANY  DAMAGES  WHATSOEVER  RESULTING  FROM  LOSS  
OF  USE,  DATA  OR  PROFITS,  WHETHER  IN  AN  ACTION  OF  CONTRACT,  
NEGLIGENCE  OR  OTHER  TORTIOUS  ACTION,  ARISING  OUT  OF  OR  IN  CONNECTION  
WITH  THE  USE  OR  PERFORMANCE  OF  THIS  SOFTWARE.

If you do not agree with the above terms and disclaimer, then you do not have 
permission to use the RTF converter, you must stop using it and remove it 
from your computer.


Contacting the Author
---------------------

To contact the author, send E-mail to :-

Internet Address:	lcinc@cs.newcastle.edu.au
CompuServe ID:		100353,450

Note: 
1. Comments and suggestions are welcome, but if you require support
then please use my Internet account. Since this utility is freeware I
can not support it a great deal and support questions sent to my
CompuServe account will be ignored.

2. Please be considerate! Do not send me questions like :-

	Why is this utility not a DOS program? etc.

For more great programs see my Web page :-

	http://www.cs.newcastle.edu.au/~lcinc/win_one.html
