threads / patch / 4227

patchReference git-check-ref-format in git-branch.

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

## tl;dr

2 messages between May 21, 2006 and May 21, 2006. Diffs are folded; open one to read it.

replies: 1people: 2as markdown or json

Shawn Pearce· May 21, 2006, 01:54 UTC · lore

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
Show changes to 2 files +7 −1

Documentation/git-branch.txt, Documentation/git-checkout.txt

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· May 21, 2006, 09:07 UTC · re: Shawn Pearce · lore

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

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".

← back to recent threads