
	The Coconut Library - Steel Wheels Objective-C Class Library

  Copyright (C) 2001, 2002 Steel Wheels Project

  Coconut is free software; you can redistribute it and/or modify
  it under the terms of the GNU Lesser General Public License as published 
  by the Free Software Foundation; either version 2 of the License, or
  (at your option) any later version.

  This program 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 Lesser General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

Introduction
============
    The coconut library is an Objective-C class library for PC-UNIX System.
    The feature is:
    	(1) designed for PC-UNIX
	(2) all interfaces of methods are defined as protocol
	    the interface of object is splitted from it's implementation.
	(3) bind some major C libraries by seemless way

    This library supporting following C libraries
    	(1) glib   : general purpose data operation
	(2) gtk+   : graphical widgets
	(3) libxml : xml parser
	(4) gnet   : network communication
	(5) popt   : command line option parser

Web Page
========
  The main web page of coconut library is

	"http://www.asahi-net.or.jp/~em7t-hmd/".

  You can get the latest package and information from this page.

Install
=======

  Required Programs
  -----------------
    To compile and install coconut library, these programs are required.

    program	version
    -------	-------
    gcc		2.95.X or 3.0.3 or later	objective-c compiler
    autoconf	2.52 or later
    automake	1.5 
    libtool	1.4 or later

    (note: The old version of autoconf, libtool occurs errors when
           rebuilding "configure" files.)

  Required libraries
  ------------------
    Following libraries are required (or recommended) to install for
    using coconut.  If these package are not installed, some class can not
    be compiled and installed.

    package	version		required	download
    ------	-------		--------	--------
    glib	2.0.0		required	http://www.gtk.org/
    libxml2	2.4.4		required	http://xmlsoft.org/
    popt	1.6.2		required	?
    gtk		2.0.0		recommended	http://www.gtk.org/
    gnet	1.2.2		recommended	?

    o The older version of popt (ex. 1.5.2) can not work with this library.
    o gnet is should be compiled with glib-2.0.
   
  Install
  -------

    [1] Execute configure
          % ./configure 
	(About "configure" script, see the file "INSTALL")

    [2] Execute make command
     	  % make

    [3] Execute "make install" command as a super user
          # make install

  May source be with you !!

Bug Report
==========
  The known BUG which is hard to remove is described in "BUG" file.

  The bug report or comments are welcome. To report a problem about coconut,
  send email to "wheel@osaka.email.ne.jp".

  Especially, I can not write English well. If you find any problem in my
  documents, please tell me about it.

Note
====
 Some files are copied (and modified) from the other GNU package.
 This is a table of copied files.

   original file	package		modified point
   -------------	-------		--------------
   obstack.h		gdb-5.0		rename "fobstack.h"
   obstack.c		gdb-5.0		rename "fobstack.c" and modify
   					"#include" file.

 The coconut library must be linked before objective-C library (when you
 use this library without "coconut-config" utility).

	-lcoconut_gtk -lcoconut_gnet -lcoconut -lobjc -lpthread
 
References
==========
   regular expression (CRegExp class)
   	http://www.kt.rim.or.jp/~kbk/regex/re_toc.html (Japanese)

