]> git.madduck.net Git - code/myrepos.git/blobdiff - README

madduck's git repository

Every one of the projects in this repository is available at the canonical URL git://git.madduck.net/madduck/pub/<projectpath> — see each project's metadata for the exact URL.

All patches and comments are welcome. Please squash your changes to logical commits before using git-format-patch and git-send-email to patches@git.madduck.net. If you'd read over the Git project's submission guidelines and adhered to them, I'd be especially grateful.

SSH access, as well as push access can be individually arranged.

If you use my repositories frequently, consider adding the following snippet to ~/.gitconfig and using the third clone URL listed for each project:

[url "git://git.madduck.net/madduck/"]
  insteadOf = madduck:

Always ensure all parent .mrconfig files are loaded
[code/myrepos.git] / README
diff --git a/README b/README
index b934894cb70a21312de2afea2073b9d51e359322..750186dc616a761dc127f49468386b95ee009ebb 100644 (file)
--- a/README
+++ b/README
@@ -1,6 +1,33 @@
-mr is intended to be very self-contained, since it might be useful to check
-it into ~/bin when keeping your home in version control. It has no
-dependencies aside from basic perl.
+myrepos, a tool to manage all your version control repos
 
-Just copy mr into your PATH somewhere, if it isn't already, and set up
-~/.mrconfig
+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 supports git, svn, mercurial, bzr, darcs, cvs, fossil and veracity.
+
+Author: Joey Hess
+Homepage: http://myrepos.branchable.com/
+
+The mr command is intended to be very self-contained, since it might be
+useful to check it into ~/bin when keeping your home in version control. It
+has no dependencies aside from basic perl. (The included webcheckout
+command has more dependencies, specifically the LWP::Simple and
+HTML::Parser CPAN modules, and optionally the URI module.)
+
+To install mr, just copy mr into your PATH somewhere.
+
+To get started using mr, perhaps you already have some checked out
+repositories. Go into each one and run "mr register". Now mr has
+a list of them in ~/.mrconfig, which you can edit later to tune its
+operation.
+
+Suppose you've cd'd to ~/src, and it has many repositories under it.
+To update them all, run "mr update". To commit any pending changes in
+each, run "mr commit". To check the status of each, you could run
+"mr status".
+
+For further details, and lots of configuration options, see the mr(1) man
+page or the website, http://myrepos.branchable.com/