Bug#532299: libnamespace-autoclean-perl: long description suggestions

Salvatore Bonaccorso salvatore.bonaccorso at gmail.com
Mon Jun 8 12:21:40 UTC 2009


Hi Gerfried

On Mon, Jun 08, 2009 at 01:22:56PM +0200, Gerfried Fuchs wrote:
>  The long description of the package reads a bit strange, especially in
> the way that it ends with a colon, leaving the impression that there is
> something missing. Maybe it should just get removed alltogether.

(Note: I'm not a native english speaker)

would you agree with this change from the description point of view?
The sentence was copied from manpage, and following that there is an
explicit example code how to use, but this all is in the manpage.

Index: debian/control
===================================================================
--- debian/control      (revision 37859)
+++ debian/control      (working copy)
@@ -19,13 +19,11 @@
   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.
+ 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.
  .
- 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 very similar to namespace::clean, except it
  will clean all imported functions, no matter if you imported them
  before or after you used the pagma. It will also not touch anything
@@ -34,5 +32,4 @@
  .
  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:
-
+ of functions that should be removed additional to any imports.


Kind regards
Salvatore
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 835 bytes
Desc: Digital signature
URL: <http://lists.alioth.debian.org/pipermail/pkg-perl-maintainers/attachments/20090608/7a49eff8/attachment.pgp>


More information about the pkg-perl-maintainers mailing list