X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FCatalyst%2FManual%2FTutorial%2F09_AdvancedCRUD%2F09_FormHandler.pod;h=af1447b7ed097f3d561c2fc56c7afb31deb22cfc;hb=0a699832e62968b40df32b50c872bbb5976f49cc;hp=cfd23cf33661166a07a3db0e75ed5a0576687ac9;hpb=0abc72edf5636d7f700793f5b700180428102feb;p=catagits%2FCatalyst-Manual.git

diff --git a/lib/Catalyst/Manual/Tutorial/09_AdvancedCRUD/09_FormHandler.pod b/lib/Catalyst/Manual/Tutorial/09_AdvancedCRUD/09_FormHandler.pod
index cfd23cf..af1447b 100644
--- a/lib/Catalyst/Manual/Tutorial/09_AdvancedCRUD/09_FormHandler.pod
+++ b/lib/Catalyst/Manual/Tutorial/09_AdvancedCRUD/09_FormHandler.pod
@@ -56,15 +56,16 @@ L<Appendices|Catalyst::Manual::Tutorial::10_Appendices>
 
 =head1 DESCRIPTION
 
-This portion of the tutorial explores L<HTML::FormHandler|HTML::FormHandler> 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::FormHandler version 0.28001.
+This portion of the tutorial explores
+L<HTML::FormHandler> and how it can be used to manage
+forms, perform validation of form input, and save and restore data
+to or from the database. This was written using HTML::FormHandler version
+0.28001.
 
 See 
-L<Catalyst::Manual::Tutorial::09_AdvancedCRUD|Catalyst::Manual::Tutorial::09_AdvancedCRUD>
+L<Catalyst::Manual::Tutorial::09_AdvancedCRUD>
 for additional form management options other than 
-L<HTML::FormHandler|HTML::FormHandler>.
+L<HTML::FormHandler>.
 
 
 =head1 Install HTML::FormHandler
@@ -75,18 +76,23 @@ from CPAN:
 
     sudo cpan HTML::FormHandler::Model::DBIC 
 
-It will install L<HTML::FormHandler> as a prereq. 
+It will install L<HTML::FormHandler> as a prerequisite. 
 
+Also, add:
+
+    requires 'HTML::FormHandler::Model::DBIC';
+
+to your C<Makefile.PL>.
 
 =head1 HTML::FormHandler FORM CREATION
 
-This section looks at how L<HTML::FormHandler|HTML::FormHandler> can be used to 
+This section looks at how L<HTML::FormHandler> can be used to 
 add additional functionality to the manually created form from Chapter 4.
 
 
 =head2 Using FormHandler in your controllers 
 
-FormHandler doen't have a Catalyst base controller, because interfacing
+FormHandler doesn't have a Catalyst base controller, because interfacing
 to a form is only a couple of lines of code.
 
 =head2 Create a Book Form
@@ -94,6 +100,7 @@ to a form is only a couple of lines of code.
 Create the directory C<lib/MyApp/Form>. Create C<lib/MyApp/Form/Book.pm>:
 
     package MyApp::Form::Book;
+
     use HTML::FormHandler::Moose;
     extends 'HTML::FormHandler::Model::DBIC';
     use namespace::autoclean;
@@ -215,14 +222,15 @@ Add range constraints to the 'rating' field:
    has_field 'rating' => ( type => 'Integer', range_start => 1, range_end => 5 );
 
 The 'authors' relationship is a 'many-to-many' pseudo-relation, so this field
-can be set to Multiple to allow the selection of multiple authors and make it
+can be set to Multiple to allow the selection of multiple authors; also, make it
 required:
 
-   has_field 'authors' => ( type => 'Multiple', required => 1 );
+   has_field 'authors' => ( type => 'Multiple', label_column => 'last_name',
+                            required => 1 );
 
-Note: FormHandler automatically strips whitespace at the beginning or end of fields.
-If you want some other kind of stripping (or none) you can specify it explicitly.
-(see L<HTML::FormHandler::Manual>)
+Note: FormHandler automatically strips whitespace at the beginning and
+end of fields. If you want some other kind of stripping (or none) you
+can specify it explicitly; see L<HTML::FormHandler::Manual>.
 
 =head2 Try Out the Updated Form
 
@@ -280,9 +288,9 @@ green.  Experiment with other edits to various books.
 
 =head2 See additional documentation on FormHandler
 
-   L<HTML::FormHandler::Manual>
+L<HTML::FormHandler::Manual>
 
-   L<HTML::FormHandler>
+L<HTML::FormHandler>
 
    #formhandler on irc.perl.org