|
1 | | -.\" generated with Ronn/v0.7.3 |
2 | | -.\" http://github.com/rtomayko/ronn/tree/0.7.3 |
3 | | -. |
4 | | -.TH "GIT\-SUMMARY" "1" "February 2023" "" "Git Extras" |
5 | | -. |
| 1 | +.\" generated with Ronn-NG/v0.9.1 |
| 2 | +.\" http://github.com/apjanke/ronn-ng/tree/0.9.1 |
| 3 | +.TH "GIT\-SUMMARY" "1" "June 2023" "" "Git Extras" |
6 | 4 | .SH "NAME" |
7 | 5 | \fBgit\-summary\fR \- Show repository summary |
8 | | -. |
9 | 6 | .SH "SYNOPSIS" |
10 | 7 | \fBgit\-summary\fR [\-\-dedup\-by\-email] [\-\-no\-merges] [<committish>] |
11 | | -. |
12 | | -.br |
| 8 | +.P |
13 | 9 | \fBgit\-summary\fR \-\-line [<path>] |
14 | | -. |
15 | 10 | .SH "DESCRIPTION" |
16 | 11 | Shows a summary of the repository or a path within it\. |
17 | | -. |
18 | 12 | .SH "OPTIONS" |
19 | 13 | <committish> |
20 | | -. |
21 | 14 | .P |
22 | 15 | Summarize only the range of commits included in the <committish>\. |
23 | | -. |
24 | 16 | .P |
25 | 17 | <path> |
26 | | -. |
27 | 18 | .P |
28 | 19 | Summarize only the range of files included in the <path>\. |
29 | | -. |
30 | 20 | .P |
31 | 21 | \-\-dedup\-by\-email |
32 | | -. |
33 | 22 | .P |
34 | 23 | Remove duplicate authors who belong to the same email address\. For example, |
35 | | -. |
36 | 24 | .IP "" 4 |
37 | | -. |
38 | 25 | .nf |
39 | | - |
40 | 26 | $ git summary |
41 | | -\.\.\. |
| 27 | +\|\.\|\.\|\. |
42 | 28 | 133 TJ Holowaychuk 9\.9% |
43 | 29 | 115 Tj Holowaychuk 8\.5% |
44 | 30 |
|
45 | 31 | $ git summary \-\-dedup\-by\-email |
46 | | -\.\.\. |
| 32 | +\|\.\|\.\|\. |
47 | 33 | 248 TJ Holowaychuk 18\.4% |
48 | | -. |
49 | 34 | .fi |
50 | | -. |
51 | 35 | .IP "" 0 |
52 | | -. |
53 | 36 | .P |
54 | 37 | \-\-no\-merges |
55 | | -. |
56 | 38 | .P |
57 | 39 | Exclude merge commits\. |
58 | | -. |
59 | 40 | .P |
60 | 41 | \-\-line |
61 | | -. |
62 | 42 | .P |
63 | 43 | Summarize with lines other than commits\. When \fB\-\-line\fR is specified, the last argument is treated as <path>\. |
64 | | -. |
65 | 44 | .P |
66 | 45 | This option can not be used together with \fB\-\-dedup\-by\-email\fR or \fB\-\-no\-merges\fR\. |
67 | | -. |
68 | 46 | .P |
69 | 47 | \-\-output\-style <style> |
70 | | -. |
71 | 48 | .P |
72 | | -Summarizes the repository and print the output accoring to the specified style\. Styles: * \fBtabular\fR: Prints the summary in a tabular form having a header in the first line and the values in the second\. Column separator is a \fB|\fR sorrounded by at least one space on each side\. * \fBoneline\fR: Prints the summary in a single line\. Fields are separated by a \fB/\fR sorrounded by one space on each side\. |
73 | | -. |
| 49 | +Summarizes the repository and print the output according to the specified style\. Styles: * \fBtabular\fR: Prints the summary in a tabular form having a header in the first line and the values in the second\. Column separator is a \fB|\fR sorrounded by at least one space on each side\. * \fBoneline\fR: Prints the summary in a single line\. Fields are separated by a \fB/\fR sorrounded by one space on each side\. |
74 | 50 | .P |
75 | 51 | Some information like the authors cannot be displayed in this mode\. |
76 | | -. |
77 | 52 | .SH "EXAMPLES" |
78 | 53 | Outputs a repo summary: |
79 | | -. |
80 | 54 | .IP "" 4 |
81 | | -. |
82 | 55 | .nf |
83 | | - |
84 | 56 | $ git summary |
85 | 57 |
|
86 | 58 | project : express |
@@ -110,94 +82,59 @@ authors : |
110 | 82 | 1 ewoudj |
111 | 83 | 1 isaacs |
112 | 84 | 1 Matt Colyer |
113 | | -. |
114 | 85 | .fi |
115 | | -. |
116 | 86 | .IP "" 0 |
117 | | -. |
118 | 87 | .P |
119 | 88 | This command can also take a committish, and will print a summary for the range of commits included in the committish: |
120 | | -. |
121 | 89 | .IP "" 4 |
122 | | -. |
123 | 90 | .nf |
124 | | - |
125 | 91 | $ git summary v42\.\. |
126 | | -. |
127 | 92 | .fi |
128 | | -. |
129 | 93 | .IP "" 0 |
130 | | -. |
131 | 94 | .P |
132 | 95 | Outputs a repo summary by line: |
133 | | -. |
134 | 96 | .IP "" 4 |
135 | | -. |
136 | 97 | .nf |
137 | | - |
138 | 98 | $ git summary \-\-line |
139 | 99 |
|
140 | 100 | project : git\-extras |
141 | 101 | lines : 26820 |
142 | 102 | authors : |
143 | | - \.\.\. |
144 | | -. |
| 103 | + \|\.\|\.\|\. |
145 | 104 | .fi |
146 | | -. |
147 | 105 | .IP "" 0 |
148 | | -. |
149 | 106 | .P |
150 | 107 | Filter with the path: |
151 | | -. |
152 | 108 | .IP "" 4 |
153 | | -. |
154 | 109 | .nf |
155 | | - |
156 | 110 | $ git summary \-\-line bin/ |
157 | 111 |
|
158 | 112 | project : git\-extras |
159 | 113 | lines : 4420 |
160 | 114 | authors : |
161 | | - \.\.\. |
162 | | -. |
| 115 | + \|\.\|\.\|\. |
163 | 116 | .fi |
164 | | -. |
165 | 117 | .IP "" 0 |
166 | | -. |
167 | 118 | .P |
168 | 119 | Tabular summary |
169 | | -. |
170 | 120 | .IP "" 4 |
171 | | -. |
172 | 121 | .nf |
173 | | - |
174 | 122 | $ git summary \-\-output\-style tabular |
175 | 123 | # Repo | Age | Last active | Active on | Commits | Uncommitted | Branch |
176 | 124 | git\-extras | 13 years | 7 hours ago | 807 days | 1703 | 3 | master |
177 | | -. |
178 | 125 | .fi |
179 | | -. |
180 | 126 | .IP "" 0 |
181 | | -. |
182 | 127 | .P |
183 | 128 | Oneline summary |
184 | | -. |
185 | 129 | .IP "" 4 |
186 | | -. |
187 | 130 | .nf |
188 | | - |
189 | 131 | $ git summary \-\-output\-style oneline |
190 | 132 | git\-extras / age: 13 years / last active: 7 hours ago / active on 807 days / commits: 1703 / uncommitted: 3 / branch: master |
191 | | -. |
192 | 133 | .fi |
193 | | -. |
194 | 134 | .IP "" 0 |
195 | | -. |
196 | 135 | .SH "AUTHOR" |
197 | 136 | Written by Tj Holowaychuk <\fItj@vision\-media\.ca\fR> |
198 | | -. |
199 | 137 | .SH "REPORTING BUGS" |
200 | 138 | <\fIhttps://github\.com/tj/git\-extras/issues\fR> |
201 | | -. |
202 | 139 | .SH "SEE ALSO" |
203 | 140 | <\fIhttps://github\.com/tj/git\-extras\fR> |
0 commit comments