cvs commit: httpd-apreq-2/build doxygen.conf xsbuilder.pl

[jo...@apache.org]

joes        2003/06/29 16:13:32

  Modified:    .        CHANGES
               build    doxygen.conf xsbuilder.pl
  Log:
  Doxify CHANGES and have WrapXS simply include Request_pod and Cookie_pod files, instead of trying to generate the perldocs.
  
  Revision  Changes    Path
  1.2       +22 -21    httpd-apreq-2/CHANGES
  
  Index: CHANGES
  ===================================================================
  RCS file: /home/cvs/httpd-apreq-2/CHANGES,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- CHANGES	27 Jun 2003 22:03:52 -0000	1.1
  +++ CHANGES	29 Jun 2003 23:13:32 -0000	1.2
  @@ -1,31 +1,32 @@
  -=head Changes with libapreq-2.0.0-dev
  +/** @page CHANGES
   
  -=over 4
  +@section 2.0.0-dev Changes with libapreq-2.0.0-dev
   
  -=item June 27, 2003 - C API [joes]
  +- June 27, 2003 - C API [joes]
   
  -   The new filter-based design required a complete 
  -   departure from libapreq-1.X codebase. libapreq-2
  -   is based solely on APR, and to be fully functional, 
  -   requires a supporting environment similar to Apache-2.
  -   A person wishing to port libapreq-2 to a new environment
  -   needs to provide definitions for the declarations in apreq_env.h.
  +The new filter-based design required a complete 
  +departure from libapreq-1.X codebase. libapreq-2
  +is based solely on APR, and to be fully functional, 
  +requires a supporting environment similar to Apache-2.
  +A person wishing to port libapreq-2 to a new environment
  +needs to provide definitions for the declarations in apreq_env.h.
   
  -=item June 27, 2003 - Perl API [joes]
  +- June 27, 2003 - Perl API [joes]
   
  -   Aggregates are always collected into an APR::Table-based package.
  -   New table packages: Apache::Cookie::Table, Apache::Request::Table,
  -   and Apache::Upload::Table.
  +Aggregates are always collected into an APR::Table-based package.
  +New table packages: Apache::Cookie::Table, Apache::Request::Table,
  +and Apache::Upload::Table.
   
  -=item June 27, 2003 - Perl API [joes]
  +- June 27, 2003 - Perl API [joes]
   
  -   Apache::Cookie->fetch now requires an "environment" argument ($r).
  -   Its return value is blessed into the Apache::Cookie::Jar class.
  +Apache::Cookie->fetch now requires an "environment" argument ($r).
  +Its return value is blessed into the Apache::Cookie::Jar class.
   
  -=item June 27, 2003 - Perl API [joes]
  +- June 27, 2003 - Perl API [joes]
   
  -   Two new request lookup functions:
  -        1) $req->args - param lookup using only the query string
  -        2) $req->body - param lookup using only the POST data
  +Two new request lookup functions:
  +  -# $req->args - param lookup using only the query string
  +  -# $req->body - param lookup using only the POST data
   
  -=back
  +
  +**/
  \ No newline at end of file
  
  
  
  1.4       +7 -2      httpd-apreq-2/build/doxygen.conf
  
  Index: doxygen.conf
  ===================================================================
  RCS file: /home/cvs/httpd-apreq-2/build/doxygen.conf,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- doxygen.conf	28 Jun 2003 22:25:07 -0000	1.3
  +++ doxygen.conf	29 Jun 2003 23:13:32 -0000	1.4
  @@ -301,7 +301,7 @@
   # directories like "/usr/src/myproject". Separate the files or directories 
   # with spaces.
   
  -INPUT                  = src env glue/perl/xsbuilder
  +INPUT                  = . src env
   
   # If the value of the INPUT tag contains directories, you can use the 
   # FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp 
  @@ -310,7 +310,7 @@
   # *.c *.cc *.cxx *.cpp *.c++ *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh *.hxx *.hpp 
   # *.h++ *.idl *.odl
   
  -FILE_PATTERNS          = 
  +FILE_PATTERNS          = *.c *.h CHANGES
   
   # The RECURSIVE tag can be used to turn specify whether or not subdirectories 
   # should be searched for input files as well. Possible values are YES and NO. 
  @@ -921,3 +921,8 @@
   # the documentation for these projects as well.
   
   EXT_DOC_PATHS          = 
  +
  +# PERL
  +
  +GENERATE_PERLMOD       = YES
  +PERLMOD_PRETTY         = YES
  
  
  
  1.8       +23 -0     httpd-apreq-2/build/xsbuilder.pl
  
  Index: xsbuilder.pl
  ===================================================================
  RCS file: /home/cvs/httpd-apreq-2/build/xsbuilder.pl,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -r1.7 -r1.8
  --- xsbuilder.pl	29 Jun 2003 03:41:17 -0000	1.7
  +++ xsbuilder.pl	29 Jun 2003 23:13:32 -0000	1.8
  @@ -170,6 +170,29 @@
   sub my_xs_prefix {'apreq_xs_'}
   sub xs_include_dir { $xs_dir }
   
  +sub mod_pod {
  +    my($self, $module, $complete) = @_;
  +    my $dirname = $self->class_dirname($module);
  +    my @parts = split '::', $module;
  +    my $mod_pod = "$dirname/$parts[-1]_pod";
  +    for ($self -> xs_incsrc_dir, @{ $self->{glue_dirs} }) {
  +        my $file = "$_/$mod_pod";
  +        $mod_pod = $file if $complete;
  +        print "mod_pod $mod_pod $file $complete\n" ;
  +        return $mod_pod if -e $file;
  +    }
  +    undef;
  +}
  +
  +sub write_docs {
  +    my ($self, $module, $functions) = @_;
  +    my $fh = $self->open_class_file($module, '.pod');
  +    my $podfile = $self->mod_pod($module, 1) or return;
  +    open my $pod, "<", $podfile or die $!;
  +    while (<$pod>) {
  +        print $fh $_;
  +    }
  +}
   sub makefilepl_text {
       my($self, $class, $deps,$typemap) = @_;