================================================================================
                          The Quoteriser, Version 1.00
                                 Introduction
================================================================================

  Contents:

    1. About the Quoteriser
    2. Where to Find the Quoteriser
    3. Do-It-Yourself Executables
    4. Standard Waffle at the End of Freeware Documentation
        (a) Credits
        (b) Legals

--------------------------------------------------------------------------------

1. About the Quoteriser

The reader has probably gathered by now that the Quoteriser is a program for
managing quotes. If not, the author can only presume that the reader has
downloaded this file for no particular purpose and hopes that the reader is not
volume-charged on his or her Internet access.

The Quoteriser was written in the author's spare time to facilitate the
maintenance of the author's collection of quotes. The author hopes that others
might similarly find use for this program in the maintenance of their own
collections or to use as a browser for quote libraries (when these become
available; of course, it takes time to create such things).

In addition to being able to store, edit and view quotes, the Quoteriser can
similarly manage biographical details for authors. Indeed, the user can even
do away with the quotes altogether and use the program purely as a biographical
database manager. Also provided is a quote-of-the-day facility.

Typesetting of quotes and biographical notes is accomplished by simple HTML
encoding.

The Quoteriser is an OS/2 Presentation Manager application. If the user does not
run OS/2, he or she will not be able to use the Quoteriser and has three options
available to him or her:

  (a) Buy OS/2 and install it on his or her computer.
  (b) Get the source code and port it to his or her preferred operating system.
  (c) Find someone else who wants to port it to his or her preferred operating
      system.

This version of the Quoteriser is probably not the best-looking or friendlist
program ever written, but it will do the job and I shall be striving to make
version 2.00 of a standard beyond reproach, once I have gotten feedback from
users, and found the time to improve things.

More detailed information about how to use the Quoteriser and the facilities it
has been endowed with is available in the quoter.txt file.

--------------------------------------------------------------------------------

2. Where to Find the Quoteriser

Of course, since you're reading this document, one presumes that you know where
it came from. In case you've forgotten, or obtained the Quoteriser through
strange and obscure channels, I will upload new versions of the Quoteriser to
Hobbes:

	ftp://ftp-os2.nmsu.edu/os2/wpsutil

I use the Australian mirror:

	ftp://archive.latrobe.edu.au/pub/os2/os2/wpsutil

The central point for the dissemination information about the Quoteriser is on
the author's WWW site:

	http://www.modemss.brisnet.org.au/~nps/software/quoteriser.html

Go here for Quoteriser info and URLs of publically-available databases.

--------------------------------------------------------------------------------

3. Do-It-Yourself Executables

The complete C source code for this version of the Quoteriser is available. The
author compiled it with EMX 0.9c, but hopes that porting it to other OS/2
compilers will be trivial (the make file will probably be the hardest part).

If the reader wishes to compile his or her own version of the Quoteriser, he or
she requires two files:

  quot100s.zip - source code for the Quoteriser itself
  gnugdbm.zip  - GNU database manager for OS/2

The Quoteriser source code should be available from the same source as the
executables (quot100x.zip). The GNU database files are available from
ftp.leo.org and several other places (all in Germany, for some reason).

It is a condition of the license for this product that the source code is either
distributed with the executables or available upon request. The author will,
therefore, be prepared to offer any assistance necessary in obtaining the above
two files if he is contacted by any rightful licensee of the product.

Further documentation on compilation of the source code is distributed in the
quot100s.zip file.

--------------------------------------------------------------------------------

4. Standard Waffle at the End of Freeware Documentation

  (a) Credits

  The author of the Quoteriser is Nicholas Paul Sheppard. He lives in Brisbane,
  Australia and does not tolerate advertising material posted to his e-mail
  address.

  E-mail: nps@modemss.brisnet.org.au
    - bug reports
    - suggestions and feature requests
    - help with locating source code and GDBM
    - enquiries

  WWW: http://www.modemss.brisnet.org.au/~nps
    - latest information on the Quoteriser, including URLs for publically-
      available quote and author databases
    - information on other software I have written
    - a mirror of the OS/2 API site at EDM/2
    - The World of Cynicism and Negativity, containing the bulk of my personal
      quote collection, among other things


  The Quoteriser's quote and biography database management is handled by the
  GNU database manager library. This was written by Philip A. Nelson and
  ported to OS/2 by Kai Uwe Rommel. Without this piece of software, the
  Quoteriser would have been a lot longer in coming.


  The Quoteriser icon was designed and drawn by John Bambrick, who also came up
  with the name "Quoteriser".


  (b) Legals

  The Quoteriser is distributed under the GNU General Public License; the file
  COPYING describes this license. If you did not get this file with your copy of
  the Quoteriser, (a) you have a faulty copy of the distribution, and (b) you
  can get a copy by e-mailing the author with a polite request for its supply or
  by contacting the Free Software Foundation (try http://www.gnu.org).

--------------------------------------------------------------------------------
