1 file changed, 7 insertions, 3 deletions
diff --git a/MANUAL.txt b/MANUAL.txt
index c6909cc..4f45d90 100644
--- a/MANUAL.txt
+++ b/MANUAL.txt
@@ -225,9 +225,13 @@ enable-html-serving::
 enable-http-clone::
 	If set to "1", cgit acts as a dumb HTTP endpoint for git clones. Adding
 	"http://$HTTP_HOST$SCRIPT_NAME/$CGIT_REPO_URL" to clone-url exposes it.
-	The files it serves come straight off the disk and are never cached. A
-	site that serves git repositories another way can turn this off.
-	Default value: "1".
+	The files it serves come straight off the disk and are never cached.
+	Most sites can leave this as it is, though the dumb transport is git's
+	older one and is not recommended. cgit does not speak the smart
+	protocol git prefers, so a site that wants it routes clone requests to
+	git-http-backend in its web server, and smart clients use that
+	instead. A site that serves git repositories another way can turn this
+	off. Default value: "1".
 
 enable-index-links::
 	Flag which, when set to "1", makes cgit generate extra links for each