Which characters are illegal within a branch name?

by

Naming rules for refname:

Git imposes the following rules on how references are named:

  1. They can include slash / for hierarchical (directory) grouping, but no slash-separated component can begin with a dot . or end with the sequence .lock.

  2. They must contain at least one /. This enforces the presence of a category like heads/, tags/ etc. but the actual names are not restricted. If the --allow-onelevel option is used, this rule is waived.

  3. They cannot have two consecutive dots .. anywhere.

  4. They cannot have ASCII control characters (i.e. bytes whose values are lower than \040, or \177 DEL), space, tilde ~, caret ^, or colon : anywhere.

  5. They cannot have question-mark ?, asterisk *, or open bracket [ anywhere. See the --refspec-pattern option below for an exception to this rule.

  6. They cannot begin or end with a slash / or contain multiple consecutive slashes (see the --normalize option below for an exception to this rule)

  7. They cannot end with a dot .

  8. They cannot contain a sequence @{.

  9. They cannot be the single character @.

  10. They cannot contain a \.

On top of that, additional rule for branch name:

  1. They cannot start with a dash -

Thanks to Jakub Narębski, the man page for git check-ref-format has more details.

More Related Contents:

  1. Git fetch remote branch
  2. Showing which files have changed between two revisions
  3. How do I clone a single branch in Git?
  4. How to find the nearest parent of a Git branch
  5. How to fetch all Git branches
  6. How can I get a list of Git branches, ordered by most recent commit?
  7. Git – how to force merge conflict and manual merge on selected file
  8. master branch and ‘origin/master’ have diverged, how to ‘undiverge’ branches’?
  9. Difference between git checkout –track origin/branch and git checkout -b branch origin/branch
  10. View a file in a different Git branch without changing branches
  11. How to determine when a Git branch was created?
  12. How do I delete all Git branches which have been merged?
  13. How do I remove local (untracked) files from the current Git working tree?
  14. Pull a certain branch from the remote server
  15. Reordering of commits
  16. Depend on a branch or tag using a git URL in a package.json?
  17. Git push: “fatal ‘origin’ does not appear to be a git repository – fatal Could not read from remote repository.”
  18. Git branch strategy for small dev team [closed]
  19. Dynamically Fill Jenkins Choice Parameter With Git Branches In a Specified Repo
  20. Git commits are duplicated in the same branch after doing a rebase
  21. Switch Git branch without files checkout
  22. How to protect “master” in github?
  23. Pull all commits from a branch, push specified commits to another
  24. View differences of branches with meld?
  25. Switch branch names in git
  26. Git rebase branch with all parent branches (or dependent sub-branches)
  27. Get all files that have been modified in git branch
  28. Git and working on multiple branches
  29. Can git permanently ignore a remote branch?
  30. Line endings messed up in Git – how to track changes from another branch after a huge line ending fix?

Leave a Comment