Chnge option name to track_submodule_branches.

Update documentation to reflect what the actual effect of the option.

source_control/git.py

@@ -129,13 +129,13 @@ options:
             - if C(no), repository will be cloned without the --recursive
               option, skipping sub-modules.
 
-    track_branches:
+    track_submodule_branches:
         required: false
         default: "yes"
         choices: ["yes", "no"]
         version_added: "1.7"
         description:
-            - if C(no), repository will be cloned without the --recursive
+            - if C(no), submodules will be updated without the --remote
               option, allowing submodules to be tracked by commit hash
               instead of branch name.
 notes:
@@ -409,7 +409,7 @@ def get_head_branch(git_path, module, dest, remote, bare=False):
     f.close()
     return branch
 
-def fetch(git_path, module, repo, dest, version, remote, bare, track_branches):
+def fetch(git_path, module, repo, dest, version, remote, bare, track_submodule_branches):
     ''' updates repo from remote sources '''
     (rc, out0, err0) = module.run_command([git_path, 'remote', 'set-url', remote, repo], cwd=dest)
     if rc != 0:
@@ -427,10 +427,10 @@ def fetch(git_path, module, repo, dest, version, remote, bare, track_branches):
         (rc, out2, err2) = module.run_command("%s fetch --tags %s" % (git_path, remote), cwd=dest)
     if rc != 0:
         module.fail_json(msg="Failed to download remote objects and refs")
-    (rc, out3, err3) = submodule_update(git_path, module, dest, track_branches )
+    (rc, out3, err3) = submodule_update(git_path, module, dest, track_submodule_branches )
     return (rc, out1 + out2 + out3, err1 + err2 + err3)
 
-def submodule_update(git_path, module, dest, track_branches):
+def submodule_update(git_path, module, dest, track_submodule_branches):
     ''' init and update any submodules '''
 
     # get the valid submodule params
@@ -441,7 +441,7 @@ def submodule_update(git_path, module, dest, track_branches):
         return (0, '', '')
     cmd = [ git_path, 'submodule', 'sync' ]
     (rc, out, err) = module.run_command(cmd, check_rc=True, cwd=dest)
-    if 'remote' in params and track_branches:
+    if 'remote' in params and track_submodule_branches:
         cmd = [ git_path, 'submodule', 'update', '--init', '--recursive' ,'--remote' ]
     else:
         cmd = [ git_path, 'submodule', 'update', '--init', '--recursive' ]
@@ -451,7 +451,7 @@ def submodule_update(git_path, module, dest, track_branches):
     return (rc, out, err)
 
 
-def switch_version(git_path, module, dest, remote, version, recursive, track_branches):
+def switch_version(git_path, module, dest, remote, version, recursive, track_submodule_branches):
     cmd = ''
     if version != 'HEAD':
         if is_remote_branch(git_path, module, dest, remote, version):
@@ -477,7 +477,7 @@ def switch_version(git_path, module, dest, remote, version, recursive, track_bra
         else:
             module.fail_json(msg="Failed to checkout branch %s" % (branch))
     if recursive:
-        (rc, out2, err2) = submodule_update(git_path, module, dest, track_branches)
+        (rc, out2, err2) = submodule_update(git_path, module, dest, track_submodule_branches)
         out1 += out2
         err1 += err1
     return (rc, out1, err1)
@@ -501,7 +501,7 @@ def main():
             executable=dict(default=None),
             bare=dict(default='no', type='bool'),
             recursive=dict(default='yes', type='bool'),
-            track_branches=dict(default='yes', type='bool'),
+            track_submodule_branches=dict(default='yes', type='bool'),
         ),
         supports_check_mode=True
     )
@@ -546,7 +546,7 @@ def main():
         add_git_host_key(module, repo, accept_hostkey=module.params['accept_hostkey'])
 
     recursive = module.params['recursive']
-    track_branches = module.params['track_branches']
+    track_submodule_branches = module.params['track_submodule_branches']
 
     rc, out, err, status = (0, None, None, None)
 
@@ -592,12 +592,12 @@ def main():
                 module.exit_json(changed=False, before=before, after=remote_head)
         if module.check_mode:
             module.exit_json(changed=True, before=before, after=remote_head)
-        fetch(git_path, module, repo, dest, version, remote, bare, track_branches)
+        fetch(git_path, module, repo, dest, version, remote, bare, track_submodule_branches)
 
     # switch to version specified regardless of whether
     # we cloned or pulled
     if not bare:
-        switch_version(git_path, module, dest, remote, version, recursive, track_branches)
+        switch_version(git_path, module, dest, remote, version, recursive, track_submodule_branches)
 
     # determine if we changed anything
     after = get_version(module, git_path, dest)