Add some descriptions to the components. I'm guessing all of them will have to be...
[catagits/Catalyst-Manual.git] / lib / Catalyst / Manual / Components.pod
index c8133f1..c64a261 100644 (file)
@@ -1,6 +1,6 @@
 =head1 NAME
 
-Catalyst::Manual::Component - Reuseable components for Catalyst applications
+Catalyst::Manual::Components - Reuseable components for Catalyst applications
 
 =head1 DESCRIPTION
 
@@ -200,6 +200,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 +232,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>
@@ -333,6 +338,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>
@@ -409,18 +416,24 @@ for portal software and such.
 An interface to the L<HTML::SuperForm> module, enabling easy HTML form
 creation.
 
-=head2 L<Catalyst::Plugin::Unicode>
+=head2 L<Catalyst::Plugin::Unicode::Encoding>
 
 Provides a Unicode-aware Catalyst. On request, it decodes all params from
 UTF-8 octets into a sequence of logical characters. On response, it encodes
 the body into UTF-8 octets.
 
-=head2 L<Catalyst::Plugin::Unicode::Encoding>
+=head2 L<Catalyst::Plugin::Unicode>
+
+Disrecommended plugin which tries to autodetect the uft8ness of the output
+and do the correct thing. This may work in some cases, but if it helps,
+you've already painted yourself into a corner - try to avoid!
 
 =head2 L<Catalyst::Plugin::Upload::Basename>
 
 =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>