home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: OtherApp / OtherApp.zip / quot100x.zip / doc / intro.txt < prev    next >
Text File  |  1997-04-08  |  6KB  |  147 lines
  1. ================================================================================
  2.                           The Quoteriser, Version 1.00
  3.                                  Introduction
  4. ================================================================================
  5.  
  6.   Contents:
  7.  
  8.     1. About the Quoteriser
  9.     2. Where to Find the Quoteriser
  10.     3. Do-It-Yourself Executables
  11.     4. Standard Waffle at the End of Freeware Documentation
  12.         (a) Credits
  13.         (b) Legals
  14.  
  15. --------------------------------------------------------------------------------
  16.  
  17. 1. About the Quoteriser
  18.  
  19. The reader has probably gathered by now that the Quoteriser is a program for
  20. managing quotes. If not, the author can only presume that the reader has
  21. downloaded this file for no particular purpose and hopes that the reader is not
  22. volume-charged on his or her Internet access.
  23.  
  24. The Quoteriser was written in the author's spare time to facilitate the
  25. maintenance of the author's collection of quotes. The author hopes that others
  26. might similarly find use for this program in the maintenance of their own
  27. collections or to use as a browser for quote libraries (when these become
  28. available; of course, it takes time to create such things).
  29.  
  30. In addition to being able to store, edit and view quotes, the Quoteriser can
  31. similarly manage biographical details for authors. Indeed, the user can even
  32. do away with the quotes altogether and use the program purely as a biographical
  33. database manager. Also provided is a quote-of-the-day facility.
  34.  
  35. Typesetting of quotes and biographical notes is accomplished by simple HTML
  36. encoding.
  37.  
  38. The Quoteriser is an OS/2 Presentation Manager application. If the user does not
  39. run OS/2, he or she will not be able to use the Quoteriser and has three options
  40. available to him or her:
  41.  
  42.   (a) Buy OS/2 and install it on his or her computer.
  43.   (b) Get the source code and port it to his or her preferred operating system.
  44.   (c) Find someone else who wants to port it to his or her preferred operating
  45.       system.
  46.  
  47. This version of the Quoteriser is probably not the best-looking or friendlist
  48. program ever written, but it will do the job and I shall be striving to make
  49. version 2.00 of a standard beyond reproach, once I have gotten feedback from
  50. users, and found the time to improve things.
  51.  
  52. More detailed information about how to use the Quoteriser and the facilities it
  53. has been endowed with is available in the quoter.txt file.
  54.  
  55. --------------------------------------------------------------------------------
  56.  
  57. 2. Where to Find the Quoteriser
  58.  
  59. Of course, since you're reading this document, one presumes that you know where
  60. it came from. In case you've forgotten, or obtained the Quoteriser through
  61. strange and obscure channels, I will upload new versions of the Quoteriser to
  62. Hobbes:
  63.  
  64.     ftp://ftp-os2.nmsu.edu/os2/wpsutil
  65.  
  66. I use the Australian mirror:
  67.  
  68.     ftp://archive.latrobe.edu.au/pub/os2/os2/wpsutil
  69.  
  70. The central point for the dissemination information about the Quoteriser is on
  71. the author's WWW site:
  72.  
  73.     http://www.modemss.brisnet.org.au/~nps/software/quoteriser.html
  74.  
  75. Go here for Quoteriser info and URLs of publically-available databases.
  76.  
  77. --------------------------------------------------------------------------------
  78.  
  79. 3. Do-It-Yourself Executables
  80.  
  81. The complete C source code for this version of the Quoteriser is available. The
  82. author compiled it with EMX 0.9c, but hopes that porting it to other OS/2
  83. compilers will be trivial (the make file will probably be the hardest part).
  84.  
  85. If the reader wishes to compile his or her own version of the Quoteriser, he or
  86. she requires two files:
  87.  
  88.   quot100s.zip - source code for the Quoteriser itself
  89.   gnugdbm.zip  - GNU database manager for OS/2
  90.  
  91. The Quoteriser source code should be available from the same source as the
  92. executables (quot100x.zip). The GNU database files are available from
  93. ftp.leo.org and several other places (all in Germany, for some reason).
  94.  
  95. It is a condition of the license for this product that the source code is either
  96. distributed with the executables or available upon request. The author will,
  97. therefore, be prepared to offer any assistance necessary in obtaining the above
  98. two files if he is contacted by any rightful licensee of the product.
  99.  
  100. Further documentation on compilation of the source code is distributed in the
  101. quot100s.zip file.
  102.  
  103. --------------------------------------------------------------------------------
  104.  
  105. 4. Standard Waffle at the End of Freeware Documentation
  106.  
  107.   (a) Credits
  108.  
  109.   The author of the Quoteriser is Nicholas Paul Sheppard. He lives in Brisbane,
  110.   Australia and does not tolerate advertising material posted to his e-mail
  111.   address.
  112.  
  113.   E-mail: nps@modemss.brisnet.org.au
  114.     - bug reports
  115.     - suggestions and feature requests
  116.     - help with locating source code and GDBM
  117.     - enquiries
  118.  
  119.   WWW: http://www.modemss.brisnet.org.au/~nps
  120.     - latest information on the Quoteriser, including URLs for publically-
  121.       available quote and author databases
  122.     - information on other software I have written
  123.     - a mirror of the OS/2 API site at EDM/2
  124.     - The World of Cynicism and Negativity, containing the bulk of my personal
  125.       quote collection, among other things
  126.  
  127.  
  128.   The Quoteriser's quote and biography database management is handled by the
  129.   GNU database manager library. This was written by Philip A. Nelson and
  130.   ported to OS/2 by Kai Uwe Rommel. Without this piece of software, the
  131.   Quoteriser would have been a lot longer in coming.
  132.  
  133.  
  134.   The Quoteriser icon was designed and drawn by John Bambrick, who also came up
  135.   with the name "Quoteriser".
  136.  
  137.  
  138.   (b) Legals
  139.  
  140.   The Quoteriser is distributed under the GNU General Public License; the file
  141.   COPYING describes this license. If you did not get this file with your copy of
  142.   the Quoteriser, (a) you have a faulty copy of the distribution, and (b) you
  143.   can get a copy by e-mailing the author with a polite request for its supply or
  144.   by contacting the Free Software Foundation (try http://www.gnu.org).
  145.  
  146. --------------------------------------------------------------------------------
  147.