doc: clarify return values of Pull/Fetch. (#205)

1 files changed, 5 insertions, 1 deletions

diff --git a/repository.go b/repository.go
index 3c77188..e604d87 100644
--- a/repository.go
+++ b/repository.go
@@ -306,7 +306,9 @@ func (r *Repository) IsEmpty() (bool, error) {
 	})
 }
 
-// Pull incorporates changes from a remote repository into the current branch
+// Pull incorporates changes from a remote repository into the current branch.
+// Returns nil if the operation is successful, NoErrAlreadyUpToDate if there are
+// no changes to be fetched, or an error.
 func (r *Repository) Pull(o *PullOptions) error {
 	if err := o.Validate(); err != nil {
 		return err
@@ -333,6 +335,8 @@ func (r *Repository) Pull(o *PullOptions) error {
 }
 
 // Fetch fetches changes from a remote repository.
+// Returns nil if the operation is successful, NoErrAlreadyUpToDate if there are
+// no changes to be fetched, or an error.
 func (r *Repository) Fetch(o *FetchOptions) error {
 	if err := o.Validate(); err != nil {
 		return err