----------------------------------------------------------------------------- -- -- 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. -- ----------------------------------------------------------------------------- Installation ------------ libwww-ada95 uses the configure script to perform compilation and installation of the library. Instructions for running configure are in the INSTALL file. In addition, the following custom options are available: --enable-debug Turn on debugging options --with-platform=letter Select another platform's specific files (debug) --with-extra-libs=libs Add extra libraries when building a program We have included the files for using automake and autoconf (GNU programs for building portable configure scripts) to automatically create the Makefiles, since that may be helpful for programmers distributing libwww-ada95 along with their own code. Documentation ------------- There isn't any. Until we get something written up, you'll have to read the comments in the code and the example programs. More information can be found at the libwww-ada95 website: http://www.ics.uci.edu/pub/websoft/libwww-ada95/ The libwww-ada95 source code is split into three directories: Onions The Onions Network Streams Library provides an operating system independent, thick binding to Unix socket, file, and directory resources in the form of layered data streams. See Onions/README for more information about how and why it works. Onions is independent of the rest of libwww-ada95 and can be used for projects unrelated to the Web. All of our system-dependent code is isolated here. 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. Examples Small application programs for testing the libraries and providing an example of how the API works. Platforms --------- We have only tested libwww-ada95 on our own development platform, Solaris 2.5. libwww-ada95 has also been reported to work on ... libwww-ada95 was developed using the GNAT 3.10p compilation system. We have made every effort to keep the Ada95 source code independent of the compiler, but the Makefiles generated by configure may be GNAT-dependent. We have no idea how to port it to other compilers, but please let us know if you do and what changes (if any) are needed. Note that the library has been designed to maximize portability even though we didn't have the resources to test it on other platforms. Future Development ------------------ We have (long ago) exhausted all of our resources for further development of the libwww-ada95 and Onions libraries. We are currently looking for a new source of support for the library, either in the form of a long-term grant or by transition to another organization with a history of Ada95 and open-source software development. If you are interested, please contact us. Project status and updates can be found at http://www.ics.uci.edu/pub/websoft/libwww-ada95/ A mailing list has been established for discussion of development and future support for libwww-ada95 and Onions. To subscribe, send a message to with "subscribe" in the Subject. A hypermail archive of the mailing list is available at the website. libwww-ada95 History -------------------- Created in 1997 by Roy T. Fielding, Kari Nies, and Yuzo Kanomata. Principal Investigator: Dr. Richard N. Taylor The libwww-ada95 library has been developed by the Hyperware research group in Information and Computer Science at the University of California, Irvine, in order to help support the creation of innovative network client implementations using the Ada95 language. For more information about Hyperware, see . UCI's libwww-ada95 effort has been sponsored in part by the Defense Advanced Research Projects Agency, and Rome Laboratory, Air Force Materiel Command, USAF, under agreement numbers F30602-94-C-0218 and F30602-97-2-0021. The U.S. Government is authorized to reproduce and distribute reprints for Governmental purposes notwithstanding any copyright annotation thereon. The views and conclusions contained herein are those of the authors and should not be interpreted as necessarily representing the official policies or endorsements, either expressed or implied, of the Defense Advanced Research Projects Agency, Rome Laboratory or the U.S. Government.