documentation

2 files changed, 36 insertions, 7 deletions

diff --git a/examples/basic/main.go b/examples/basic/main.go
index 4b443b2..f5a1c8a 100644
--- a/examples/basic/main.go
+++ b/examples/basic/main.go
@@ -9,24 +9,21 @@ import (
 )
 
 func main() {
-	fmt.Printf("Retrieving %q ...\n", os.Args[2])
-	r, err := git.NewRepository(os.Args[2], nil)
+	fmt.Printf("Retrieving %q ...\n", os.Args[1])
+	r, err := git.NewRepository(os.Args[1], nil)
 	if err != nil {
 		panic(err)
 	}
 
-	if err := r.Pull("origin", "refs/heads/master"); err != nil {
+	if err := r.PullDefault(); err != nil {
 		panic(err)
 	}
 
-	dumpCommits(r)
-}
-
-func dumpCommits(r *git.Repository) {
 	iter := r.Commits()
 	defer iter.Close()
 
 	for {
+		//the commits are not shorted in any special order
 		commit, err := iter.Next()
 		if err != nil {
 			if err == io.EOF {
diff --git a/examples/latest/latest.go b/examples/latest/latest.go
new file mode 100644
index 0000000..84aaf48
--- /dev/null
+++ b/examples/latest/latest.go
@@ -0,0 +1,32 @@
+package main
+
+import (
+	"fmt"
+	"os"
+
+	"gopkg.in/src-d/go-git.v3"
+)
+
+func main() {
+	fmt.Printf("Retrieving latest commit from: %q ...\n", os.Args[1])
+	r, err := git.NewRepository(os.Args[1], nil)
+	if err != nil {
+		panic(err)
+	}
+
+	if err := r.Pull(git.DefaultRemoteName, "refs/heads/master"); err != nil {
+		panic(err)
+	}
+
+	hash, err := r.Remotes[git.DefaultRemoteName].Head()
+	if err != nil {
+		panic(err)
+	}
+
+	commit, err := r.Commit(hash)
+	if err != nil {
+		panic(err)
+	}
+
+	fmt.Println(commit)
+}