Documentation: describe the "repository" in repository-layout

diff --git a/Documentation/git-http-fetch.txt b/Documentation/git-http-fetch.txt
index fefa75219822331f7c7bc426a1224978a5da6795..21a33d2c414e24eb779669f10beefde58db00f1c 100644 (file)
--- a/Documentation/git-http-fetch.txt
+++ b/Documentation/git-http-fetch.txt
@@ -3,16 +3,20 @@ git-http-fetch(1)
 
 NAME
 ----
-git-http-fetch - Download from a remote git repository via HTTP
+git-http-fetch - Download from a remote Git repository via HTTP
 
 
 SYNOPSIS
 --------
+[verse]
 'git http-fetch' [-c] [-t] [-a] [-d] [-v] [-w filename] [--recover] [--stdin] <commit> <url>
 
 DESCRIPTION
 -----------
-Downloads a remote git repository via HTTP.
+Downloads a remote Git repository via HTTP.
+
+*NOTE*: use of this command without -a is deprecated.  The -a
+behaviour will become the default in a future release.
 
 OPTIONS
 -------