Convert to use of "-r" dev server option

[catagits/Catalyst-Manual.git] / lib / Catalyst / Manual / Tutorial / 09_AdvancedCRUD / 09_FormFu.pod

diff --git a/lib/Catalyst/Manual/Tutorial/09_AdvancedCRUD/09_FormFu.pod b/lib/Catalyst/Manual/Tutorial/09_AdvancedCRUD/09_FormFu.pod
index bf4349d..732165a 100644 (file)
--- a/lib/Catalyst/Manual/Tutorial/09_AdvancedCRUD/09_FormFu.pod
+++ b/lib/Catalyst/Manual/Tutorial/09_AdvancedCRUD/09_FormFu.pod
@@ -59,7 +59,7 @@ L<Appendices|Catalyst::Manual::Tutorial::10_Appendices>
 This portion of the tutorial explores L<HTML::FormFu|HTML::FormFu> and 
 how it can be used to manage forms, perform validation of form input, 
 as well as save and restore data to/from the database.  This was written
-using HTML::FormFu version 0.03007.
+using HTML::FormFu version 0.05001.
 
 See 
 L<Catalyst::Manual::Tutorial::09_AdvancedCRUD|Catalyst::Manual::Tutorial::09_AdvancedCRUD>
@@ -67,30 +67,6 @@ for additional form management options other than
 L<HTML::FormFu|HTML::FormFu>.
 
 
-=head1 Install HTML::FormFu
-
-If you are following along in Debian 5, it turns out that some of the 
-modules we need are not yet available as Debian packages at the time 
-this was written.  To install it with a combination of Debian packages 
-and traditional CPAN modules, first use C<aptitude> to install most of 
-the modules:
-
-we need to install the
-L<HTML::FormFu|HTML::FormFu> package: 
-
-    sudo aptitude -y install libhtml-formfu-perl libmoose-perl \
-        libregexp-assemble-perl libhtml-formfu-model-dbic-perl
-        
-    ...
-    
-    sudo aptitude clean
-
-Then use the following command to install directly from CPAN the modules 
-that aren't available as Debian packages:
-
-    sudo cpan Catalyst::Component::InstancePerContext Catalyst::Controller::HTML::FormFu
-
-
 =head1 HTML::FormFu FORM CREATION
 
 This section looks at how L<HTML::FormFu|HTML::FormFu> can be used to 
@@ -101,14 +77,19 @@ add additional functionality to the manually created form from Chapter 4.
 
 First, change your C<lib/MyApp/Controller/Books.pm> to inherit from
 L<Catalyst::Controller::HTML::FormFu|Catalyst::Controller::HTML::FormFu>
-by changing the C<use parent> line from the default of:
+by changing the C<extends> line from the default of:
 
-    use parent 'Catalyst::Controller';
+    BEGIN {extends 'Catalyst::Controller'; }
 
 to use the FormFu base controller class:
 
-    use parent 'Catalyst::Controller::HTML::FormFu';
+    BEGIN {extends 'Catalyst::Controller::HTML::FormFu'; }
 
+Don't forget to add:
+
+    requires 'Catalyst::Controller::HTML::FormFu';
+
+to your C<Makefile.PL>.
 
 =head2 Add Action to Display and Save the Form
 
@@ -243,7 +224,8 @@ Open C<root/src/books/formfu_create.tt2> in your editor and enter the following:
     [%# Render the HTML::FormFu Form %]
     [% form %]
     
-    <p><a href="[% c.uri_for(c.controller.action_for('list')) %]">Return to book list</a></p>
+    <p><a href="[% c.uri_for(c.controller.action_for('list')) 
+        %]">Return to book list</a></p>
 
 
 =head2 Add Links for Create and Update via C<HTML::FormFu>
@@ -263,19 +245,18 @@ use to easily launch our HTML::FormFu-based form.
 
 =head2 Test The HTML::FormFu Create Form
 
-Press C<Ctrl-C> to kill the previous server instance (if it's still
-running) and restart it:
+Make sure the server is running with the "-r" restart option:
 
-    $ script/myapp_server.pl
+    $ script/myapp_server.pl -r
 
 Login as C<test01> (password: mypass).  Once at the Book List page,
 click the new HTML::FormFu "Create" link at the bottom to display the
 form.  Fill in the following values:
 
-    Title  = "Internetworking with TCP/IP Vol. II"
-    Rating = "4"
-    Author = "Comer"
-    
+    Title:  Internetworking with TCP/IP Vol. II
+    Rating: 4
+    Author: Comer
+
 Click the Submit button, and you will be returned to the Book List page
 with a "Book created" status message displayed.
 
@@ -426,11 +407,6 @@ for more filter options.
 
 =head2 Try Out the Updated Form
 
-Press C<Ctrl-C> to kill the previous server instance (if it's still 
-running) and restart it:
-
-    $ script/myapp_server.pl
-
 Make sure you are still logged in as C<test01> and try adding a book 
 with various errors: title less than 5 characters, non-numeric rating, a 
 rating of 0 or 6, etc.  Also try selecting one, two, and zero authors. 
@@ -526,7 +502,7 @@ We use C<$id> to look up the existing book from the database.
 
 We make sure the book lookup returned a valid book.  If not, we set 
 the error message and return to the book list.
- 
+
 =item *
 
 If the form has been submitted and passes validation, we skip creating a 
@@ -563,11 +539,6 @@ existing C<delete> link.
 
 =head2 Try Out the Edit/Update Feature
 
-Press C<Ctrl-C> to kill the previous server instance (if it's still 
-running) and restart it:
-
-    $ script/myapp_server.pl
-
 Make sure you are still logged in as C<test01> and go to the 
 L<http://localhost:3000/books/list> URL in your browser.  Click the 
 "Edit" link next to "Internetworking with TCP/IP Vol. II", change the 
@@ -669,7 +640,7 @@ Kennedy Clark, C<hkclark@gmail.com>
 
 Please report any errors, issues or suggestions to the author.  The
 most recent version of the Catalyst Tutorial can be found at
-L<http://dev.catalyst.perl.org/repos/Catalyst/Catalyst-Manual/5.70/trunk/lib/Catalyst/Manual/Tutorial/>.
+L<http://dev.catalyst.perl.org/repos/Catalyst/Catalyst-Manual/5.80/trunk/lib/Catalyst/Manual/Tutorial/>.
 
 Copyright 2006-2008, Kennedy Clark, under Creative Commons License
 (L<http://creativecommons.org/licenses/by-sa/3.0/us/>).