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.