X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=catagits%2FCatalyst-Manual.git;a=blobdiff_plain;f=lib%2FCatalyst%2FManual%2FComponents.pod;h=cc45a801bde4b978b550f75ba5bc849e78ce916b;hp=88cbb047124c27d8fa9949a764973f29d124af1f;hb=aa82583deefab5c36afe9e554dfa7099592a18ec;hpb=a481d68f4a972a5463f7045be5797bb2f2f4a627

diff --git a/lib/Catalyst/Manual/Components.pod b/lib/Catalyst/Manual/Components.pod
index 88cbb04..cc45a80 100644
--- a/lib/Catalyst/Manual/Components.pod
+++ b/lib/Catalyst/Manual/Components.pod
@@ -18,15 +18,20 @@ status or preferred use of your chosen plugin/framework.
 
 =head1 PLUGINS
 
+Take care with plugins!  In general with a plugin ask "should this be
+acting globally on my application application?".  If not it should be a
+Controller Role (e.g. see L<Catalyst::TraitFor::Controller::reCAPTCHA>.
+
 =head2 L<Catalyst::Plugin::Account::AutoDiscovery>
 
 Provides Account Auto-Discovery for Catalyst.
 
 =head2 L<Catalyst::Plugin::Acme::Scramble>
 
-Implements a potent meme about how easily we can read scrambled text if
-the first and last letters remain constant. Operates on text/plain and
-text/html served by your Catalyst application.
+Implements a demonstration showing how easily fluent speakers can read
+scrambled text if the first and last letters remain constant but the middle
+. Operates on text/plain and text/html served by your Catalyst application.
+This should really be a controller role, or even a View these days.
 
 =head2 L<Catalyst::Plugin::Alarm>
 
@@ -156,7 +161,7 @@ Authenticates users using an LDAP server.
 =head4 L<Catalyst::Authentication::Store::Minimal>
 
 Lets you create a very quick and dirty user database in your application's
-config hash. Great for getting up and running quickly.
+config hash. Great for testing or getting up and running quickly.
 
 =head4 L<Catalyst::Authentication::Store::Null>
 
@@ -200,6 +205,9 @@ authorization for Catalyst based on L<Catalyst::Plugin::Authentication>.
 
 =head2 L<Catalyst::Plugin::AutoSession>
 
+L<Catalyst::Plugin::AutoSession> enables specified request parameters
+to generate session variables.
+
 =head2 L<Catalyst::Plugin::Browser>
 
 Extends L<Catalyst::Request> by adding the capability of browser
@@ -229,6 +237,8 @@ the C<< Cache:: >> APO, such as:
 
 =head2 L<Catalyst::Plugin::Charsets::Japanese>
 
+Provides specific charset handlers for the Japanese charsets.
+
 =head2 L<Catalyst::Plugin::Compress::Bzip2>
 
 =head2 L<Catalyst::Plugin::Compress::Deflate>
@@ -258,16 +268,10 @@ L<Catalyst::Plugin::ConfigLoader::YAML>
 
 =head2 L<Catalyst::Plugin::Dumper>
 
-=head2 L<Catalyst::Plugin::Email>
-
-Sends email with L<Email::Send> and L<Email::MIME::Creator>.
-
 =head2 L<Catalyst::Plugin::Email::Japanese>
 
 =head2 L<Catalyst::Plugin::Email::Page>
 
-=head2 L<Catalyst::Plugin::EmailValid>
-
 =head2 L<Catalyst::Plugin::FillInForm>
 
 A plugin based on C<HTML::FillInForm>, which describes itself as a module
@@ -333,6 +337,8 @@ easily implement AJAX functionality without actually knowing Javascript.
 
 =head2 L<Catalyst::Plugin::Redirect>
 
+Allows for easy redirecting with the Catalyst app.
+
 =head2 L<Catalyst::Plugin::RequestToken>
 
 =head2 L<Catalyst::Plugin::RequireSSL>
@@ -425,6 +431,8 @@ you've already painted yourself into a corner - try to avoid!
 
 =head2 L<Catalyst::Plugin::Upload::MD5>
 
+Computes the MD5 message digest of uploaded files.
+
 =head2 L<Catalyst::Plugin::Upload::MIME>
 
 =head2 L<Catalyst::Plugin::UploadProgress>