Merge pull request go-git#63 from pyaillet/doc/submodule-update-example

_examples: submodule, adding an example with submodule update

Author: mcuadros

_examples/README.md

@@ -20,6 +20,7 @@ Here you can find a list of annotated _go-git_ examples:
 - [remotes](remotes/main.go) - Working with remotes: adding, removing, etc
 - [progress](progress/main.go) - Printing the progress information from the sideband
 - [revision](revision/main.go) - Solve a revision into a commit
+- [submodule](submodule/main.go) - Submodule update remote
 
 ### Advanced
 - [custom_http](custom_http/main.go) - Replacing the HTTP client using a custom one

_examples/submodule/main.go

@@ -0,0 +1,55 @@
+package main
+
+import (
+	"os"
+
+	"github.com/go-git/go-git/v5"
+	. "github.com/go-git/go-git/v5/_examples"
+)
+
+// Basic example of how to clone a repository including a submodule and
+// updating submodule ref
+func main() {
+	CheckArgs("<url>", "<directory>", "<submodule>")
+	url := os.Args[1]
+	directory := os.Args[2]
+	submodule := os.Args[3]
+
+	// Clone the given repository to the given directory
+	Info("git clone %s %s --recursive", url, directory)
+
+	r, err := git.PlainClone(directory, false, &git.CloneOptions{
+		URL:               url,
+		RecurseSubmodules: git.DefaultSubmoduleRecursionDepth,
+	})
+
+	CheckIfError(err)
+
+	w, err := r.Worktree()
+	if err != nil {
+		CheckIfError(err)
+	}
+
+	sub, err := w.Submodule(submodule)
+	if err != nil {
+		CheckIfError(err)
+	}
+
+	sr, err := sub.Repository()
+	if err != nil {
+		CheckIfError(err)
+	}
+
+	sw, err := sr.Worktree()
+	if err != nil {
+		CheckIfError(err)
+	}
+
+	Info("git submodule update --remote")
+	err = sw.Pull(&git.PullOptions{
+		RemoteName: "origin",
+	})
+	if err != nil {
+		CheckIfError(err)
+	}
+}