[Catalyst-commits] r8777 - / trunk/examples/CatalystAdvent/root/2008 trunk/examples/CatalystAdvent/root/2008/pen

Sun Dec 7 09:19:28 GMT 2008

Author: zarquon
Date: 2008-12-07 09:19:27 +0000 (Sun, 07 Dec 2008)
New Revision: 8777

Added:
   trunk/examples/CatalystAdvent/root/2008/7.pod
Removed:
   trunk/examples/CatalystAdvent/root/2008/pen/7.pod
Modified:
   /
Log:
 r14496 at fenchurch:  kd | 2008-12-07 20:14:53 +1100
 add newline at end
 r14497 at fenchurch:  kd | 2008-12-07 20:19:01 +1100
 day 7 light edits and live



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

Copied: trunk/examples/CatalystAdvent/root/2008/7.pod (from rev 8776, trunk/examples/CatalystAdvent/root/2008/pen/7.pod)
===================================================================

--- trunk/examples/CatalystAdvent/root/2008/7.pod	                        (rev 0)
+++ trunk/examples/CatalystAdvent/root/2008/7.pod	2008-12-07 09:19:27 UTC (rev 8777)
@@ -0,0 +1,101 @@
+=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
+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.
+
+=head2 Step one, find a Windows machine.
+
+Sime 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
+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
+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
+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
+in c:\strawberry\.
+
+ set bindir=%~dp0
+ set perlpath="%bindir%\perl\bin"
+ set buildpath="%bindir%\c\bin"
+ set PATH=%PATH%;%perlpath%;%buildpath%
+ start cmd
+
+=head2 Step 4, set up CPAN.
+
+Actaully 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
+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
+L<patch|http://rt.cpan.org/Ticket/Display.html?id=38011#txn-536129>
+waiting to be applied in the RT Queue.
+
+Anyway, while you could C< notest install HTTP::Server::Simple > and
+then go into your application's root directory and then the C< perl
+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:
+
+ perl Makefile.PL
+ perl −MCPAN −MYAML::Syck −e "CPAN::Shell−>notest(install => $_) for grep { $_ ne \"perl\" } keys %{ LoadFile(\"META.yml\")−>{requires} }"
+
+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
+directory that I placed the C< startperl.bat > script (see above).
+
+Now we can run the following script to start the test server (the
+first lines are just the same as before):
+
+ set bindir=%~dp0
+ set perlpath="%bindir%\perl\bin"
+ set buildpath="%bindir%\c\bin"
+ set PATH=%PATH%;%perlpath%;%buildpath%
+
+ echo Starting text fossicking 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.
+
+=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.
+
+=head1 AUTHOR
+
+Kieren Diment <zarquon at cpan.org>

Deleted: trunk/examples/CatalystAdvent/root/2008/pen/7.pod
===================================================================
--- trunk/examples/CatalystAdvent/root/2008/pen/7.pod	2008-12-07 08:44:10 UTC (rev 8776)
+++ trunk/examples/CatalystAdvent/root/2008/pen/7.pod	2008-12-07 09:19:27 UTC (rev 8777)
@@ -1,101 +0,0 @@
-=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
-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.
-
-=head2 Step one, find a Windows machine.
-
-Sime 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
-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
-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
-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
-in c:\strawberry\.
-
- set bindir=%~dp0
- set perlpath="%bindir%\perl\bin"
- set buildpath="%bindir%\c\bin"
- set PATH=%PATH%;%perlpath%;%buildpath%
- start cmd
-
-=head2 Step 4, set up CPAN.
-
-Actaully 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 a
-L<Minicpan|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
-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
-L<patch|http://rt.cpan.org/Ticket/Display.html?id=38011#txn-536129>
-waiting to be applied in the RT Queue.
-
-Anyway, while you could C< notest install HTTP::Server::Simple > and
-then go into your application's root directory and then the C< perl
-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:
-
- perl Makefile.PL
- perl −MCPAN −MYAML::Syck −e "CPAN::Shell−>notest(install => $_) for grep { $_ ne \"perl\" } keys %{ LoadFile(\"META.yml\")−>{requires} }"
-
-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
-directory that I placed the C< startperl.bat > script (see above).
-
-Now we can run the following script to start the test server (the
-first lines are just the same as before):
-
- set bindir=%~dp0
- set perlpath="%bindir%\perl\bin"
- set buildpath="%bindir%\c\bin"
- set PATH=%PATH%;%perlpath%;%buildpath%
-
- echo Starting text fossicking 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.
-
-=head1 ACKNOWLEDGEMENTS
-
-Thanks to Adam Kennedy and the rest of the team behind L<Perl::Dist>
-who have made this possible.  And thanks to Microsoft for realising
-that they have to make an effort not to be second class citizens.
-
-=head1 AUTHOR
-
-Kieren Diment <zarquon at cpan.org>
\ No newline at end of file


