Apache::Admin::Config version 0.05
=========================

INSTALLATION

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

CHANGES

0.05  Sat Aug 18 14:39:45 2001
        - Bug fix, $master value was undefined in value method, so value wasn't work at all

0.04  Fri Aug 17 01:42:16 2001
        - Fix a minor bug in directive method.

0.03  Fri Aug 17 01:07:17 2001
        - Fix a major bug in directive method.

0.02  Thu Aug 16 01:48:54 2001
        - Put module on CPAN
        - Fix a very major bug that cause "syntax error" from parser on directives with
          no value like "clearmodulelist", thanx A2 for this report.

0.01  Sun Aug 12 11:58:10 2001
	- Original version; created by h2xs 1.21 with options -AX -n Apache::Admin

SYNOPSIS
        use Apache::Admin::Config;

        my $apache_conf = new Apache::Admin::Config ("/path/to/config_file.conf")
            || die $Apache::Admin::Config::ERROR;

        # parsing contents
        my @directives      = @{ $apache_conf->directive() || die $apache_conf->error };
        my @sections        = @{ $apache_conf->section() || die $apache_conf->error };
        my @file_sections   = @{ $apache_conf->section('file') || die $apache_conf->error };

        # parsing file section contents
        my @file_directives = @{ $apache_conf->section(file=>$file_sections[0])->directive };
        my @file_sections   = @{ $apache_conf->section(file=>$file_sections[0])->section };

        # adding directive/section
        $apache_conf->add_directive(Options=>'+Indexes');
        $apache_conf->section(File=>'/some/file')->add_directive(Allow=>'from all');

        $apache_conf->add_section(File=>'/some/file');
        $apache_conf->section(VirtualHost=>'some.host')->add_section(File=>'/some/file');

        # change directive value
        $apache_conf->directive(Options=>'+Indexes')->value('+Indexes -FollowSymlinks');
        $apache_conf->section(File=>'/some/file')->directive(Allow=>'from all')->value('from 127.0.0.1');
    
        $apache_conf->section(File=>'/some/file')->value('/some/other/file');
        $apache_conf->section(VirtualHost=>'some.host')->section(File=>'/some/file')->value('/some/other/file');

        # delete directive (the last one if more than one identicales)
        $apache_conf->directive(Options=>'+Indexes')->delete;
        $apache_conf->section(File=>'/some/file')->directive(Allow=>'from all')->delete;

        $apache_conf->section(File=>'/some/file')->delete;
        $apache_conf->section(VirtualHost=>'some.host')->section(File=>'/some/file')->delete;

        # save changes
        $apache_conf->save;
        $apache_conf->save('/path/to/another/file.conf');

DESCRIPTION
    under construction

METHODES
  new

    under construction

  save

    under construction

  delete

    under construction

  value

    under construction

  add_section

    under construction

  section

        @sections_name      = $obj->section;
        @sections_entrys    = $obj->section(SectionName);
        $section_object     = $obj->section(SectionName=>'value');

    arguments:

    name : the name of section, it's "File" in section <File
    "/path/to/file"></File</File> value : the value of the section

  add_directive

    under construction

  directive

    under construction

  error

    under construction

AUTHOR
    Olivier Poitrey <rs@rhapsodyk.net>

LICENCE
    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 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 General Public License along
    with the program; if not, write to the Free Software Foundation, Inc. :

    59 Temple Place, Suite 330, Boston, MA 02111-1307

COPYRIGHT
    Copyright (C) 2001 - Olivier Poitrey

HISTORY
    $Log: README,v $
    Revision 1.8  2001/08/18 12:43:00  rs
    conflict merged

    Revision 1.7  2001/08/17 08:53:22  rs
    integration of Changes in README

    Revision 1.6  2001/08/16 23:43:19  rs
    move to 0.04

    Revision 1.5  2001/08/16 23:08:39  rs
    update infos for version 0.03

    Revision 1.4  2001/08/15 23:58:25  rs
    changes for 0.02

    Revision 1.3  2001/08/15 23:44:18  rs
    add the pod documentation of Apache::Admin::Config
 Revision 1.6 2001/08/14 09:49:07 rs adding some pod
    sections