Wiki content at FAQ Changed by someone at IP 66.213.13.51 :
@@ -1,72 +1,2 @@
=head1 AxKit Frequently Asked Questions
-=head2 I have strage problems -
-
-when I repeatedly load one of my pages, sometimes a bug appears, sometimes it
doesn't. Or, my page is somehow remembering values from a previous request.
-
-See L<DebuggingStrangeProblems>
-
-=head2 C<make test> fails for F<t/02language.t>
-
-The usual problem here is the use of C<XML::LibXML> 1.53. A backwards
incompatible change caused some symbols to not be exported, and so this broke
F<XSP.pm>. We recommend downgrading to C<XML::LibXML> B<1.52> until 1.54 is
considered stable.
-
-=head2 Upon startup of Apache I get the error: "Can't locate loadable object
for module Apache::Log in @INC"
-
-AxKit uses Apache::Log for its logging in some places. This gives us some
extra flexibility. However it is not built into mod_perl by default - you need
to compile it in explicitly. The simplest way to do this is to just compile all
the extra bits of mod_perl:
-
- # in the modperl directory
- perl Makefile.PL EVERYTHING=1
- make
- make test install
-
-See also the various INSTALL documents that ship with mod_perl, and also the
L<mod_perl guide|http://perl.apache.org/guide/>.
-
-If you are using FreeBSD, the easiest way to install AxKit is using the port,
which can be found in /usr/port/www/p5-AxKit; this will fetch and install all
the required modules first.
-
-=head2 AxKit Segfaults
-
-The usual cause is currently a conflict between differing versions of expat
that are being loaded at the same time. This shouldn't happen if you install
expat as a shared library before you compile expat, as it will detect an
installed version during configure.
-
-If you still get problems despite this, you might want to compile apache
without expat. This is done with the following configure option:
-
- ./configure --disable-rule=EXPAT
-
-Another potential problem is with SSL enabled and PHP compiled in E<emdash>
this is due to a conflict between large files support between apache and
mod_perl and/or PHP. To fix this recompile both Apache and mod_perl with the
same large files flags.
-
-=head2 Which XSLT Processor?
-
-AxKit ships with support for two XSLT processors: libxslt and Sablotron.
Sometimes it's quite hard to decide which one to use. Most people choose
libxslt because it's both fast and supports the XSLT 1.0 spec completely.
Sablotron is a little slower, but now supports all of XSLT 1.0. Most AxKit
developers use libxslt (requires XML::LibXSLT) though.
-
-=head2 Bizarre copy of ARRAY in aassign (sic)
-
-This is actually a bug in Perl 5.6.0. See L<this post to
perl5-porters|http://www.xray.mpe.mpg.de/mailing-lists/perl5-porters/2000-06/msg00200.html>
for a patch, or use perl 5.6.1 or higher (or 5.00503).
-
-We do not support versions of perl lower than 5.00503.
-
-=head2 Can I run AxKit on Windows?
-
-Yes, although it is not considered a primary platform, so you are mostly on
your own with this. You can install it via ActiveState's PPM as follows:
-
- ppm install
http://theoryx5.uwinnipeg.ca/ppmpackages/mod_perl-1.25_1.3.17-axkit.ppd
-
-Note that will install mod_perl too. You can install it without mod_perl using
the AxKit.ppd package at the same location. If you have further questions,
please contact the AxKit Users L<mailing
list|http://axkit.org/mailinglists.xml>.
-
-=head2 AxKit fails on looking up stylesheets
-
-If you get an error message in your log with "OK" in it, this may be caused by
having C<CGI::Carp>, or some other module that installs a C<$SIG{__DIE__}>
handler in a broken manner. Make sure you don't have C<CGI::Carp> in your
startup.pl or any other place.
-
-Note: This should no longer happen on AxKit 1.6 or higher.
-
-=head2 Does AxKit work on Apache 2.0?
-
-No. But this is a current active project that a couple of people are working
on. There are two complex parts to this: 1) porting the configuration
directives and the way AxKit loads itself, and 2) making filters work with the
bucket brigades system. That combined with the fact that mod_perl 2.0 isn't
considered stable yet is holding the project back a little bit, but please feel
free to ask about it on the mailing lists.
-
-=head2 How do I search the mailing list archives?
-
-Try here - L<http://www.mail-archive.com/axkit-users@axkit.org/>
-
-You can also use google. Hint: put "axkit-users" in your search string.
-
-=head2 %ENV isn't populated
-
-When you use AxKit via C<SetHandler axkit> or C<AddHandler> then as an
optimisation the C<%ENV> hash is not populated. This is similar to if you set
the mod_perl option C<PerlSetupEnv Off>. In order to have C<%ENV> populated
again you can revert to using C<PerlHandler AxKit>, however a better solution
is to get the things you need from C<%ENV> out of C<$r> instead.