===================================================================
RCS file: /cvs/todotxt/Text-Todo/lib/Text/Todo.pm,v
retrieving revision 1.15
retrieving revision 1.17
diff -u -r1.15 -r1.17
--- todotxt/Text-Todo/lib/Text/Todo.pm	2010/01/11 19:52:06	1.15
+++ todotxt/Text-Todo/lib/Text/Todo.pm	2010/01/12 20:09:02	1.17
@@ -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.16 2010/01/12 19:40:52 andrew Exp $
 
 use warnings;
 use strict;
@@ -203,7 +203,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 +260,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 +284,7 @@
 
         my @tags = sort keys %available;
 
-        return wantarray ? @tags: \@tags;
+        return wantarray ? @tags : \@tags;
     }
 
     sub archive {
@@ -397,7 +397,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.17 2010/01/12 20:09:02 andrew Exp $
 
 =head1 SYNOPSIS
 
@@ -470,6 +470,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 +479,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