Merge branch 'html'
[guilt.git] / man1 / guilt-select.1
blob1ec713ef8fd6394d71c384a9195018ad85a549da
1 '\" t
2 .\"     Title: guilt-select
3 .\"    Author: [see the "Author" section]
4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
5 .\"      Date: 09/18/2010
6 .\"    Manual: Guilt Manual
7 .\"    Source: Guilt v0.34
8 .\"  Language: English
9 .\"
10 .TH "GUILT\-SELECT" "1" "09/18/2010" "Guilt v0\&.34" "Guilt Manual"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18 .ie \n(.g .ds Aq \(aq
19 .el       .ds Aq '
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
24 .nh
25 .\" disable justification (adjust text to left margin only)
26 .ad l
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
30 .SH "NAME"
31 guilt-select \- Select guards to apply when pushing patches
32 .SH "SYNOPSIS"
33 \fIguilt\-select\fR [ \-n | \-\-none | \-s | \-\-series | [\-\-pop|\-\-reapply] <guards\&...> ]
34 .SH "DESCRIPTION"
35 Select guards to apply when pushing patches\&.
37 Guards are selected without the + or \- prefix\&. Patches are applied in the following way:
39 .sp
40 .RS 4
41 .ie n \{\
42 \h'-04'\(bu\h'+03'\c
43 .\}
44 .el \{\
45 .sp -1
46 .IP \(bu 2.3
47 .\}
48 An unguarded patch is always applied\&.
49 .RE
50 .sp
51 .RS 4
52 .ie n \{\
53 \h'-04'\(bu\h'+03'\c
54 .\}
55 .el \{\
56 .sp -1
57 .IP \(bu 2.3
58 .\}
59 A patch with a positive guard is applied \fBonly\fR if the guard is selected with guilt\-select\&.
60 .RE
61 .sp
62 .RS 4
63 .ie n \{\
64 \h'-04'\(bu\h'+03'\c
65 .\}
66 .el \{\
67 .sp -1
68 .IP \(bu 2.3
69 .\}
70 A patch with a negative guard is applied \fBunless\fR the guard is selected with guilt\-select\&.
71 .RE
72 .SH "OPTIONS"
73 .PP
74 \-n|\-\-none
75 .RS 4
76 Remove all selected guards
77 .RE
78 .PP
79 \-\-pop
80 .RS 4
81 Pop back to the first guarded patch
82 .RE
83 .PP
84 \-\-reapply
85 .RS 4
86 Pop back to first guarded patch, select a new guard, and push
87 .RE
88 .PP
89 \-s|\-\-series
90 .RS 4
91 List all guards listed in the series file
92 .RE
93 .SH "AUTHOR"
94 Written by Eric Lesh <\m[blue]\fBeclesh@ucla\&.edu\fR\m[]\&\s-2\u[1]\d\s+2>
95 .SH "DOCUMENTATION"
96 Documentation by Eric Lesh <\m[blue]\fBeclesh@ucla\&.edu\fR\m[]\&\s-2\u[1]\d\s+2>
97 .SH "GUILT"
98 Part of the \fBguilt\fR(7) suite (Generated for Guilt v0\&.34)
99 .SH "NOTES"
100 .IP " 1." 4
101 eclesh@ucla.edu
102 .RS 4
103 \%mailto:eclesh@ucla.edu