------------ Included files --------
Please check that all the files were extracted correctly from the zip file.

dox.exe         The 16-bit DOS version of dox.
doxhist.txt     The history file for the dox project.
doxdos.txt      This file.
readme.txt      The main readme file.
resume.rtf      An example Rich Text Format file.

NOTICE: Due to problems with memory allocation in command line versions Dox for MSDOS and Linux should not be relied upon to convert more than one file at a time. If you wish to convert many files at once please consider the Windows 95/98/NT/2000 GUI.

As a result Dox for MSDOS is now free and Dox for Linux continues to be GPL.

If all the files are not there then you might like to download them again.
For info go to my site at:
http://users.hunterlink.net.au/~mabatp/


------------- Unpacking dox -----------
Simply unzip the zip file in the directory where you want dox to reside on
your hard drive.

You can then add dox's directory to your path statement. You can add or
change a path statement in autoexec.bat
e.g.
PATH c:\windows;c:\windows\commands

to

PATH c:\windows;c:\windows\commands;c:\dox

Of course you will have to change the c:\dox part to fit where you unzipped
dox originally.


Enjoy dox!


------------- Registering --------------
1. Visit http://users.hunterlink.net.au/~mabatp/dox/register.html
2. Type  register  at the command prompt in the directory where you installed
Dox.
3. You will be asked for the code that you were given when you registered.
4. You can now enjoy dox without reminder screens or an expiration date.


------------- Quickstart ----------------
Dox couldn't be simpler to use in its basic form:
In MS-DOS or inside a MS-DOS window in win95:

Convert to:     Command:
html            dox <InFile> -oh
rtf             dox <InFile> -or
txt             dox <InFile> -ot

Replace <Infile> with the full name of the input file you wish to convert.
Dox is smart enough to figure out the output filename from the -o(h/r/t)
parameter and it's smart enough to figure out the format of the input filename
from the extension that it has. You can use wildcards to specify the input
file.

e.g.
dox bob.rtf -oh
dox *.html -ot



---------------- Advanced -----------------

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
* f = Next command is filename
* s = Use stdin/stdout. Phasing out - refer below.

If you want to send or receive information from stdin or stdout use
a hyphen '-' where dox expects a filename.

e.g.
someapplication|dox -fr - -oft -|more
Pipes rtf output from 'someapplication' to dox, then coverted to text and
piped to more.

------- Full command line description ----------
dox [[-<force>] <infile>] [-o[force] [<outfile>]] [-l <linelength>] [-s] [-?]

-?              Display help information.
-<force>, -o    See introduction. -<force> is for input, -o is for output. 
-l              Set length before wrapping occurs for text output. Default is 80.
-x              eXtract pictures from rtf. (Experiemental).
-b              emBed pictures from rtf in html. (Not implemented).
-s              Ignored.

Dox is copyright 1998-2000 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.

