[Catalyst-commits] r8778 - / trunk/examples/CatalystAdvent/root/2008

Sun Dec 7 10:48:58 GMT 2008

Author: zarquon
Date: 2008-12-07 10:48:58 +0000 (Sun, 07 Dec 2008)
New Revision: 8778

Modified:
   /
   trunk/examples/CatalystAdvent/root/2008/7.pod
Log:
 r14499 at fenchurch:  kd | 2008-12-07 21:48:34 +1100
 light copy editing



Property changes on: 
___________________________________________________________________
Name: svk:merge
   - 1b129c88-ebf4-0310-add9-f09427935aba:/local/catalyst:4278
1c72fc7c-9ce4-42af-bf25-3bfe470ff1e8:/local/Catalyst:14497
3b9770f9-e80c-0410-a7de-cd203d167417:/local/catalyst:3514
dd8ad9ea-0304-0410-a433-df5f223e7bc0:/local/Catalyst:6909
   + 1b129c88-ebf4-0310-add9-f09427935aba:/local/catalyst:4278
1c72fc7c-9ce4-42af-bf25-3bfe470ff1e8:/local/Catalyst:14499
3b9770f9-e80c-0410-a7de-cd203d167417:/local/catalyst:3514
dd8ad9ea-0304-0410-a433-df5f223e7bc0:/local/Catalyst:6909

Modified: trunk/examples/CatalystAdvent/root/2008/7.pod
===================================================================

--- trunk/examples/CatalystAdvent/root/2008/7.pod	2008-12-07 09:19:27 UTC (rev 8777)
+++ trunk/examples/CatalystAdvent/root/2008/7.pod	2008-12-07 10:48:58 UTC (rev 8778)
@@ -1,35 +1,36 @@
 =head1 Day 7.  Cat In A Box on a Stick
 
 Today's recipe is a quick one to describe how to get yourself a
-portable Perl for windows that runs all the catalyst goodies that you
+portable Perl for Windows that runs all the Catalyst goodies that you
 want for your application.
 
 While there is a L<Perl::Dist::CatInABox> I can't recommend it just
-now, as some of the modules that Catalyst don't install cleanly under
-Windows.  On the other hand these failures are generally not going to
-stop a typical Catalyst installation from working, although watch out
-for Windows' eccentricities like signal handling in your app.
+yet, as some of the modules that Catalyst requires don't install
+cleanly under Windows.  On the other hand these failures are generally
+not going to stop a typical Catalyst installation from working,
+although watch out for Windows' eccentricities like signal handling in
+your app.
 
 =head2 Step one, find a Windows machine.
 
-Sime time really soon, this is going to be L<a lot easier than it is
+Some time really soon, this is going to be L<a lot easier than it is
 now|http://use.perl.org/~Alias/journal/38036>.  For the mean time,
-I've been doing all this work on a mac with a copy of Windows XP
+I've been doing all this work on a Mac with a copy of Windows XP
 working under Virtual Box.  You may not need Administrator access for
 these steps to work, but you do need to do the initial installation of
 CPAN modules in a path without spaces in it.
 
 =head2 Step two.  Grab portable Strawberry Perl
 
-L<Here|http://strawberryperl.com/> is the Strawberry perl website.  Go
-there and grab the latest B<portable> strawberry perl.  Unzip it into
+L<Here|http://strawberryperl.com/> is the Strawberry Perl website.  Go
+there and grab the latest B<portable> strawberry Perl.  Unzip it into
 c:\strawberry, or any other path without spaces.
 
 =head2 Step three, Introduce yourself to the joy of MSDOS batch file programming
 
-This little script should appear in the portable perl distribution in
+This little script should appear in the portable Perl distribution in
 due course, but for now, this will run a Windows shell with all the
-environment variables set for perl to work.  Save it as startperl.bat
+environment variables set for Perl to work.  Save it as startperl.bat
 in c:\strawberry\.
 
  set bindir=%~dp0
@@ -40,19 +41,19 @@
 
 =head2 Step 4, set up CPAN.
 
-Actaully there's not much to this.  Portable Strawberry Perl already
+Actually there's not much to this.  Portable Strawberry Perl already
 has a sensible CPAN mirror set up, but given that Catalyst requires
 quite a lot of dependencies, you might want to set up  L<CPAN::Mini>.
 
 =head2 Step 5, Introduce yourself to the joy of windows command line editing.
 
-Some of the tests for Catalyst's dependencies don't work under windows
+Some of the tests for Catalyst's dependencies don't work under Windows
 at the moment.  From memory, the worst offender is
 L<HTTP::Server::Simple> which hangs, due to Windows doing signal
 handling different to everybody else.  Until this module's signal
 handling is redone to use L<POE>'s signal handling under windows, the
-only sane thing to do is to skip the offending test on Windows for
-this.  There's a
+only sane thing for this module to do is to skip the offending test on
+Windows.  There's a
 L<patch|http://rt.cpan.org/Ticket/Display.html?id=38011#txn-536129>
 waiting to be applied in the RT Queue.
 
@@ -61,15 +62,10 @@
 Makefile.PL \n make installdeps process > (remember windows shell
 doesn't have C< && >), I've found this a little unpredictable
 (probably because of my unfamiliarity with Windows), so here's a
-two-liner that skips testing for everything:
+one-liner that skips testing for everything:
 
- perl Makefile.PL
- perl −MCPAN −MYAML::Syck −e "CPAN::Shell−>notest(install => $_) for grep { $_ ne \"perl\" } keys %{ LoadFile(\"META.yml\")−>{requires} }"
+ perl -MCPAN -e "CPAN::Shell->notest(install => q{.})"
 
-Note the use of double quote characters and escapes in the above ,
-because unlike in unix-land the windows shell doesn't understand
-single quote characters.
-
 =head2 Step 6, run your server
 
 My preference is to put my application's directory in the same
@@ -83,18 +79,20 @@
  set buildpath="%bindir%\c\bin"
  set PATH=%PATH%;%perlpath%;%buildpath%
 
- echo Starting text fossicking server please be patient
+ echo Starting myapp  server please be patient
  perl "%bindir%\MyApp\myapp_server.pl
 
-And you're good to go.  Welcome to Catalyst developement on Windows
-without (too much) pain.
+And you're good to go.  Copy C:\strawberry to wherever you like.  If
+you want to install extra CPAN modules, remember to move it back into
+a path without spaces before proceeding.  Welcome to Catalyst
+development on Windows without (too much) pain.
 
 =head1 ACKNOWLEDGEMENTS
 
-Thanks to Adam Kennedy and the rest of the contributors L<Perl::Dist>,
-and the vertical metre of beer contest who made this possible.  And
-thanks to Microsoft for realising that they have to make an effort not
-to be second class citizens.
+Thanks to Adam Kennedy and the rest of the contributors to
+L<Perl::Dist>, and to the participants in the vertical metre of beer
+contest.  And thanks to Microsoft for realising that they have to make
+an effort not to be second class citizens.
 
 =head1 AUTHOR
 


