git-topic(1)

NAME
git-topic - manage private topic branches

SYNOPSIS
git topic command|topic-name

DESCRIPTION
git topic is a simple script I use to manage private branch workflows. A topic branch is a local private branch used to create a small set of changes that will be merged into a master branch when completed.
If no command is specified, then the name used is assumed to be the name of a topic branch. If the topic already exists, it is checked out. If it doesn't, it is created from the current branch. Incidentally this means a topic branch cannot have a name that matches a command. If no command or topic name is given, then a list of existing topics is shown.

COMMANDS

add topic-name
    This creates a new local git topic branch from the current checkout. All topic branches get "topic-" prepended to the git branch name. This allows git topic to determine when it is in a topic branch.

close [branch]
    This closes the current topic by merging it into another branch (or master). The target branch is checked out, and the topic branch is then deleted.

drop topic-name
    This removes an already existing topic branch.

list
    This lists all active topic branches.

master
    This commits current changes in the topic branch, and switches back to the master branch. This goes to the true master branch, not return the branch the topic was originally created from. aybe such functionality will be added into the future.

merge topic-name|branch
    This is used to merge a private topic branch into another branch, or to update the current topic checkout from changes in another branch. Like master, it is not aware of the original branch your topic was created from, so if in a topic branch checkout, the original branch must be named, or master branch is assumed by default.

patch branch
    This creates a patch from the current topic branch. The patch is between the current topic and the specified branch which is presumably the original branch the topic was created from. If no branch is specified, then the master branch is used.

rebase branch
    This is used to rebase the current topic branch on another branch.

AUTHOR
git-topic was written by David Sugar <dyfet@gnutelephony.org>

REPORTING BUGS
Report bugs to dyfet@gnutelephony.org. Copyright © 2011-2014 David Sugar
This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.