Update documentation

This commit is contained in:
J. David Ibáñez 2013-11-24 13:34:27 +01:00
parent f26d6bedfe
commit c80fb4814f
6 changed files with 68 additions and 2 deletions

View File

@ -4,4 +4,6 @@ J. David Ibáñez <jdavid.ibp@gmail.com> <jdavid@itaapy.com>
Martin Lenders <mlenders@elegosoft.com> <authmill@datalove.me> Martin Lenders <mlenders@elegosoft.com> <authmill@datalove.me>
Richo Healey <richo@psych0tik.net> Richo Healey <richo@psych0tik.net>
Xavier Delannoy <xavier.delannoy@gmail.com> Xavier Delannoy <xavier.delannoy@gmail.com>
Xu Tao <xutao@douban.com> Xu Tao <xutao881001@gmail.com> <xutao@douban.com>
Xu Tao <xutao881001@gmail.com>
<petrhosek@gmail.com> <p.hosek@imperial.ac.uk>

46
docs/blame.rst Normal file
View File

@ -0,0 +1,46 @@
**********************************************************************
Blame
**********************************************************************
.. contents::
.. automethod:: pygit2.Repository.blame
The Blame type
==============
.. automethod:: pygit2.Blame.for_line
.. method:: iter(Blame)
.. method:: len(Blame)
.. method:: Blame[n]
The BlameHunk type
==================
Attributes:
.. autoattribute:: pygit2.BlameHunk.lines_in_hunk
.. autoattribute:: pygit2.BlameHunk.final_commit_id
.. autoattribute:: pygit2.BlameHunk.final_start_line_number
.. autoattribute:: pygit2.BlameHunk.orig_commit_id
.. autoattribute:: pygit2.BlameHunk.orig_path
.. autoattribute:: pygit2.BlameHunk.orig_start_line_number
.. autoattribute:: pygit2.BlameHunk.boundary
Getters:
.. autoattribute:: pygit2.BlameHunk.final_committer
.. autoattribute:: pygit2.BlameHunk.orig_committer
Constants
=========
.. py:data:: GIT_BLAME_NORMAL
.. py:data:: GIT_BLAME_TRACK_COPIES_SAME_FILE
.. py:data:: GIT_BLAME_TRACK_COPIES_SAME_COMMIT_MOVES
.. py:data:: GIT_BLAME_TRACK_COPIES_SAME_COMMIT_COPIES
.. py:data:: GIT_BLAME_TRACK_COPIES_ANY_COMMIT_COPIES

View File

@ -35,6 +35,10 @@ The Diff type
==================== ====================
.. autoattribute:: pygit2.Diff.patch .. autoattribute:: pygit2.Diff.patch
.. method:: len(Diff)
Returns the number of deltas/patches in this diff.
.. automethod:: pygit2.Diff.merge .. automethod:: pygit2.Diff.merge
.. automethod:: pygit2.Diff.find_similar .. automethod:: pygit2.Diff.find_similar
@ -42,6 +46,8 @@ The Diff type
The Patch type The Patch type
==================== ====================
Attributes:
.. autoattribute:: pygit2.Patch.old_file_path .. autoattribute:: pygit2.Patch.old_file_path
.. autoattribute:: pygit2.Patch.new_file_path .. autoattribute:: pygit2.Patch.new_file_path
.. autoattribute:: pygit2.Patch.old_oid .. autoattribute:: pygit2.Patch.old_oid
@ -49,6 +55,12 @@ The Patch type
.. autoattribute:: pygit2.Patch.status .. autoattribute:: pygit2.Patch.status
.. autoattribute:: pygit2.Patch.similarity .. autoattribute:: pygit2.Patch.similarity
.. autoattribute:: pygit2.Patch.hunks .. autoattribute:: pygit2.Patch.hunks
.. autoattribute:: pygit2.Patch.additions
.. autoattribute:: pygit2.Patch.deletions
Getters:
.. autoattribute:: pygit2.Patch.is_binary
The Hunk type The Hunk type

View File

@ -44,6 +44,7 @@ Usage guide:
merge merge
config config
remotes remotes
blame
Indices and tables Indices and tables

View File

@ -109,6 +109,9 @@ This is their API:
>>> print blob.size >>> print blob.size
130 130
.. autoattribute:: pygit2.Blob.is_binary
Creating blobs Creating blobs
-------------- --------------

View File

@ -18,6 +18,7 @@ The Reference type
==================== ====================
.. autoattribute:: pygit2.Reference.name .. autoattribute:: pygit2.Reference.name
.. autoattribute:: pygit2.Reference.shorthand
.. autoattribute:: pygit2.Reference.target .. autoattribute:: pygit2.Reference.target
.. autoattribute:: pygit2.Reference.type .. autoattribute:: pygit2.Reference.type
@ -25,6 +26,7 @@ The Reference type
.. automethod:: pygit2.Reference.rename .. automethod:: pygit2.Reference.rename
.. automethod:: pygit2.Reference.resolve .. automethod:: pygit2.Reference.resolve
.. automethod:: pygit2.Reference.log .. automethod:: pygit2.Reference.log
.. automethod:: pygit2.Reference.log_append
.. automethod:: pygit2.Reference.get_object .. automethod:: pygit2.Reference.get_object
@ -38,7 +40,7 @@ Example. These two lines are equivalent::
.. autoattribute:: pygit2.Repository.head .. autoattribute:: pygit2.Repository.head
.. autoattribute:: pygit2.Repository.head_is_detached .. autoattribute:: pygit2.Repository.head_is_detached
.. autoattribute:: pygit2.Repository.head_is_orphaned .. autoattribute:: pygit2.Repository.head_is_unborn
Branches Branches
==================== ====================