summaryrefslogtreecommitdiff
path: root/Documentation/git-credential-store.txt
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2020-04-28 18:15:15 (GMT)
committerJunio C Hamano <gitster@pobox.com>2020-04-29 04:27:50 (GMT)
commit20b4964fdf43491494122fbd297b2da7d66663b2 (patch)
tree3938960573950d9ed333d4e51f687ff091e076a2 /Documentation/git-credential-store.txt
parentdf5be6dc3fd18c294ec93a9af0321334e3f92c9c (diff)
downloadgit-20b4964fdf43491494122fbd297b2da7d66663b2.zip
git-20b4964fdf43491494122fbd297b2da7d66663b2.tar.gz
git-20b4964fdf43491494122fbd297b2da7d66663b2.tar.bz2
credential-store: document the file format a bit more
Reading a malformed credential URL line and silently ignoring it does not mean that we support empty lines and/or "# commented" lines forever. We should document it to avoid confusion. Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation/git-credential-store.txt')
-rw-r--r--Documentation/git-credential-store.txt4
1 files changed, 4 insertions, 0 deletions
diff --git a/Documentation/git-credential-store.txt b/Documentation/git-credential-store.txt
index 25fb963..24166ca 100644
--- a/Documentation/git-credential-store.txt
+++ b/Documentation/git-credential-store.txt
@@ -94,6 +94,10 @@ stored on its own line as a URL like:
https://user:pass@example.com
------------------------------
+No other kinds of lines (e.g. empty lines or comment lines) are
+allowed in the file, even though some may be silently ignored. Do
+not view or edit the file with editors.
+
When Git needs authentication for a particular URL context,
credential-store will consider that context a pattern to match against
each entry in the credentials file. If the protocol, hostname, and