X-Git-Url: https://git.madduck.net/code/myrepos.git/blobdiff_plain/e15284667a00085b3e45144048d7abe66627af9c..a36be6f63b310b4b4f84381546c73625f450b9c4:/doc/index.mdwn diff --git a/doc/index.mdwn b/doc/index.mdwn index ea20656..784fcf8 100644 --- a/doc/index.mdwn +++ b/doc/index.mdwn @@ -1,43 +1,81 @@ -The mr(1) command can checkout, update, or perform other actions on a set -of repositories as if they were one combined respository. It supports any -combination of subversion, git, cvs, mercurial, bzr, darcs, cvs, vcsh, -fossil and veracity repositories, and support for other revision control -systems can easily be added. (There are extensions adding support for -unison and git-svn.) +You have a lot of version control repositories. Sometimes you want to +update them all at once. Or push out all your local changes. You use +special command lines in some repositories to implement specific workflows. +Myrepos provides a `mr` command, which is a tool to manage all your version +control repositories. -It is extremely configurable via simple shell scripting. Some examples -of things it can do include: +## getting started -* Update a repository no more frequently than once every twelve hours. -* Run an arbitrary command before committing to a repository. -* When updating a git repository, pull from two different upstreams - and merge the two together. -* Run several repository updates in parallel, greatly speeding up - the update process. -* Remember actions that failed due to a laptop being offline, so they - can be retried when it comes back online. +All you need to get started is some already checked out repos. +These could be using git, or bzr, mercurial or darcs, or many other version +control systems. Doesn't matter, they're all supported! -## Get mr +Inside each of your repositories, run `mr register`. +That sets up a `~/.mrconfig` file listing your repositories. -mr is available in git at `git://git.kitenet.net/mr`, or -[in gitweb](http://git.kitenet.net/?p=mr.git). It's in all recent versions -of Debian. If you want a tarball, the best place to get one is from -. Unofficial RPMs are -provided by [Douglas E. Warner](http://www.silfreed.net/download/repo/packages/mr/). -It's also in Mac Homebrew. +Now you can run `mr update` in your home directory, and it'll update +every one of your repositories that you've registered with myrepos. -## Discuss mr +Want to update repositories in parallel? `mr update -j5` will run 5 +concurrent jobs! -The [VCS-Home](http://vcs-home.madduck.net/) group has a mailing list that -is probably the best place to discuss mr. +If you run `mr update` inside a repository, it'll only act on that +repository. In general, any `mr` command runs recursively over any +repository located somewhere in or under the current directory. -Bugs should be filed to the [Debian BTS](http://bugs.debian.org/mr). +You can also run `mr commit`, `mr push`, `mr status`, `mr diff`, and a lot +of other commands. These work no matter which version control system is +used for a repository. Of course, you can still use the native version +control commands too. -## News +Oh, and you can abbreviate any command to any unambiguous abbreviation. +`mr up`, `mr pu`, etc. -[[!inline pages="news/* and !*/Discussion" show="4" archive=yes]] +Now, maybe you find that you always want to update one repository using +`git pull --rebase`, instead of the default `git pull` that `mr update` runs. +No problem: The `~/.mrconfig` file makes it easy to override the command +run for any repository. It's like a `Makefile` for repositories. + + [foo] + checkout = git@github.com:joeyh/foo.git + update = git pull --rebase + +You can make up your own commands too: + + [bar] + # This repository has an upstream, which I've forked; + # set up a remote on checkout. + checkout = + git clone git@github.com:joeyh/bar.git + cd bar + git remote add upstream git@github.com:barbar/bar.git + # make `mr zap` integrate from upstream + zap = + git pull upstream + git merge upstream/master + git push origin master + +You can even define commands globally, so `mr` can use them in all repositories. + + [DEFAULT] + # Teach mr how to `mr gc` in git repos. + git_gc = git gc "$@" -[[!sidebar content=""" - -Flattr this -"""]] +This only scratches the surface of the ways you can use myrepos to automate +and mange your repositories! + +Some more examples of things it can do include: + +* Update a repository no more frequently than once every twelve hours. +* Run an arbitrary command before committing to a repository. +* Remember actions that failed due to a laptop being offline, so they + can be retried when it comes back online. +* Combine several related repositories into a single logical repository, + with its own top-level `.mrconfig` file that lists them and can be + chain loaded from `~/.mrconfig`. +* Manage your whole home directory in version control. + (See [VCS-Home](http://vcs-home.branchable.com/)) + +## news + +[[!inline pages="news/* and !*/Discussion" show="4" archive=yes]]