#######################
# Build/Startup Issue #
#######################


OS      Ver Mod Comments
----------------------------------------------------------------------
OpenBSD 2.9 DSO Builds but won't start, with segfaults in the
                Perl lexer. I wasn't even able to start mp1-dso with
                the customly built perl (tried 5.6.1 .. 5.9.0)
                -- the segfault is again in lexer. It seems that
                the standard OpenBSD perl package has been heavily
                patched, when the core system perl 5.6.0 package was
                built, since I can run 'make test' on mp1-dso, but not
                with a customly built 5.6.0 with the same
                options. Since 2.9 is no longer supported by OpenBSD,
                there is no 5.6.1 or higher to try, so at this moment
                we simply give up on 2.9. We think that the static mp2
                build should work just fine (once it's available).

AIX     3.3 DSO Works with -berok to ignore linking errors (symbol
                resolution).  Should replace -berok with a proper
                symbol resolution at linking time, but I had not much
                success with using this approach (dlopen fails).

AIX   4.3.3 DSO reported to work with mod_perl_1.99_12 and 
                Apache 2.0.48/prefork mpm 
                but doesn't start with worker:
                http://marc.theaimsgroup.com/?t=106894906200003&r=1&w=2

FreeBSD ??  DSO Works with non-threaded perl (4.8-RELEASE and
                5.1-RELEASE)
                http://marc.theaimsgroup.com/?l=apache-modperl&m=106399870822612&w=2
                It doesn't work with threaded perl/worker mpm,
                seemingly because of the problems with threads on
                FreeBSD (not sure what version).

HPUX11i     DSO
                PA-RISC2.0-thread-multi-LP64
                hp-ux loire b.11.11 u 9000800 1756907651 unlimited-user license 
                Cannot load .../modules/mod_perl.so into server: Error 0
                http://marc.theaimsgroup.com/?t=108325310800002&r=1&w=2
                Bill Rowe gives some hints here
                http://marc.theaimsgroup.com/?l=apache-modperl&m=108334017416318&w=2
                Static works OK!

* Need to cleanup functions only needed for certain build flavors
  (perlio/threads/etc) out of lib/ModPerl/WrapXS.pm:$ithread_exports
  and use the newer, simpler #ifdef technique (see modperl_io_apache_init
  for an example)

* we should stop generating xs/apache_*, at least for a reason that
  it's incomplete and will be never complete as we don't keep up with
  changes with ap_/apr_ namespace. Also we don't have the logic to
  handle cases where functions aren't available on certain
  platforms. Importing these unavailable functions may cause loading
  problems on some platforms (aix?). If developers need to import
  symbols from ap_/apr_ namespace they should use .exp files installed
  by httpd/apr/aprutil.

* we have a dependency check problem when xs/*/*.h use code from
  xs/modperl_xs*.h, when the latter change 'make' won't rebuild the
  dependant files

* gcc 3.3 (from cvs 2003-07-28) supports a new option:
  -Wdeclaration-after-statement, which we need to enable in the
  maintainer mode, to catch any declarations after statements, since
  by default gcc doesn't complain about them. Probably need to wait
  till gcc-3.3.2 and enable it then.
  http://gcc.gnu.org/cgi-bin/cvsweb.cgi/gcc/gcc/ChangeLog.diff?r1=2.639&r2=2.640&f=h


* Testing:
  Need to put Philippe's smoking test into the core
  -- shouldn't forget to test with perlio enabled and disabled

* mp2bug -- add the output of 'ldd httpd' to the report

* source_scan won't create Wrap/Foo/Bar.xs if
  xs/maps/modperl_functions.map defines only a boot section:
  MODULE=APR::IO PACKAGE=APR::IO BOOT=1 
  unless there is at least one function added to the .map file
  http://marc.theaimsgroup.com/?l=apache-modperl-dev&m=100702825506778&w=2