diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml
index 5aa53defc4..858054f2f2 100644
--- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml
+++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml
@@ -570,6 +570,19 @@
+
+ GIT Submodule Fetcher (gitsm://)
+
+
+ This fetcher inherits from the Git fetcher and extends its
+ behavior by fetching a repositories submodules.
+ Uri is passed to the Git fetcher so see
+ the git fetcher documentation for syntax.
+ NOTE: You must clean a recipe when switching between 'git://' and
+ 'gitsm://' urls.
+
+
+
Other Fetchers
@@ -582,9 +595,6 @@
Perforce (p4://)
-
- Git Submodules (gitsm://)
-
Trees using Git Annex (gitannex://)
diff --git a/bitbake/lib/bb/fetch2/gitsm.py b/bitbake/lib/bb/fetch2/gitsm.py
index 1a762153c4..c125cff54b 100644
--- a/bitbake/lib/bb/fetch2/gitsm.py
+++ b/bitbake/lib/bb/fetch2/gitsm.py
@@ -2,6 +2,16 @@
# -*- tab-width: 4; c-basic-offset: 4; indent-tabs-mode: nil -*-
"""
BitBake 'Fetch' git submodules implementation
+
+Inherits from and extends the Git fetcher to retrieve submodules of a git repository
+after cloning.
+
+SRC_URI = "gitsm://"
+
+See the Git fetcher, git://, for usage documentation.
+
+NOTE: Switching a SRC_URI from "git://" to "gitsm://" requires a clean of your recipe.
+
"""
# Copyright (C) 2013 Richard Purdie