readme.txt : ascii2ht or ascii2ht.exe (depending on your OS)

For the latest version (the online readme) visit
http://www.geocities.com/SouthBeach/1019/readme.html.



CONTENTS
  I.    The Program
       A.  What It Does
       B,  System Requirements
  II.   All I Ask in Return (no, not money)
  III.  The Source Code
  IV.  Bugs
       A.  Known Bugs
       B.  Report a Bug
  V.    History







I                          THE PROGRAM
A.                         What it Does
     This program is supposed to make converting ASCII to HTML easier
by putting in the basic line breaks, header/footer information, and the
occasional horizontal rule (when it encounters five or more '-' 
characters in a row.
usage:
  ascii2ht [-v] (ASCII input file) (HTML output file)

    -v   indicates the input text is verse, and to treat it accordingly
         (the default is prose).
  ascii2ht will create or empty the HTML output file.






B.                     System Requirements
     As far as I know this will run on any system.  If you learn 
differently, please let me know (see the section called Report a Bug).















III                        THE SOURCE CODE

     The code is named "ascii2ht.txt" but it is C code, so be sure to
rename it "asciiht.c" when you download it.  At the time I write 
this, GeoCities (my WWW provider) does not allow *.c files (a mere
oversight they will surely correct soon), so I had to give it a
.txt extention.
     It's ANSI C that I compiled using Borland C++ 5 and the most
recent gnu C for the UNIX platforms I mention later.  I must confess
I don't know what version number the most recent gnu is (or was as
of the "initial release" date in section IV,
     Feel free to change the code to suit your needs, that's half
the reason I'm distributing it.  I know the code could be better,
but I don't feel like spending all my time cleaning up a program
that is already small and fast.  Dont pester me with email telling
me my code stinks or suggesting changes that only enhance the geekly
appeal of the code but do not change the program's features.
     Don't ask for help because I won't give it to you.  The code is
only for "advanced" people, not just any luser.
     I have compiled this under the following OSs and it seems to
work fine:  LINUX, Solaris 2., x86 2.5, and DOS (Win95, actually, 
but I tested it in DOS 6.0.  If you're using something else, like
a VAX (heaven help you) it should still work.  If it doesn't then let
me know.















IV                          BUGS

A.                          Known Bugs
This program has the following bugs:
#    Date    Description
------------------------------------------------------------------
no known bugs.





B.                          Report a bug

     To report a bug send email to response@mindless.com.  Be sure
to include the following information:  a detailed description of the
bug, your OS (and version), the file/file piece that found the bug,
and your preferred manner of death should this bug report match one
in the online readme or should this bug report be false.















V                           HISTORY

Version   Date       Description
------------------------------------------------------------------
1.0r1     03/98      initial release.