better error handling (thanks Joseph Liu)
[gregoa/movein.git] / movein.1
1 .\" Process this file with
2 .\" groff -man -Tascii foo.1
3 .\"
4 .TH MOVEIN 1 "2011-10-10" movein
5 .SH NAME
6  movein \- manage multiple overlayed git repositories
7 .SH SYNOPSIS
8 .B movein
9 .IR command
10 [
11 .IR args ...
12 ]
13 .SH DESCRIPTION
14 Movein is a script which helps you to manage multiple git repositories
15 which are checked out into the same directory.  A common reason for
16 wanting to do this is to manage your home directory using multiple git
17 repositories.
18 .SH COMMANDS
19 .B movein
20 .IR init
21 .RS 4
22 Initialize movein.  Creates .moveinrc, updates .mrconfig
23 .RE
24
25 .B movein
26 .IR ls
27 .br
28 .B movein
29 .IR list
30 .RS 4
31 Show a list of local repositories
32 .RE
33
34 .B movein
35 .IR ls-r
36 .br
37 .B movein
38 .IR list-remotes
39 .RS 4
40 Show a list of remote repositories
41 .RE
42
43 .B movein
44 .IR add
45 repository_name
46 .RS 4
47 checkout one or more repositories from the remote host and add it to
48 mr's configuration
49 .RE
50
51 .B movein
52 .IR new
53 repository_name file1
54 [
55 file2 file3...
56 ]
57 .RS 4
58 checkout the repository from the remote host and add it to mr's configuration
59 .RE
60
61 .B movein
62 .IR login
63 repository_name
64 .RS 4
65 start a subshell in repository_name
66 .RE
67
68 .B movein
69 .IR locate
70 pattern
71 .RS 4
72 search for files matching "pattern" (which is an extended regular expression
73 passed to sed(1)) in all local repositories
74 .RE
75
76 .B movein
77 .IR exec
78 repository_name command
79 [
80 arg1 arg2...
81 ]
82 .RS 4
83 execute a command in the context of repository_name, for eample
84 .RS 4
85 movein exec myrepo git status
86 .RE
87 .RS 4
88 movein exec myrepo git ls-files
89 .RE
90 .RE
91
92 .SH "SEE ALSO"
93 git(1), mr(1)
94 .SH AUTHOR
95 .TP
96 Mike O'Connor