update build-howto

git-svn-id: https://svn.apache.org/repos/asf/perl/modperl/trunk@67962 13f79535-47bb-0310-9956-ffa450edef68

Author: dougm

00README_FIRST

@@ -1,10 +1,43 @@
 a (nearly) complete rewrite is underway for mod_perl-2.0
 
-the module is not usable yet
+the module is not usable yet, at least not the way 1.xx is
 
 what you see here is just a start on the new build/glue infrastructure
 
 more detailed design docs, etc. will follow along with updates here
 and on the list
 
--dougm 04/12
+if you want to try building with an interpreter pool, you'll need Perl
+5.6.0 with patches/perl_no_get_context.pat applied and Perl built like 
+so:
+
+% ./Configure -des -Dusethreads -Accflags=-DPERL_NO_GET_CONTEXT
+
+mod_perl-2.0 will still work with an out-of-the-box Perl, but will
+only be useful if your mpm is prefork (which is much like 1.3.x)
+
+in either case, in this directory run:
+
+% perl Makefile.PL -c -ma
+
+% cd ../apache-2.0/src
+% ./configure --prefix=$HOME/apache-2.0 --with-mpm=mpmt_pthread
+% patch -p1 < ../modperl-2.0/patches/link-hack.pat
+% make
+
+as for httpd.conf, mine looks something like so at the moment:
+
+#same as using the MOD_PERL_TRACE environment variable
+
+PerlTrace all
+
+#only with -Dusethreads
+PerlInterpStart 3
+PerlInterpMax 4
+
+#PerlRequire/PerlModule/etc will return, in the meantime, this
+#directive passes arbitrary command line switches to perl
+
+PerlSwitches -T /home/dougm/test/startup.pl
+
+--dougm 04/17

patches/link-hack.pat

@@ -17,3 +17,30 @@ diff -u -u -r1.3 program.mk
  $(PROGRAM_NAME): $(PROGRAM_DEPENDENCIES) $(PROGRAM_OBJECTS)
 -	$(LINK) $(PROGRAM_LDFLAGS) $(PROGRAM_OBJECTS) $(PROGRAM_LDADD)
 +	$(LINK) $(PROGRAM_LDFLAGS) $(PROGRAM_OBJECTS) $(PROGRAM_LDADD) $(MP_LDADD)
+
+--- src/modules.c~	Wed Apr 12 20:00:23 2000
++++ src/modules.c	Wed Apr 12 20:10:16 2000
+@@ -26,6 +26,7 @@
+ extern module auth_module;
+ extern module setenvif_module;
+ extern module echo_module;
++extern module perl_module;
+ 
+ /*
+  *  Modules which implicitly form the
+@@ -54,6 +55,7 @@
+   &auth_module,
+   &setenvif_module,
+   &echo_module,
++  &perl_module,
+   NULL
+ };
+ 
+@@ -84,6 +86,7 @@
+   &auth_module,
+   &setenvif_module,
+   &echo_module,
++  &perl_module,
+   NULL
+ };
+