doc/index.mdwn

   1 The mr(1) command can checkout, update, or perform other actions on a set
   2 of repositories as if they were one combined respository. It supports any
   3 combination of subversion, git, cvs, mercurial, bzr, darcs, cvs, vcsh,
   4 fossil and veracity repositories, and support for other revision control
   5 systems can easily be added. (There are extensions adding support for
   6 unison and git-svn.)
   7
   8 It is extremely configurable via simple shell scripting. Some examples
   9 of things it can do include:
  10
  11 * Update a repository no more frequently than once every twelve hours.
  12 * Run an arbitrary command before committing to a repository.
  13 * When updating a git repository, pull from two different upstreams
  14   and merge the two together.
  15 * Run several repository updates in parallel, greatly speeding up
  16   the update process.
  17 * Remember actions that failed due to a laptop being offline, so they
  18   can be retried when it comes back online.
  19
  20 ## Get mr
  21
  22 mr is available in git at `git://git.kitenet.net/mr`, or
  23 [in gitweb](http://git.kitenet.net/?p=mr.git). It's in all recent versions
  24 of Debian. If you want a tarball, the best place to get one is from
  25 <http://packages.debian.org/unstable/source/mr>. Unofficial RPMs are
  26 provided by [Douglas E. Warner](http://www.silfreed.net/download/repo/packages/mr/).
  27 It's also in Mac Homebrew.
  28
  29 ## Discuss mr
  30
  31 The [VCS-Home](http://vcs-home.madduck.net/) group has a mailing list that
  32 is probably the best place to discuss mr.
  33
  34 Bugs should be filed to the [Debian BTS](http://bugs.debian.org/mr).
  35
  36 ## News
  37
  38 [[!inline pages="news/* and !*/Discussion" show="4" archive=yes]]
  39
  40 [[!sidebar content="""
  41 <a href="https://flattr.com/thing/39937/mr1" target="_blank">
  42 <img src="http://api.flattr.com/button/button-static-50x60.png" alt="Flattr this" title="Flattr this" border="0" /></a>
  43 """]]