httpd-apreq-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Stas Bekman <>
Subject Re: libapreq-2 doxy docs
Date Tue, 15 Jul 2003 16:54:29 GMT
Joe Schaefer wrote:
> Stas Bekman <> writes:
>>Joe Schaefer wrote:
> [...]
>>But why do you need this automatic handling at all? What's wrong with
>>writing POD in first place? The C and Perl apis have little overlap if
>>at all, no? 
> Right. The issue really has nothing to do with XSBuilder's doc generation,
> since we don't use that at all.  What I'm wondering is whether or not we
> should be using XSBuilder::ParseSource to parse the header files, when it 
> appears that doxygen does a far better job (for instance, doxygen 
> can preprocess and expand selected macros, whereas ParseSource, being P::RD
> based, cannot).
> Of course, with the workarounds in build/, we are able
> to use XSBuilder::ParseSource successully right now, so I'm not going
> to try and "fix" what isn't broken.  However, if something does break in
> the future, or we really want to eliminate build/ from the
> build system, then I suggest we look at doxgen's perlmods as a clean
> replacement for XSBuilder::ParseSource.

My mind is jetlagged, are you saying that you are considering to use doxygen 
to generate the XS glue code?

Stas Bekman            JAm_pH ------> Just Another mod_perl Hacker     mod_perl Guide --->

View raw message