News::Collabra - Administrate an iPlanet Collabra news server

COPYRIGHT:
    Copyright (c) 1999-2002 Nathan Bailey.  All rights reserved.
 
LICENSE:
    This program 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; either version 1, or (at
    your option) any later version.

LIMITATIONS:
    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.

*******************************************************************************
STATUS:
    This code should be considered very much as work-in-progress.  Any
    part of this release could be subject to change.  'Modules list'
    status is as follows:
Name           DSLIP  Description                                  Info
-------------  -----  -------------------------------------------- -----
News::Collabra bdpOg  iPlanet Collabra administrative functions    NATE

INSTALLATION:
    News::Collabra uses the following modules/distributions.

	LWP::UserAgent	 - required, for communication with the admin server
	URI::Escape      - required, needed for URL encoding
	IO::Socket       - required, needed for server status
	News::NNTPClient - optional, needed for deleting articles in a ng

    First ensure the above modules/distributions are installed (perhaps
    by using a command such as 'perl -e "use LWP::UserAgent; use \
    IO::Socket; use URI::Escape; use News::NNTPClient;"') then
    build/test/install News::Collabra by doing:

*******************************************************************************
*** NOTE!!! This isn't done yet.  Will be done for the next version.
*******************************************************************************
            perl Makefile.PL
            make
            make test
            make install

    This module contains documentation on the object and its methods.
    Once installed you can use the 'perldoc News::Collabra' command to
    obtain the documentation.  This package also includes several
    test scripts with example code.

*******************************************************************************
COMPATIBILITY:
    This module was developed on Solaris 2.6 with Collabra 3.52.

TODO:
    Make a makefile [Done]
    Complete refactoring of communications code [Done]
    Complete migration of communications code from sockets to lwp agents [Done]
    Better support for ACL creation, modification and removal [80% there]
    Improved return values
    Improved robustness (handling unexpected input/output)

BUGS:
    Bug reports can be sent to the author via his CPAN address.
