# [PATCH] Reference git-check-ref-format in git-branch.

2 messages from 2006-05-21 to 2006-05-21. Participants: Shawn Pearce, Junio C Hamano.
Thread: https://gitlist.dev/t/4227

## Shawn Pearce, 2006-05-21 01:54

Subject: [PATCH] Reference git-check-ref-format in git-branch.
Message-ID: <20060521015446.GA7605@spearce.org>
URL: https://gitlist.dev/e/20060521015446.GA7605%40spearce.org

```
Its nice to have git-check-ref-format actually get mentioned in
git-branch's documentation as the syntax of a ref name must conform
to what is described in git-check-ref-format.

Signed-off-by: Shawn O. Pearce <spearce@spearce.org>

---
 Sorry about this patch being built on pu.  It clearly has no
 relationship to current pu, but the new -l appears in the hunk
 below...

1e2080dcf2f8e76e0fcf48684e5c6b182f695e0a
 Documentation/git-branch.txt   |    3 +++
 Documentation/git-checkout.txt |    5 ++++-
 2 files changed, 7 insertions(+), 1 deletions(-)

1e2080dcf2f8e76e0fcf48684e5c6b182f695e0a
diff --git a/Documentation/git-branch.txt b/Documentation/git-branch.txt
index a7bec3c..d43ef1d 100644
--- a/Documentation/git-branch.txt
+++ b/Documentation/git-branch.txt
@@ -49,6 +49,9 @@ OPTIONS
 
 <branchname>::
 	The name of the branch to create or delete.
+	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.
 
 <start-point>::
 	The new branch will be created with a HEAD equal to this.  It may
diff --git a/Documentation/git-checkout.txt b/Documentation/git-checkout.txt
index 0643943..fbdbadc 100644
--- 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
-- 
1.3.3.gfad60

```

## Junio C Hamano, 2006-05-21 09:07

Subject: Re: [PATCH] Reference git-check-ref-format in git-branch.
Message-ID: <7vhd3jzqyu.fsf@assigned-by-dhcp.cox.net>
URL: https://gitlist.dev/e/7vhd3jzqyu.fsf%40assigned-by-dhcp.cox.net
In-Reply-To: <20060521015446.GA7605@spearce.org>

```
Shawn Pearce <spearce@spearce.org> writes:

>  Sorry about this patch being built on pu.  It clearly has no
>  relationship to current pu, but the new -l appears in the hunk
>  below...

"am -3 -s -u" is how I handle patches anyway, and it did not
have much trouble backporting it to the tip of "master".

```
