[libcatalyst-plugin-unicode-perl] 03/06: add description

[Damyan Ivanov]

This is an automated email from the git hooks/post-receive script.

dmn pushed a commit to branch master
in repository libcatalyst-plugin-unicode-perl.

commit 6d7c3703f77891529043806199e9a19303af9762
Author: Damyan Ivanov <dmn at debian.org>
Date:   Tue May 13 20:28:15 2014 +0000

    add description
---
 debian/control | 24 +++++++++++++++++++++---
 1 file changed, 21 insertions(+), 3 deletions(-)

diff --git a/debian/control b/debian/control
index e320731..87f3a48 100644
--- a/debian/control
+++ b/debian/control
@@ -20,7 +20,25 @@ Architecture: all
 Depends: ${misc:Depends}, ${perl:Depends},
  libcatalyst-perl (>= 5.70),
  libmro-compat-perl (>= 0.10)
-Description: Unicode aware Catalyst (old style)
- (no description was found)
+Description: Unicode support for Catalyst (old style)
+ At request time Catalyst::Plugin::Unicode decodes all params from UTF-8
+ octets into a sequence of logical characters. On response, encodes body into
+ UTF-8 octets.
  .
- This description was automagically extracted from the module by dh-make-perl.
+ Note that this plugin tries to autodetect if your response is encoded into
+ characters before trying to encode it into a byte stream. This is *bad*
+ as sometimes it can guess wrongly and cause problems.
+ .
+ As an example, latin1 characters such as é (e-accute) will not actually
+ cause the output to be encoded as utf8.
+ .
+ Using Catalyst::Plugin::Unicode::Encoding (part of Catalyst 5.90042, packaged
+ in libcatalyst-perl) is much more recommended, and that also does additional
+ things (like decoding file upload filenames and request parameters which this
+ plugin does not).
+ .
+ This plugin should be considered deprecated, but is maintained as a large
+ number of applications are using it already.
+ .
+ Catalyst is an elegant Model-View-Controller web application framework
+ written in Perl.

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-perl/packages/libcatalyst-plugin-unicode-perl.git