From: Kieren Diment <diment@gmail.com>
Date: Fri, 16 May 2008 12:43:09 +0000 (+0000)
Subject: updated manual
X-Git-Tag: v5.8005~313
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=catagits%2FCatalyst-Manual.git;a=commitdiff_plain;h=2d0526d162eaee76807a5f7534820429c0395a03

updated manual
---

diff --git a/Changes b/Changes
index 8c824b3..085da0d 100644
--- a/Changes
+++ b/Changes
@@ -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)
 
diff --git a/lib/Catalyst/Manual.pm b/lib/Catalyst/Manual.pm
index 62a7277..34b2ae8 100644
--- a/lib/Catalyst/Manual.pm
+++ b/lib/Catalyst/Manual.pm
@@ -23,6 +23,6 @@ Tutorial.
 
 =cut
 
-our $VERSION = '5.701003';
+our $VERSION = '5.7011';
 
 1;
diff --git a/lib/Catalyst/Manual/Tutorial/AdvancedCRUD.pod b/lib/Catalyst/Manual/Tutorial/AdvancedCRUD.pod
index 0817978..dc37663 100644
--- a/lib/Catalyst/Manual/Tutorial/AdvancedCRUD.pod
+++ b/lib/Catalyst/Manual/Tutorial/AdvancedCRUD.pod
@@ -69,12 +69,22 @@ real-world applications generally require more control.  Other
 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
diff --git a/lib/Catalyst/Manual/Tutorial/Authentication.pod b/lib/Catalyst/Manual/Tutorial/Authentication.pod
index f554a43..8c24726 100644
--- a/lib/Catalyst/Manual/Tutorial/Authentication.pod
+++ b/lib/Catalyst/Manual/Tutorial/Authentication.pod
@@ -50,6 +50,16 @@ L<Appendices|Catalyst::Manual::Tutorial::Appendices>
 =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