[libcatalyst-plugin-authentication-perl] 04/07: update 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-authentication-perl.

commit 3c8a55565cd9f7e7a7d4b7615d6344320c41b29b
Author: Damyan Ivanov <dmn at debian.org>
Date:   Wed May 14 13:57:06 2014 +0000

    update description
---
 debian/control | 22 +++++++++++++++-------
 1 file changed, 15 insertions(+), 7 deletions(-)

diff --git a/debian/control b/debian/control
index f31b6b9..6497c47 100644
--- a/debian/control
+++ b/debian/control
@@ -34,13 +34,21 @@ Depends: ${misc:Depends}, ${perl:Depends},
  libtry-tiny-perl
 Replaces: libcatalyst-modules-perl (<< 47~)
 Breaks: libcatalyst-modules-perl (<< 47~)
-Description: Infrastructure plugin for the Catalyst authentication framework.
- This is the base class for authentication user objects.
+Description: Infrastructure plugin for the Catalyst authentication framework
+ Catalyst::Plugin::Authentication provides generic user support for Catalyst
+ apps. It is the basis for both authentication (checking the user is who they
+ claim to be), and authorization (allowing the user to do what the system
+ authorises them to do).
  .
- THIS IS NOT A COMPLETE CLASS! it is intended to provide base functionality
- only.
+ Using authentication is split into two parts. A Store is used to actually
+ store the user information, and can store any amount of data related to the
+ user. Credentials are used to verify users, using information from the store,
+ given data from the frontend. A Credential and a Store are paired to form a
+ 'Realm'. A Catalyst application using the authentication framework must have
+ at least one realm, and may have several.
  .
- It provides the base methods listed below, and any additional methods are
- proxied onto the user object fetched from the underlieing store.
+ To implement authentication in a Catalyst application you need to add this
+ module, and specify at least one realm in the configuration.
  .
- This description was automagically extracted from the module by dh-make-perl.
+ 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-authentication-perl.git