mirror of
https://github.com/tj/git-extras.git
synced 2026-09-10 15:36:21 -04:00
130 lines
4.7 KiB
Groff
130 lines
4.7 KiB
Groff
.\" generated with Ronn-NG/v0.10.1
|
|
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
|
|
.TH "GIT\-STANDUP" "1" "March 2026" "" "Git Extras"
|
|
.SH "NAME"
|
|
\fBgit\-standup\fR \- Recall the commit history
|
|
.SH "SYNOPSIS"
|
|
\fBgit\-standup\fR [\-a author] [\-w \fIweekstart\-weekend\fR|\-d \fIdays\-ago\fR] [\-m depth] [\-D date format] [\-L] [\-f] [\-B] [\-n number of commits] [\-F \fIgpg|authordate\fR]
|
|
.br
|
|
\fBgit\-standup\fR \-h
|
|
.SH "DESCRIPTION"
|
|
Recall what you did on the last working day \.\.or be nosy and find what someone else did\.
|
|
.SH "OPTIONS"
|
|
\-a author
|
|
.P
|
|
The author of commits\. Use "all" means specifying "all authors"\. Defaults to \fB$(git config user\.name)\fR\.
|
|
.P
|
|
\-m depth
|
|
.P
|
|
The depth of recursive directory search\. Defaults to 1\.
|
|
.P
|
|
\-L
|
|
.P
|
|
Enable the inclusion of symbolic links in recursive directory search\.
|
|
.P
|
|
\-d days\-ago
|
|
.P
|
|
The start of commit history\. Defaults to 1, means "1 days ago"\.
|
|
.P
|
|
\-w \fIweekstart\-weekend\fR
|
|
.P
|
|
Limit the search range to weekdays\. If \fIweekstart\fR and/or \fIweekend\fR are missing they default to Mon and Fri\. If the current day is \fIweekstart\fR, commits made on \fIweekend\fR will be included\. I\.e\. calling \fBgit standup \-w \-\fR on a Monday will include commits made on the last Friday\.
|
|
.P
|
|
\-D relative
|
|
.P
|
|
The date format displayed in commit history\. Defaults to "relative"\.
|
|
.P
|
|
\-h
|
|
.P
|
|
Display help message\.
|
|
.P
|
|
\-f
|
|
.P
|
|
Fetch the latest commits before showing commit history\.
|
|
.P
|
|
The former version of \fBgit standup\fR accepted \fB<author> <since> <until>\fR as options\. This interface is deprecated now, and please avoid to use it!
|
|
.P
|
|
\-B
|
|
.P
|
|
Display the commits in branch groups\.
|
|
.P
|
|
\-n number\-of\-commits
|
|
.P
|
|
Limit the number of commits displayed per group\. By default, the limitation is applied in the repository level\. For example, if you have 3 repositories under the current directory, \fBgit standup \|\.\|\.\|\. \-n 1\fR will show you 3 commits at most\. When \fB\-B\fR is specific, the limitation is applied in the branch level\. For instance, if each of your 3 repositories have 2 branches, \fBgit standup \|\.\|\.\|\. \-B \-n 1\fR will display 6 commits at most\.
|
|
.P
|
|
\-F \fIgpg|authordate\fR
|
|
.P
|
|
Change how the commits are formatted\. Takes an argument, can be specified multiple times\.
|
|
.IP "\(bu" 4
|
|
\fB\-F gpg\fR: Display if commit is GPG signed (G) or not (N)\.
|
|
.IP "\(bu" 4
|
|
\fB\-F authordate\fR: Print the author date instead of the commit date\.
|
|
.IP "" 0
|
|
.SH "GIT CONFIGS"
|
|
You can configure a implicit \-w \fIweekstart\-weekend\fR, which is superseded if \-w or \-d is given on the command line\. Note that the \fIweekstart\-weekend\fR must be specified, they don't have any default values as the \fB\-w\fR flag has\.
|
|
.IP "" 4
|
|
.nf
|
|
$ git config \-\-global git\-extras\.standup\.implicit\-week "Mon\-Fri"
|
|
.fi
|
|
.IP "" 0
|
|
.SH "EXAMPLES"
|
|
This shows your commits since yesterday:
|
|
.IP "" 4
|
|
.nf
|
|
$ git standup
|
|
|
|
a26d1f9 \- add profile hook (69 minutes ago) <spacewander>
|
|
.fi
|
|
.IP "" 0
|
|
.P
|
|
This shows the author's commits since last week:
|
|
.IP "" 4
|
|
.nf
|
|
$ git standup \-a spacewander \-d 7
|
|
|
|
a26d1f9 \- add profile hook (70 minutes ago) <spacewander>
|
|
4e19859 \- fix getTotalSize return value error (6 days ago) <spacewander>
|
|
36da84e \- fix rename over bound (7 days ago) <spacewander>
|
|
8e4182a \- add watermark\.png (7 days ago) <spacewander>
|
|
46fef1d \- use tinyXML to configure (7 days ago) <spacewander>
|
|
.fi
|
|
.IP "" 0
|
|
.P
|
|
If current directory is not a git repo, git\-standup will fetch data from all top\-level git repos under it:
|
|
.IP "" 4
|
|
.nf
|
|
$ cd \.\.
|
|
$ git standup \-a spacewander \-d 7
|
|
|
|
someProject/
|
|
4e19859 \- fix getTotalSize return value error (6 days ago) <spacewander>
|
|
36da84e \- fix rename over bound (7 days ago) <spacewander>
|
|
8e4182a \- add watermark\.png (7 days ago) <spacewander>
|
|
46fef1d \- use tinyXML to configure (7 days ago) <spacewander>
|
|
.fi
|
|
.IP "" 0
|
|
.P
|
|
By specifying the \fB\-B\fR option, git\-standup will group the commits in branches:
|
|
.IP "" 4
|
|
.nf
|
|
$ git standup \-B \-a spacewander \-d 7
|
|
|
|
git\-summary\-cleanup
|
|
f788c78 \- git\-summary: clean up other shellcheck warnings (23 hours ago) <spacewander>
|
|
3e8c3ab \- git\-summary: fix incorrect active days when commits range is given (23 hours ago) <spacewander>
|
|
ff991ac \- git\-summary: remove useless result function\. (23 hours ago) <spacewander>
|
|
203f5b4 \- git\-summary: add \-\-dedup\-by\-email to remove duplicate users (5 days ago) <spacewander>
|
|
|
|
master
|
|
203f5b4 \- git\-summary: add \-\-dedup\-by\-email to remove duplicate users (5 days ago) <spacewander>
|
|
.fi
|
|
.IP "" 0
|
|
.P
|
|
Note that the same commit can be seen in different branches\.
|
|
.SH "AUTHOR"
|
|
Originally from https://github\.com/kamranahmedse/git\-standup
|
|
.SH "REPORTING BUGS"
|
|
<\fIhttps://github\.com/tj/git\-extras/issues\fR>
|
|
.SH "SEE ALSO"
|
|
<\fIhttps://github\.com/tj/git\-extras\fR>
|