-------- Original Message --------
Subject: Autogenerated PODs :-)
Date: Thu, 26 Dec 2002 16:08:03 +0100
From: Gerald Richter <[EMAIL PROTECTED]>
Hi,
finaly I had the time to look at Lyles pod code. It was a good starting
point and I have tweaked it and added a bunch of things, so now we get pods
for mod_perl 2 which looks like a good starting point. I append the new
version along with two example pods to this mail. The next steps that should
be done is to verify that the content of the pods is correct. I have taken a
look around and fixed everything which doesn't looked quite ok to me, but
somebody who has more knowledge of all the functions should verify this.
Also it is possible that the paraser doesn't catch all functions. If
anything is wrong or functions are missing, let me know which ones and I
will fix it. As far as I can tell my time should be not so limited during
january, so I should be able to make fixes quicker then in the last time.
Also I think we should move this to the list, to involve more people. I am
not sure if the docs or the dev list is the best one. I think there are
issues for both...
Gerald
Changes:
- use args instead of doxygen args to iterate over, so we get all arguments,
also when we don't have a comment for them.
- handle non Apache functions (e.g. with mpxs_CLASS_ prefix)
- don't hardcode prefixes, use prefix and class_xs_prefix members instead
- handle return values (single return values only for now)
- ease configuration
Here is what you need to do to get it running:
- Install ExtUtils::XSBuilder (at least 0.23)
- Extract mpbuilder in an empty directory
- Create a config file in mpbuilder/xsbuilder named config.pl which contains
a single line that points to your mod_perl 2 source tree e.g.
$MODPERL="/usr/msrc/cvs/modperl-2.0_bld" ;
- Create symbolic link in the directory where you have extracted mpbuilder
name xs to the xs dirorecty of your mod_perl directory e.g.
ln -s /usr/msrc/cvs/modperl-2.0_bld/xs xs
- Run xsbuilder/source_scan.pl and xsbuilder/xs_generate.pl
- Now you should get the pod files under WrapXS directory
-------------------------------------------------------------
Gerald Richter ecos electronic communication services gmbh
Internetconnect * Webserver/-design/-datenbanken * Consulting
Post: Tulpenstrasse 5 D-55276 Dienheim b. Mainz
E-Mail: [EMAIL PROTECTED] Voice: +49 6133 925131
WWW: http://www.ecos.de Fax: +49 6133 925152
-------------------------------------------------------------
ExtUtils-XSBuilder-0.23.tar.gz
Description: GNU Zip compressed data
mpbuilder-0.02.tar.gz
Description: GNU Zip compressed data
Table.pod
Description: Binary data
RequestRec.pod
Description: Binary data
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
