1.nh
2.TH GIT\-BUG(1)Apr 2019
3Generated from git\-bug's source code
4
5.SH NAME
6.PP
7git\-bug\-ls \- List bugs.
8
9
10.SH SYNOPSIS
11.PP
12\fBgit\-bug ls [] [flags]\fP
13
14
15.SH DESCRIPTION
16.PP
17Display a summary of each bugs.
18
19.PP
20You can pass an additional query to filter and order the list. This query can be expressed either with a simple query language or with flags.
21
22
23.SH OPTIONS
24.PP
25\fB\-s\fP, \fB\-\-status\fP=[]
26 Filter by status. Valid values are [open,closed]
27
28.PP
29\fB\-a\fP, \fB\-\-author\fP=[]
30 Filter by author
31
32.PP
33\fB\-p\fP, \fB\-\-participant\fP=[]
34 Filter by participant
35
36.PP
37\fB\-A\fP, \fB\-\-actor\fP=[]
38 Filter by actor
39
40.PP
41\fB\-l\fP, \fB\-\-label\fP=[]
42 Filter by label
43
44.PP
45\fB\-t\fP, \fB\-\-title\fP=[]
46 Filter by title
47
48.PP
49\fB\-n\fP, \fB\-\-no\fP=[]
50 Filter by absence of something. Valid values are [label]
51
52.PP
53\fB\-b\fP, \fB\-\-by\fP="creation"
54 Sort the results by a characteristic. Valid values are [id,creation,edit]
55
56.PP
57\fB\-d\fP, \fB\-\-direction\fP="asc"
58 Select the sorting direction. Valid values are [asc,desc]
59
60.PP
61\fB\-f\fP, \fB\-\-format\fP="default"
62 Select the output formatting style. Valid values are [default,plain,json,org\-mode]
63
64.PP
65\fB\-h\fP, \fB\-\-help\fP[=false]
66 help for ls
67
68
69.SH EXAMPLE
70.PP
71.RS
72
73.nf
74List open bugs sorted by last edition with a query:
75git bug ls status:open sort:edit\-desc
76
77List closed bugs sorted by creation with flags:
78git bug ls \-\-status closed \-\-by creation
79
80
81.fi
82.RE
83
84
85.SH SEE ALSO
86.PP
87\fBgit\-bug(1)\fP