---------- Welcome to dox -------------
This is the dox information file. I wrote dox because there seemed to be no
other document conversion programme which took all the horrendous and time
consuming processes out of the user's hands. The others insisted on changing
style sheets and all other strange things.

Dox solves these problems. It's simple and it works!

Features:
* Dox can convert to/from rtf/text/html. i.e. It is BIDIRECTIONAL.
* It is easy to use - in most cases you only have to specify two things on the
        command line. The input file and output file.
* Converts font size.
* Freeware - it's free! I would like a postcard or an email to verify that my
        efforts are proving useful to others, though - please see end of
        document.
* Dox is freely distributable.
* Can use win95 long filenames or the 16 bit version may be used.
* Full source is included.

Wish list (these functions aren't implemented):
* Colours.
* Pictures.
* Postscript, Word, Microsoft Help.
* Snazzy windows interface.


------------- Introduction -----------------
Dox is distributed in three forms:
dox110.zip      The DOS & win95 command line version.
dox110d.zip     The DOS command line version only.
dox110w.zip     The win95 command line version only.


There are a number of files included in the dox zip files:
In all zip files there are:
history.txt     The history file for the dox project.
readme.txt      This file.
resume.rtf      An example Rich Text Format file
source.zip      The source code for dox.

In dox110.zip and dox110d.zip there is:
dox.exe         The 16-bit DOS version of dox.

In dox110.zip and dox110w.zip there is:
doxw32.exe      The 32-bit win95 command-line version of dox.
rsxnt.dll       The startup dll for doxw32.exe.


If all the files are not there then you might like to download them again.
For info go to my site at:
http://www.geocities.com/SouthBeach/Surf/6110/dox.html

------------- Using dox ------------
Dox couldn't be simpler to use in its basic form:
At the DOS prompt:
dox [-f] <infile> -o <outfile>

Inside a MS-DOS window in win95:
dox [-f] <infile> -o <outfile>
(if you don't want to use long filenames).

doxw32 [-f] <infile> -o <outfile>
(for long filenames)


Dox assumes the following about the file extensions:
* html = A hyper text markup language file
* htm = Same as html
* rtf = A rich text format file
* txt = A text file

You can override this by adding a "force" character to the -f or -o option:
* h = Force html
* r = Force rtf
* t = Force text

e.g.
dox -fr foo.bnx -ot foo.yrt
This forces foo.bnx to be read as rtf and foo.yrt to be written as plain text.

------- Full command line description ----------
dox [[-f[force]] <infile>] [-o[force] <outfile>] [-F[force]] [-O[force]]
        [-s] [-?]

doxw32 [[-f[force]] <infile>] [-o[force] <outfile>] [-F[force]] [-O[force]]
        [-s] [-?]

-?      Display help information.
-f, -o  See introduction. -f is for input, -o is for output. If no files are
        specified stdin, stout are used.
-F, -O  Allows you to force the input and output without specifing a file.
        Useful when using stdin, stdout.
-s      Font *S*ensitive. Makes the conversion sensitive to the size of the
        font.

------- Conclusion --------
Well that's it! Enjoy using dox. If you have any problem or confusion then
don't hesitate to email me or visit my web site.

One last thing. I would like a postcard or an email just so I know that
people are actually using what I've put together, and to suggest any
improvements that you would like in the software. So please send me something
at one of the addresses or web-pages below.

Andrew Punch
http://www.geocities.com/SouthBeach/Surf/6110/dox.html

email: c9608721@alinga.newcastle.edu.au

snail mail:
PO Box 483,
Hamilton NSW 2303,
Australia.


Dox is copyright 1998 by Andrew Punch. The source code for this programme
may not be used without acknowledgement being given.

The win95 programming was written on djgpp using rsxntdj. Thankyou to
DJ Delorie and Rainer Schnitker respectively for making these packages
available.
