Randy Kobes wrote:

 -Obtain the mod_perl sources from CPAN:
 -
 -  http://www.cpan.org/authors/id/D/DO/DOUGM/mod_perl-1.xx.tar.gz
 -
 +Obtain the mod_perl sources (F<mod_perl-1.xx.tar.gz>) from CPAN
 +under L<http://www.cpan.org/authors/id/D/DO/DOUGM/>.
  When unpacked, using Winzip or similar tools, a subdirectory
  F<mod_perl-1.xx> will be created.

I'd rather point to http://perl.apache.org/download/, where the latest version is automatically linked to.


I think I'd prefer F<mod_perl-1.0-current.tar.gz> from
L<http://perl.apache.org/dist/> - the page http://perl.apache.org/download/ contains an
"Installation" link which takes one out of the
section describing how to build mod_perl on Windows.

which brings them to the general install fast page, which points back to
http://perl.apache.org/docs/1.0/guide/getwet.html#Installing_mod_perl_for_Windows
which should go away since it duplicates the 1.0 win32 install (my fault), or may be not go away but replaced by some short notes how to get things running for those who understand, and with a link to a full win32 install page. Can you please look at it?


You can't do F<mod_perl-1.0-current.tar.gz>, because /dist is not under modperl-docs rep, so F<> won't find this file and leave it unlinked. So I guess just pointing to http://perl.apache.org/dist/ should work.

@@ -210,6 +203,20 @@
Apache and mod_perl header files, which can then be accessed
through the Apache::src module.
+If this build fails, you may want to try the sources obtained
+from cvs (you may also want to use the Apache cvs sources). +To do this, first obtain a Win32 cvs client from, for example,
+L<http://www.cvshome.org/>. The cvs sources may be obtained as
+
+ C:\src> cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic login
+ C:\src> cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic co apache-1.3
+ C:\src> cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic co modperl
+
+The build then proceeds as above. Be aware, though,
+that as well as providing bug fixes, there may be new features being
+added and tested in the cvs versions, so at any given time there are
+no guarantees that these packages will build and test successfully.
+
=head1 Binaries

Any reason to duplicate docs? We already have this documented at: http://perl.apache.org/download/source.html#Development_Source_Distribution


OK - I'll change that to link to the cvs-specific anchor ... One
reason I put the cvs stuff there is that, as before,
http://perl.apache.org/download/source.html contains
"Installation" links that takes one outside of the realm of
building mod_perl on Win32.

As above, the Install link's page will lead them back to the win32 page if they don't use the back button.


discussion of Apache-2 and modperl-2.

Can we please have consistently Apache 2.0 and mod_perl 2.0? Notice that Apache 2.1 is not the same as Apache 2.0, so Apache-2 is definitely not a good choice.


OK ... One thing I was worried about was introducing a
"mod_perl 2.0" when that doesn't officially exist yet, and
people then getting confused when browsing CPAN and
finding mod_perl-1.99_xx instead. Or, at
http://perl.apache.org/dist/, thinking mod_perl-2.0-current
is (at present) different from mod_perl-1.99_xx. But I'll
put a note in the relevant place to that effect.

Good. I'm just trying to have us less work and questions in the future, when 2.0 is released.


  Having built and installed Apache 2.0, next obtain the mod_perl 2.0
 -sources from http://www.cpan.org/authors/id/D/DO/DOUGM/.  After
 +sources (F<mod_perl-1.99_xx>)
 +from L<http://www.cpan.org/authors/id/D/DO/DOUGM/>.  After
  unpacking, run the command

Same here, better point to perl.apache.org/download/


and as above, I think I'd prefer F<mod_perl-2.0-current.tar.gz>
from L<http://perl.apache.org/dist/>, with a note about
mod_perl-2.0 being in development.

ok

I'll look at making the above changes ... I can certainly see the
wisdom in not duplicating things, but that I think has to be
partly balanced against the "danger" of taking Win32 users to
pages that have Unix-specific links.

Totally agreed.

__________________________________________________________________
Stas Bekman            JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/     mod_perl Guide ---> http://perl.apache.org
mailto:[EMAIL PROTECTED] http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org   http://ticketmaster.com


--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]



Reply via email to