git-rm: update to saner semantics

diff --git a/Documentation/git-checkout.txt b/Documentation/git-checkout.txt
index 064394385486ca032c52e513c071ec08895a04c6..fbdbadc74fbe558285323353b7aa006f3cfd559b 100644 (file)
--- a/Documentation/git-checkout.txt
+++ b/Documentation/git-checkout.txt
@@ -35,7 +35,10 @@ OPTIONS
        Force a re-read of everything.
 
 -b::
-       Create a new branch and start it at <branch>.
+       Create a new branch named <new_branch> and start it at
+       <branch>.  The new branch name must pass all checks defined
+       by gitlink:git-check-ref-format[1].  Some of these checks
+       may restrict the characters allowed in a branch name.
 
 -l::
        Create the new branch's ref log.  This activates recording of