Added some more POD for the ::Git::Object classes.
Zachary Stevens [Sun, 6 Dec 2009 22:57:42 +0000 (22:57 +0000)]
lib/Gitalist/Git/Object.pm
lib/Gitalist/Git/Object/Blob.pm
lib/Gitalist/Git/Object/Commit.pm
lib/Gitalist/Git/Object/HasTree.pm
lib/Gitalist/Git/Object/Tag.pm
lib/Gitalist/Git/Object/Tree.pm

index 544b473..c1a5194 100644 (file)
@@ -75,6 +75,25 @@ class Gitalist::Git::Object {
 
 } # end class
 
+__END__
+
+=head1 NAME
+
+Gitalist::Git::Object - Model of a git object.
+
+=head1 SYNOPSIS
+
+    my $object = Project->get_object($sha1);
+
+=head1 DESCRIPTION
+
+Abstract base class for git objects.
+
+
+=head1 ATTRIBUTES
+
+
+=head1 METHODS
 
 
 =head1 AUTHORS
index 59061b2..7561d2c 100644 (file)
@@ -13,9 +13,20 @@ __END__
 
 Gitalist::Git::Object::Blob
 
+=head1 SYNOPSIS
+
+    my $blob = Project->get_object($blob_sha1);
+
 =head1 DESCRIPTION
 
-Gitalist::Git::Object::Blob.
+Represents a blob object in a git repository.
+Subclass of C<Gitalist::Git::Object>.
+
+
+=head1 ATTRIBUTES
+
+
+=head1 METHODS
 
 =head1 AUTHORS
 
index 817c99f..a6261fa 100644 (file)
@@ -194,9 +194,44 @@ __END__
 
 Gitalist::Git::Object::Commit
 
+=head1 SYNOPSIS
+
+    my $commit = Project->get_object($commit_sha1);
+
 =head1 DESCRIPTION
 
-Gitalist::Git::Object::Commit.
+Represents a commit object in a git repository.
+Subclass of C<Gitalist::Git::Object>.
+
+
+=head1 ATTRIBUTES
+
+=head2 committer
+
+=head2 committed_time
+
+=head2 author
+
+=head2 authored_time
+
+=head2 comment
+
+=head2 tree_sha1
+
+=head2 parents
+
+=head2 parent_sha1
+
+=head2 parent_sha1s
+
+
+=head1 METHODS
+
+=head2 get_patch
+
+=head2 diff
+
+=head2 blame
 
 =head1 AUTHORS
 
index 9f75a1e..501576a 100644 (file)
@@ -40,9 +40,22 @@ __END__
 
 Gitalist::Git::Object::HasTree
 
+=head1 SYNOPSIS
+
+    my $tree = Project->get_object($tree_sha1);
+
 =head1 DESCRIPTION
 
-Gitalist::Git::Object::HasTree.
+Role for objects which have a tree - C<Commit> and C<Tree> objects.
+
+
+=head1 ATTRIBUTES
+
+=head2 tree
+
+
+=head1 METHODS
+
 
 =head1 AUTHORS
 
index 3511fb3..766145e 100644 (file)
@@ -16,15 +16,33 @@ class Gitalist::Git::Object::Tag extends Gitalist::Git::Object {
 
 __END__
 
-__END__
-
 =head1 NAME
 
 Gitalist::Git::Object::Tag
 
+=head1 SYNOPSIS
+
+    my $tag = Project->get_object($tag_sha1);
+
 =head1 DESCRIPTION
 
-Gitalist::Git::Object::Tag.
+Represents a tag object in a git repository.
+Subclass of C<Gitalist::Git::Object>.
+
+
+=head1 ATTRIBUTES
+
+=head2 tag
+
+=head2 tagger
+
+=head2 tagged_time
+
+=head2 object
+
+
+=head1 METHODS
+
 
 =head1 AUTHORS
 
index e771ec5..ff01acd 100644 (file)
@@ -14,14 +14,25 @@ class Gitalist::Git::Object::Tree
 
 __END__
 
-
 =head1 NAME
 
 Gitalist::Git::Object::Tree
 
+=head1 SYNOPSIS
+
+    my $tree = Project->get_object($tree_sha1);
+
 =head1 DESCRIPTION
 
-Gitalist::Git::Object::Tree.
+Represents a tree object in a git repository.
+Subclass of C<Gitalist::Git::Object>.
+
+
+=head1 ATTRIBUTES
+
+
+=head1 METHODS
+
 
 =head1 AUTHORS