-----------------------------------------------------------------------------
--
--                               libwww-ada95
--                  WWW Protocol Library for Ada95 Clients
--              http://www.ics.uci.edu/pub/websoft/libwww-ada95/
--
--                                R E A D M E
--
--     Copyright (C) 1997-1998  Regents of the University of California
--
--  libwww-ada95 is free software; you can redistribute it and/or modify it
--  under the terms of the GNU General Public License as published by the Free
--  Software Foundation, with or without the single exception listed below;
--  either version 2, or (at your option) any later version.  libwww-ada95 is
--  distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
--  without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
--  PARTICULAR PURPOSE.  See the GNU General Public License for more details.
--  You should have received a copy of the GNU General Public License
--  distributed with libwww-ada95; see the file COPYING.  If not, write to the
--  Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA
--  02111-1307, USA.
--
--  As a special exception, if other files instantiate generics from this
--  library, or you link this library with other files to produce an
--  executable, this library does not by itself cause the resulting
--  executable to be covered by the GNU General Public License.  This
--  exception does not however invalidate any other reasons why the
--  executable file might be covered by the GNU General Public License.
--
-----------------------------------------------------------------------------

See ../README and ../INSTALL for more information about the libwww-ada95
library and installation instructions.


WWW: A client API for the World Wide Web
----------------------------------------
Unfortunately, this code has not been finished, and only parts of it
have been tested.  See WWW/DesignNotes for an idea of what the
completed library is supposed to do.

Within libwww-ada95, the first component of the package name defines
both the overall purpose of the package and the degree to which it is
independent of the other packages and WWW functionality in general.
The idea is that programmers wishing to use only a small part of the
library should only have to link with that small part of the library.
For example,

   Util.*  -- general Ada95 ADTs and helper routines
   URI.*   -- Uniform Resource Identifier parsing and relative addressing
   MIME.*  -- MIME-style message encapsulation and parsing
   HTTP.*  -- Hypertext Transfer Protocol request handler
   FTP.*   -- File Transfer Protocol request handler
   HTML.*  -- Hypertext Markup Language generation and parsing
   XML.*   -- Extensible Markup Language generation and parsing
   WWW.*   -- The simple request/response interface (the WWW API).

The WWW package will tie everything together to provide a client API,
but all of the other packages should be usable independently.  Most
will also depend on the Onions Network Streams Library.

The only problem with this naming system is that some of our protocol
stream handlers will be derived from the Onions stream filters, which
means they need to be children of the Onions.Instreams and Outstreams
class packages, which in turn requires that they be named as such. 
This includes

   Onions.Instreams.HTML_Dir
      The HTML Directory Stream is an input stream filter that takes a
      stream of filenames (assumed to be generated by Onions.Instreams.Dir),
      gets the file info for each one via Onions.OS.Stat, and outputs an
      HTML formatted listing similar to that seen on a modern browser.