mirror of
https://github.com/tj/git-extras.git
synced 2026-09-10 15:36:21 -04:00
137 lines
4.2 KiB
Markdown
137 lines
4.2 KiB
Markdown
git-standup(1) -- Recall the commit history
|
|
=================================
|
|
|
|
## SYNOPSIS
|
|
|
|
`git-standup` [-a author] [-w <weekstart-weekend>|-d <days-ago>] [-m depth] [-D date format] [-L] [-f] [-B] [-n number of commits] [-F <gpg|authordate>]
|
|
`git-standup` -h
|
|
|
|
## DESCRIPTION
|
|
|
|
Recall what you did on the last working day ..or be nosy and find what someone else did.
|
|
|
|
## OPTIONS
|
|
|
|
-a author
|
|
|
|
The author of commits. Use "all" means specifying "all authors".
|
|
Defaults to `$(git config user.name)`.
|
|
|
|
-m depth
|
|
|
|
The depth of recursive directory search. Defaults to 1.
|
|
|
|
-L
|
|
|
|
Enable the inclusion of symbolic links in recursive directory search.
|
|
|
|
-d days-ago
|
|
|
|
The start of commit history. Defaults to 1, means "1 days ago".
|
|
|
|
-w <weekstart-weekend>
|
|
|
|
Limit the search range to weekdays.
|
|
If <weekstart> and/or <weekend> are missing they default to Mon and Fri.
|
|
If the current day is <weekstart>, commits made on <weekend> will be included.
|
|
I.e. calling `git standup -w -` on a Monday will include commits made on the last Friday.
|
|
|
|
-D relative
|
|
|
|
The date format displayed in commit history. Defaults to "relative".
|
|
|
|
-h
|
|
|
|
Display help message.
|
|
|
|
-f
|
|
|
|
Fetch the latest commits before showing commit history.
|
|
|
|
The former version of `git standup` accepted `<author> <since> <until>` as options.
|
|
This interface is deprecated now, and please avoid to use it!
|
|
|
|
-B
|
|
|
|
Display the commits in branch groups.
|
|
|
|
-n number-of-commits
|
|
|
|
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, `git standup ... -n 1` will
|
|
show you 3 commits at most.
|
|
When `-B` is specific, the limitation is applied in the branch level. For instance,
|
|
if each of your 3 repositories have 2 branches, `git standup ... -B -n 1` will
|
|
display 6 commits at most.
|
|
|
|
-F <gpg|authordate>
|
|
|
|
Change how the commits are formatted. Takes an argument, can be specified multiple times.
|
|
|
|
* `-F gpg`: Display if commit is GPG signed (G) or not (N).
|
|
* `-F authordate`: Print the author date instead of the commit date.
|
|
|
|
## GIT CONFIGS
|
|
|
|
You can configure a implicit -w <weekstart-weekend>, which is superseded if -w or -d is given on the command line.
|
|
Note that the <weekstart-weekend> must be specified, they don't have any default values as the `-w` flag has.
|
|
|
|
$ git config --global git-extras.standup.implicit-week "Mon-Fri"
|
|
|
|
## EXAMPLES
|
|
|
|
This shows your commits since yesterday:
|
|
|
|
$ git standup
|
|
|
|
a26d1f9 - add profile hook (69 minutes ago) <spacewander>
|
|
|
|
This shows the author's commits since last week:
|
|
|
|
$ 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>
|
|
|
|
If current directory is not a git repo, git-standup will fetch data from all top-level git repos under it:
|
|
|
|
$ 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>
|
|
|
|
By specifying the `-B` option, git-standuo will group the commits in branches:
|
|
|
|
$ 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>
|
|
|
|
Note that the same commit can be seen in different branches.
|
|
|
|
## AUTHOR
|
|
|
|
Originally from https://github.com/kamranahmedse/git-standup
|
|
|
|
## REPORTING BUGS
|
|
|
|
<<https://github.com/tj/git-extras/issues>>
|
|
|
|
## SEE ALSO
|
|
|
|
<<https://github.com/tj/git-extras>>
|