Index: lib/HTML/FormFu.pm =================================================================== --- lib/HTML/FormFu.pm (revision 419) +++ lib/HTML/FormFu.pm (working copy) @@ -802,7 +802,7 @@ HTML::FormFu uses a templating system such as L or L to create the form's XHTML output. As such, it needs -to be able to find it's own template files. If you're using the L +to be able to find its own template files. If you're using the L web framework, just run the following command: $ script/myapp_create.pl HTML::FormFu @@ -815,9 +815,9 @@ running the following command (while in the directory containing your CGI programs): -    $ html_formfu_deploy.pl + $ html_formfu_deploy.pl -This installs the templates files in directory C<./root>, which is the +This installs the template files in directory C<./root>, which is the default path that HTML::FormFu searches in. Although HTML::FormFu uses L internally, @@ -860,7 +860,7 @@ The content of each config file is passed to L, and so are added to the form. -L may be called in a config file itself, as so allow +L may be called in a config file itself, so as to allow common settings to be kept in a single config file which may be loaded by any form. @@ -904,10 +904,10 @@ a value for that fieldname was submitted. If L is set to a code-ref, it will be called as a subroutine -with the two arguments C<$form> and C<$query>, and it's return value will be +with the two arguments C<$form> and C<$query>, and its return value will be used as the return value for L. -If L is not set, will return true if a value for +If L is not set, L will return true if a value for any known fieldname was submitted. =head2 auto_fieldset @@ -1003,7 +1003,7 @@ Because of this behaviour, if you want nested fieldsets you will have to add -each nested fieldset directly to it's intended parent. +each nested fieldset directly to its intended parent. my $parent = $form->get_element({ type => 'Fieldset' }); @@ -1038,7 +1038,7 @@ You can, of course, set L to any key in your L10N file. -=head1 force_error_message +=head2 force_error_message If true, forces the L to be displayed even if there are no field errors. @@ -1102,7 +1102,7 @@ - type: +MyApp::CustomElement name: foo -If a C is not provided in the C<\%options>, the default C will +If a C is not provided in the C<\%options>, the default C will be used. L is an alias for L. @@ -1181,7 +1181,7 @@ can be sure that all values have successfully passed all Constraints and have been successfully passed through all Inflators. It is expected that most Validators will be application-specific, and so each will be implemented as -a seperate class written by the HTML::FormFu user. +a separate class written by the HTML::FormFu user. =head2 filters @@ -1204,9 +1204,6 @@ See L for a list of core filters. -If a C attribute isn't provided, a new filter is created for and -added to every field on the form. - If you want to load a filter in a namespace other than C, you can use a fully qualified package-name by prefixing it with C<+>. @@ -1352,7 +1349,7 @@ =head2 attrs_xml -Provides the same functionality as L<"/attributes">, but values won't be +Provides the same functionality as L, but values won't be XML-escaped. L is an alias for L. @@ -1372,8 +1369,9 @@ $form->add_attributes( $key => $value ); $form->add_attributes( { $key => $value } ); -All values are appended to existing values, with a preceeding space -character. This is primarily to allow the easy addition of new class names. +All values are appended to existing values, with a preceding space +character. This is primarily to allow the easy addition of new names to the class +attribute. $form->attributes({ class => 'foo' }); @@ -1387,7 +1385,7 @@ =head2 add_attrs_xml -Provides the same functionality as L<"/add_attributes">, but values won't be +Provides the same functionality as L, but values won't be XML-escaped. L is an alias for L. @@ -1421,12 +1419,12 @@ =head2 del_attrs_xml -Provides the same functionality as L<"/del_attributes">, but values won't be +Provides the same functionality as L, but values won't be XML-escaped. L is an alias for L. -The following methods are shortcuts for accessing L<"/attributes"> keys. +The following methods are shortcuts for accessing L keys. =head2 id @@ -1728,7 +1726,7 @@ A (readonly) L compatible method. -If a field name if given, in list-context returns any valid values submitted +If a field name is given, in list-context returns any valid values submitted for that field, and in scalar-context returns only the first of any valid values submitted for that field. @@ -1903,7 +1901,7 @@ Accepts a hash-ref of arguments passed to the render object constructor for the form and all elements. -The default render class (L) passes these +The default render class (L) passes these arguments to the L constructor. The keys C and C are overridden to always be true, as @@ -1944,6 +1942,7 @@ Return Value: \@elements Returns all top-level elements in the form (not recursive). +See L for a recursive version. Accepts both C and C arguments to narrow the returned results. @@ -1952,8 +1951,6 @@ type => 'Radio', }); -See L for a recursive version. - =head2 get_element Arguments: [%options] @@ -1967,6 +1964,8 @@ =head2 get_all_elements +=head2 get_all_element + =head2 get_fields Arguments: [%options] @@ -2194,7 +2193,7 @@ perl examples/vertically-aligned/vertically-aligned.pl -This uses the C