Git/branch

A "branch" is a separate copy (of the files involved in a project) which can be worked on without affecting the original copy.

"Branching" is a concept basic to most version control systems.

Commands

Information:

• git branch lists local branches
• git branch -r lists the remote branches
• git branch -a lists both local and remote branches

Actions:

• git branch Template:Arg creates a new branch called "name", pointing at the current Template:L/same revision
• git Template:L/same Template:Arg moves Template:L/same to point to the branch called "name"
  • Note: git Template:L/same -b Template:Arg accomplishes both of the above in a single command
• git branch -d Template:Arg to delete a branch
  • Note: must be in a different branch

The basic sequence of events for creating a new branch called "test", updating it, then reverting back to the original branch:

• git branch test - create the branch
• git checkout test - switch to it
• Template:L/sub whatever changes you want to include in "test"
  • This can include adding any new files you've created for this branch.
• git commit -a -m 'made a change' - commit the change to "test"
• git checkout master - switch back to the main branch (removes new files, restores any you deleted)

Links

Reference

• Official:
  • git-branch - List, create, or delete branches
  • 3.1 Git Branching - Branches in a Nutshell

How To

• 2019-10-07 How To Rename a Local and Remote Git Branch
  • Basically: Template:Fmt/code renames the branch locally and doesn't mess with anything upstream. It's like you just created Template:Arg and put stuff in it.
  • Note: if the branch is not in the local repository, then you just need to git fetch it after the git checkout <old_name>.
  • Also: Template:Fmt/code to copy instead of renaming.