From 7f86e0715c13512e32775900a559a0759aa8dd05 Mon Sep 17 00:00:00 2001
From: Simon Heimberg <simon.heimberg@heimberg-ea.ch>
Date: Wed, 4 Nov 2020 17:19:06 +0100
Subject: [PATCH] hint in doc of git module to abort on missing http password
 (#72164)

* hint in doc of git module to abort on missing http password

improves #69489

* fix syntax in doc of git module

Co-authored-by: Matt Martz <matt@sivel.net>

Co-authored-by: Matt Martz <matt@sivel.net>
---
 lib/ansible/modules/git.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/lib/ansible/modules/git.py b/lib/ansible/modules/git.py
index 8bf2a5344eb..59e00bbdb23 100644
--- a/lib/ansible/modules/git.py
+++ b/lib/ansible/modules/git.py
@@ -260,6 +260,14 @@ EXAMPLES = '''
 - git:
     single_branch: yes
     branch: master
+
+- name: avoid hanging when http(s) password is missing
+  git:
+    repo: https://github.com/ansible/could-be-a-private-repo
+    dest: /src/from-private-repo
+  environment:
+    GIT_TERMINAL_PROMPT: 0 # reports "terminal prompts disabled" on missing password
+    # or GIT_ASKPASS: /bin/true # for git before version 2.3.0, reports "Authentication failed" on missing password
 '''
 
 RETURN = '''