summaryrefslogtreecommitdiffstats
path: root/src/git-amb.1.in
blob: 046136839e1e732b8d36cada50f230db08a52dc2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
.TH GIT-AMB 1 "@PACKAGE_TARNAME@ @PACKAGE_VERSION@" "2007\-11\-02" "@PACKAGE_NAME@ @PACKAGE_VERSION@"
.SH NAME
git-amb \- git automake build utitilty
.SH SYNOPSIS
.B "git\-amb"
.RB "command"
.RI [ params ]
.SH DESCRIPTION
Build automake based git checkout in branch specific build and install trees.
That makes it easy to compare build results from different branches.
.SH "COMMAND OVERVIEW"
.TP
.B "git\-amb autoreconf [params...]"
Run autoreconf on ${top_srcdir}.
Optional params will be passed on to autoreconf.
.TP
.B "git\-amb configure [params...]"
Run configure in ${top_builddir}.
Optional params will be passed on to configure.
.TP
.B "git\-amb make [params...]"
Run make in ${top_builddir}.
Optional params will be passed on to make.
.TP
.B "git\-amb sh [params...]"
Start shell in ${top_builddir}.
Optional params will be passed on to the shell.
.TP
.B "git\-amb clean [branch]"
Run 'make clean' in ${top_builddir}.
The optional branch is the branch to clean up.
.TP
.B "git\-amb distclean [branch]"
Run 'make distclean' in ${top_builddir}.
The optional branch is the branch to clean up.
.TP
.B "git\-amb purge [branch]"
Remove both build and install tree.
The optional branch is the branch to purge.
.TP
.B "git\-amb uninstall [branch]"
Remove ${installdir}.
The optional branch is the branch to uninstall.
.TP
.B "git\-amb builddir [branch]"
Print ${builddir}.
The optional branch is the branch to print the builddir for.
.TP
.B "git\-amb installdir [branch]"
Print ${installdir}.
The optional branch is the branch to print the installdir for.
.SH CONFIGURATION
Get the value with
.B git config amb.foo
or set it with
.B git config amb.foo value
.SS amb.builddir
Location of build tree, relative to top checkout (source) dir, or absolute.
The branch name will be appended to it.
.SS amb.installdir
Location of installation, relative to top checkout (source) dir, or absolute.
The branch name will be appended to it.
.SH EXAMPLES
.nf
  $ git config amb.builddir _builds
  $ git config amb.installdir _installs
.fi
.PP
.nf
  $ git checkout master
  $ git-amb make install
  $ git checkout foo/bar
  $ git-amb make dist install
  $ diff -ru $(git-amb installdir) $(git-amb installdir master)
  $ git-amb sh
  <----> [...] $ ls *.tar.gz
.fi
.SH AUTHORS
.B "git\-amb"
was written by Hans Ulrich Niedermann.
.SH "SEE ALSO"
git-branch(1), git-checkout(1), git-config(1).