===================================================================
RCS file: /cvs/todotxt/Text-Todo/lib/Text/Todo.pm,v
retrieving revision 1.15
retrieving revision 1.20
diff -u -r1.15 -r1.20
--- todotxt/Text-Todo/lib/Text/Todo.pm	2010/01/11 19:52:06	1.15
+++ todotxt/Text-Todo/lib/Text/Todo.pm	2010/01/18 03:04:48	1.20
@@ -1,6 +1,6 @@
 package Text::Todo;
 
-# $AFresh1: Todo.pm,v 1.14 2010/01/10 22:39:26 andrew Exp $
+# $AFresh1: Todo.pm,v 1.19 2010/01/18 02:46:48 andrew Exp $
 
 use warnings;
 use strict;
@@ -14,10 +14,13 @@
 
 {
 
-    my %path_of;
-    my %list_of;
-    my %loaded_of;
+    my @attr_refs = \(
+        my %path_of,
 
+        my %list_of,
+        my %loaded_of,
+    );
+
     sub new {
         my ( $class, $options ) = @_;
 
@@ -203,7 +206,7 @@
         if ($pri) {
             $pri = uc $pri;
             if ( $pri !~ /^[A-Z]$/xms ) {
-                croak "PRIORITY must a single letter from A to Z.";
+                croak 'PRIORITY must a single letter from A to Z.';
             }
             @list = grep { defined $_->priority && $_->priority eq $pri }
                 $self->list;
@@ -260,19 +263,19 @@
     }
 
     sub listproj {
-        my ( $self ) = @_;
+        my ($self) = @_;
         return $self->listtag('project');
     }
 
     sub listcon {
-        my ( $self ) = @_;
+        my ($self) = @_;
         return $self->listtag('context');
     }
 
     sub listtag {
         my ( $self, $tag ) = @_;
         my $ident = ident($self);
-        
+
         my $accessor = $tag . 's';
 
         my %available;
@@ -284,7 +287,7 @@
 
         my @tags = sort keys %available;
 
-        return wantarray ? @tags: \@tags;
+        return wantarray ? @tags : \@tags;
     }
 
     sub archive {
@@ -382,6 +385,14 @@
 
         croak "Invalid entry [$entry]!";
     }
+
+    sub DESTROY {
+        my ($self) = @_;
+        my $ident = ident $self;
+        foreach my $attr_ref (@attr_refs) {
+            delete $attr_ref->{$ident};
+        }
+    }
 }
 
 1;    # Magic true value required at end of module
@@ -397,7 +408,7 @@
 Since the $VERSION can't be automatically included, 
 here is the RCS Id instead, you'll have to look up $VERSION.
 
-    $Id: Todo.pm,v 1.15 2010/01/11 19:52:06 andrew Exp $
+    $Id: Todo.pm,v 1.20 2010/01/18 03:04:48 andrew Exp $
 
 =head1 SYNOPSIS
 
@@ -470,6 +481,7 @@
 then, $todo_file eq 'todo/todo.txt'
 
 =head2 load
+- Reads a list from a file into the current object.
 
 Allows you to load a different file into the object.
 
@@ -478,35 +490,53 @@
 This effects the other functions that act on the list.
 
 =head2 save
+- Writes the list to disk.
 
     $todo->save(['new/path/to/todo']);
 
-Writes the list to the file. Either the current working file or something
+Either writes the current working file or the passed in argument
 that can be recognized by file(). 
 
 If you specify a filename it will save to that file and update the paths.  
 Additional changes to the object work on that file.
 
 =head2 list
+- get the curently loaded list
 
     my @todo_list = $todo->list;
 
+In list context returns a list, it scalar context returns an array reference to the list.
+
 =head2 listpri
+- get the list items that are marked priority
 
 Like list, but only returns entries that have priority set.
 
     my @priority_list = $todo->listpri;
 
-=head2 listproj
+Since this is so easy to write as:
 
-Returns projects in the list sorted by name.  
-If there were projects +GarageSale and +Shopping
+    my @priority_list = grep { $_->priority } $todo->list;
 
-    my @projects = $todo->listproj;
+I think it may become depreciated unless there is demand.
 
+=head2 listtag
+
+Returns tags found in the list sorted by name.  
+
+If there were projects +GarageSale and +Shopping then
+
+    my @projects = $todo->listtag('project');
+
 is the same as
 
     @projects = ( 'GarageSale', 'Shopping' );
+
+=head2 listcon
+- Shortcut to listtag('context')
+
+=head2 listproj
+- Shortcut to listtag('project')
 
 =head2 add