joes 2004/07/02 08:13:08
Modified: . Makefile.am
build doxygen.conf.in
src groups.dox.in
Added: . FAQ.pod
Removed: . FAQ
Log:
Switch from doxy to pod for FAQ format, mainly because pod is easier to work
with.
Revision Changes Path
1.28 +4 -1 httpd-apreq-2/Makefile.am
Index: Makefile.am
===================================================================
RCS file: /home/cvs/httpd-apreq-2/Makefile.am,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -r1.27 -r1.28
--- Makefile.am 1 Jul 2004 15:22:56 -0000 1.27
+++ Makefile.am 2 Jul 2004 15:13:08 -0000 1.28
@@ -9,6 +9,7 @@
COOKIE_POD=$(POD_PREFIX)/Cookie/Cookie_pod
REQUEST_POD=$(POD_PREFIX)/Request/Request_pod
UPLOAD_POD=$(POD_PREFIX)/Upload/Upload_pod
+FAQ_POD=FAQ.pod
SED_BODY_TAG= s(^[\S\s]+<body.+|</body>[\S\s]+$$)()gi
EUM=ExtUtils::Manifest
@@ -54,7 +55,7 @@
$(mkinstalldirs) $(DESTDIR)$(pkgdatadir)
cp -a docs $(DESTDIR)$(pkgdatadir)
-pod2html: Request.html Cookie.html Upload.html
+pod2html: Request.html Cookie.html Upload.html FAQ.html
Cookie.html: Makefile.am $(COOKIE_POD)
pod2html <$(COOKIE_POD) | perl -0777 -pe '$(SED_BODY_TAG)' > Cookie.html
@@ -62,6 +63,8 @@
pod2html <$(REQUEST_POD)| perl -0777 -pe '$(SED_BODY_TAG)' >
Request.html
Upload.html: Makefile.am $(UPLOAD_POD)
pod2html <$(UPLOAD_POD)| perl -0777 -pe '$(SED_BODY_TAG)' > Upload.html
+FAQ.html: Makefile.am $(FAQ_POD)
+ pod2html <$(FAQ_POD) | perl -0777 -pe '$(SED_BODY_TAG)' > FAQ.html
apr_tags: docs/apr.tag docs/apu.tag
1.1 httpd-apreq-2/FAQ.pod
Index: FAQ.pod
===================================================================
=head1 Issues during installation.
[...]
=head1 Using libapreq2 with Apache 2 and mod_perl 2.
=head2 When I use Apache::Request in my output filter, it seems to lose the
incoming POST variables.
The problem is likely that the mod_apreq filter has not been
added to the input filter chain in time to read the POST data.
There are two solutions to this problem:
1) Write a filter init handler for you filter that instantiates an
Apache::Request object.
http://perl.apache.org/docs/2.0/api/Apache/Filter.html#C_FilterInitHandler_
2) Use .htaccess or your server config to ensure the apreq input filter
is active for this request with "AddInputFilter APREQ" or somesuch.
We recommend using (1), and falling back to (2) until you get (1) working.
=head2 When I try to upload a file, why do I get this error "[error] Can't
locate .../Apache/Request/upload.al in @INC"?
I<Apache::Upload> is now a separate module in apreq2, so you need to
C<use Apache::Upload> to load the C<Apache::Request::upload> function.
=head1 CGI
Using libapreq2 outside of Apache.
1.3 +1 -1 httpd-apreq-2/build/doxygen.conf.in
Index: doxygen.conf.in
===================================================================
RCS file: /home/cvs/httpd-apreq-2/build/doxygen.conf.in,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- doxygen.conf.in 23 Jun 2004 02:22:28 -0000 1.2
+++ doxygen.conf.in 2 Jul 2004 15:13:08 -0000 1.3
@@ -28,7 +28,7 @@
WARN_FORMAT = "$file:$line: $text"
INPUT = . src env
-FILE_PATTERNS = *.c *.h *.dox CHANGES STATUS FAQ
+FILE_PATTERNS = *.c *.h *.dox CHANGES STATUS
RECURSIVE = NO
EXCLUDE =
EXCLUDE_SYMLINKS = NO
1.3 +5 -0 httpd-apreq-2/src/groups.dox.in
Index: groups.dox.in
===================================================================
RCS file: /home/cvs/httpd-apreq-2/src/groups.dox.in,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- groups.dox.in 26 Jun 2004 01:49:19 -0000 1.2
+++ groups.dox.in 2 Jul 2004 15:13:08 -0000 1.3
@@ -77,3 +77,8 @@
* @ingroup apreq_xs
* @htmlinclude Cookie.html
*/
+
+/**
+ * @page apreq_faq FAQ
+ * @htmlinclude FAQ.html
+ */
