r37871 - in /trunk/libnamespace-autoclean-perl/debian: changelog control

[carnil-guest at users.alioth.debian.org]

Author: carnil-guest
Date: Mon Jun  8 18:57:47 2009
New Revision: 37871

URL: http://svn.debian.org/wsvn/pkg-perl/?sc=1&rev=37871
Log:
further improve the long description, thanks to jawnsy, bug already marked as pending

Modified:
    trunk/libnamespace-autoclean-perl/debian/changelog
    trunk/libnamespace-autoclean-perl/debian/control

Modified: trunk/libnamespace-autoclean-perl/debian/changelog
URL: http://svn.debian.org/wsvn/pkg-perl/trunk/libnamespace-autoclean-perl/debian/changelog?rev=37871&op=diff
==============================================================================
--- trunk/libnamespace-autoclean-perl/debian/changelog (original)
+++ trunk/libnamespace-autoclean-perl/debian/changelog Mon Jun  8 18:57:47 2009
@@ -10,7 +10,8 @@
 
   [ Salvatore Bonaccorso ]
   * Improve package long description. Thanks to Gerfried Fuchs
-    for suggestion. (Closes: #532299)
+    and Jonathan Yu for suggestion and improvements.
+    (Closes: #532299)
   * Add myself to Uploaders. 
 
  -- Salvatore Bonaccorso <salvatore.bonaccorso at gmail.com>  Mon, 08 Jun 2009 16:46:10 +0200

Modified: trunk/libnamespace-autoclean-perl/debian/control
URL: http://svn.debian.org/wsvn/pkg-perl/trunk/libnamespace-autoclean-perl/debian/control?rev=37871&op=diff
==============================================================================
--- trunk/libnamespace-autoclean-perl/debian/control (original)
+++ trunk/libnamespace-autoclean-perl/debian/control Mon Jun  8 18:57:47 2009
@@ -18,18 +18,18 @@
   libnamespace-clean-perl (>= 0.11), libclass-mop-perl (>= 0.80),
   libb-hooks-endofscope-perl (>= 0.07)
 Description: Perl module to remove all imported symbols at the end of the compile cycle
- When you import a function into a Perl package, it will naturally also be
- available as a method. The namespace::autoclean pragma will remove all 
- imported symbols at the end of the current package's compile cycle. Functions 
- called in the package itself will still be bound by their name, but they 
- won't show up as methods on your class or instances.
+ namespace::autoclean is a handy module to keep your namespace clean by
+ removing all imported symbols at the end of the current package's compile
+ cycle. Perhaps most importantly, this means that imported functions will no
+ longer be made accidentally accessible to users outside of your package via
+ method invocations.
  .
- namespace::autoclean is very similar to namespace::clean, except it
- will clean all imported functions, no matter if you imported them
- before or after you used the pragma. It will also not touch anything
- that looks like a method, according to
- Class::MOP::Class::get_method_list.
+ The way this is done at the end of the compile cycle but prior to execution
+ means that functions will remain accessible for use inside your package,
+ since function calls are resolved at compile time. For the most part, the
+ only change that needs to be made is to load the module.
  .
- Sometimes you don't want to clean imports only, but also helper functions
- you're using in your methods. The -also switch can be used to declare a list
- of functions that should be removed additional to any imports.
+ This module differs slightly from namespace::clean in that it cleans all
+ imported functions, whether or not the imports happened prior to using the
+ pragma. Things that "look" like a method will be left alone (Class::MOP is
+ used for this feature).