blob: 7539400e19fc39d4a09ecc2199f5bdd7c965a0fa [file] [log] [blame]
This is mod_perl version 2.0
*** Prerequisites ***
Dynamic mod_perl (DSO): Apache 2.0.47 - 2.4.12.
Static mod_perl: Apache 2.0.51 - 2.4.12.
Newer Apache versions may work with this version of mod_perl. If
not, the svn version likely will, which can be obtained from:
Any stable version of Perl currently in support by the Perl community,
as described in recent Perl distributions' "perlpolicy.pod" document,
EXCEPT THAT Perl 5.22.x is currently not supported due to the problem
reported in
We hope to address that in the next release (2.0.10).
Newer Perl versions may work with this version of mod_perl. If not,
the svn version likely will (see above).
Many older Perl versions also work with this version of mod_perl:
Perls back to version 5.8.2 (and possibly earlier in some build
configurations) are currently believed to work, but this is not
guaranteed to be the case, either now or in the future.
C compiler:
The mod_perl source currently uses GNU89 inline semantics on GCC, but
GCC 5 defaults to newer C99 semantics. If you see MP_INLINE related
warnings during the build and missing symbols when starting the test
suite, adding "-fgnu89-inline" to MP_CCOPTS may help.
There are also some reports of this happening with the Clang compiler,
where the corresponding option to try is "-std=gnu89".
*** Status ***
mod_perl is currently considered stable.
Four test scripts are currently known to fail with Apache 2.4.x on Windows:
t/protocol/echo_block.t (Fails tests 2-3)
t/protocol/echo_nonblock.t (Fails test 2)
t/protocol/echo_timeout.t (Fails tests 2-5)
t/protocol/pseudo_http.t (Fails tests 3-8 and 11-13)
*** Documentation ***
Documentation can be found in the docs/ directory. Currently they
don't get installed on 'make install'. Certain API documentation can
be found in docs/api/. The online version is at
*** Todo ***
mod_perl-2.0 is not 100% feature complete with the 1.xx version.
See the files in the todo/ directory for what remains to be done. Some
of those features will be implemented after 2.0 is released. The goal
is to empty the file todo/release and document/test/verify the API
that's going to be supported by 2.0. More API will be supported post
2.0 release.
*** Support ***
For comments, questions, bug-reports, etc., join the mod_perl users
list by sending mail to
When reporting bugs please follow the instructions at:
For announcements join the mod_perl announce list by sending mail to
*** Developers ***
Development discussion takes place on dev (at)
*** Authors ***
mod_perl-2.0 was designed and written by Doug MacEachern, with
contributions from many others (see Changes files).