[Catalyst-commits] r7754 - / trunk/Catalyst-Manual trunk/Catalyst-Manual/lib/Catalyst trunk/Catalyst-Manual/lib/Catalyst/Manual/Tutorial

[zarquon at dev.catalyst.perl.org]

Author: zarquon
Date: 2008-05-16 13:43:09 +0100 (Fri, 16 May 2008)
New Revision: 7754

Modified:
   /
   trunk/Catalyst-Manual/Changes
   trunk/Catalyst-Manual/lib/Catalyst/Manual.pm
   trunk/Catalyst-Manual/lib/Catalyst/Manual/Tutorial/AdvancedCRUD.pod
   trunk/Catalyst-Manual/lib/Catalyst/Manual/Tutorial/Authentication.pod
Log:
 r13127 at zaphod:  kd | 2008-05-16 22:42:38 +1000
 updated manual



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

Modified: trunk/Catalyst-Manual/Changes
===================================================================
--- trunk/Catalyst-Manual/Changes	2008-05-16 12:20:07 UTC (rev 7753)
+++ trunk/Catalyst-Manual/Changes	2008-05-16 12:43:09 UTC (rev 7754)
@@ -1,5 +1,9 @@
 Revision history for Catalyst-Manual
 
+ 5.7011
+       - added warnings and poiinters to newer examples in HTML::Widget,
+         and Authentication parts of the tutorial.
+
 5.701005
     - pod fix (RT #32636)
 

Modified: trunk/Catalyst-Manual/lib/Catalyst/Manual/Tutorial/AdvancedCRUD.pod
===================================================================
--- trunk/Catalyst-Manual/lib/Catalyst/Manual/Tutorial/AdvancedCRUD.pod	2008-05-16 12:20:07 UTC (rev 7753)
+++ trunk/Catalyst-Manual/lib/Catalyst/Manual/Tutorial/AdvancedCRUD.pod	2008-05-16 12:43:09 UTC (rev 7754)
@@ -69,12 +69,22 @@
 options include L<Data::FormValidator|Data::FormValidator> and
 L<HTML::FillInForm|HTML::FillInForm>.
 
-Here, we will make use of the L<HTML::Widget|HTML::Widget> to not only 
-ease form creation, but to also provide validation of the submitted 
-data.  The approached used by this part of the tutorial is to slowly 
-incorporate additional L<HTML::Widget|HTML::Widget> functionality in a 
-step-wise fashion (we start with fairly simple form creation and then 
-move on to more complex and "magical" features such as validation and 
+Note that HTML::Widget is no longer maintained.
+L<HTML::FormFu|HTML::FormFu> was developed as a replacement.  There is
+an example HTML::FormFu application at
+L<http://dev.catalyst.perl.org/repos/Catalyst/examples/Advent07FormFu/final/Fu/Fu-0.01.tar.gz>.
+Another popular alternative for HTML FormFu is
+L<Catalyst::Controller::Formbuilder|Catalyst::Controller::Formbuilder>
+which is used in the L<Catalyst
+Book|http://www.packtpub.com/catalyst-perl-web-application/book>.
+
+Here, we will make use of the
+L<HTML::Widget|HTML::Widget> to not only ease form creation, but to
+also provide validation of the submitted data.  The approached used by
+this part of the tutorial is to slowly incorporate additional
+L<HTML::Widget|HTML::Widget> functionality in a step-wise fashion (we
+start with fairly simple form creation and then move on to more
+complex and "magical" features such as validation and
 auto-population/auto-saving).
 
 B<Note:> Part 8 of the tutorial is optional.  Users who do not wish to

Modified: trunk/Catalyst-Manual/lib/Catalyst/Manual/Tutorial/Authentication.pod
===================================================================
--- trunk/Catalyst-Manual/lib/Catalyst/Manual/Tutorial/Authentication.pod	2008-05-16 12:20:07 UTC (rev 7753)
+++ trunk/Catalyst-Manual/lib/Catalyst/Manual/Tutorial/Authentication.pod	2008-05-16 12:43:09 UTC (rev 7754)
@@ -50,6 +50,16 @@
 =back
 
 
+=head1 IMPORTANT NOTE
+
+Since this tutorial was written, there has been a new Authentication
+API released (Catalyst::Plugin::Authentication version 0.1 and later).
+Some of this tutorial does not work with this API, and requires
+minimal changes.  For an example application that uses the new API see
+L<http://dev.catalyst.perl.org/repos/Catalyst/trunk/examples/NewAuthApp/NewAuthApp-0.01.tar.gz>. It
+is recommended that you read this tutorial first, and then download
+the source code linked above to understand the differences.
+
 =head1 DESCRIPTION
 
 Now that we finally have a simple yet functional application, we can

Modified: trunk/Catalyst-Manual/lib/Catalyst/Manual.pm
===================================================================
--- trunk/Catalyst-Manual/lib/Catalyst/Manual.pm	2008-05-16 12:20:07 UTC (rev 7753)
+++ trunk/Catalyst-Manual/lib/Catalyst/Manual.pm	2008-05-16 12:43:09 UTC (rev 7754)
@@ -23,6 +23,6 @@
 
 =cut
 
-our $VERSION = '5.701003';
+our $VERSION = '5.7011';
 
 1;