.TH GIT-BIG-PICTURE "1" "January 2021" "git-big-picture" "Git Manual"
.SH NAME
git-big-picture \- visualize git repositories
.SH SYNOPSIS
.B git-big-picture
\fI\,OPTIONS \/\fR[\fI\,<repo-directory>\/\fR]
.SH OPTIONS
.SS Positional Arguments:
.TP
\fB<repo-directory>\fR
path to the Git working directory
(default: current directory)
.SS Optional Arguments:
.TP
\fB\-\-version\fR
show program's version number and exit
.TP
\fB\-h\fR, \fB\-\-help\fR
show this help message and exit
.TP
\fB\-\-pstats\fR=\fI\,FILE\/\fR
run cProfile profiler writing pstats output to FILE
.TP
\fB\-d\fR, \fB\-\-debug\fR
activate debug output
.IP
.SS Output Options:
Options to control output and format
.TP
\fB\-f\fR FMT, \fB\-\-format\fR=\fI\,FMT\/\fR
set output format [svg, png, ps, pdf, ...]
.TP
\fB\-\-history\-direction\fR {downwards,leftwards,rightwards,upwards}
enforce a specific direction of history on Graphviz
(default: upwards)
.TP
\fB\-g\fR, \fB\-\-graphviz\fR
output lines suitable as input for dot/graphviz
.TP
\fB\-G\fR, \fB\-\-no\-graphviz\fR
disable dot/graphviz output
.TP
\fB\-p\fR, \fB\-\-processed\fR
output the dot processed, binary data
.TP
\fB\-P\fR, \fB\-\-no\-processed\fR
disable binary output
.TP
\fB\-v\fR CMD, \fB\-\-viewer\fR=\fI\,CMD\/\fR
write image to tempfile and start specified viewer
.TP
\fB\-V\fR, \fB\-\-no\-viewer\fR
disable starting viewer
.TP
\fB\-o\fR FILE, \fB\-\-outfile\fR=\fI\,FILE\/\fR
write image to specified file
.TP
\fB\-O\fR, \fB\-\-no\-outfile\fR
disable writing image to file
.TP
\fB\-w\fR SECONDS, \fB\-\-wait\fR SECONDS
wait for SECONDS seconds before deleting the temporary
file that is opened using the viewer command (default:
2.0 seconds); this helps e.g. with viewer commands that
tell other running processes to open that file on their
behalf, to then shut themselves down
.IP
.SS Filter Options:
Options to control commit/ref selection
.TP
\fB\-a\fR, \fB\-\-all\fR
include all commits
.TP
\fB\-b\fR, \fB\-\-branches\fR
show commits pointed to by branches
.TP
\fB\-B\fR, \fB\-\-no\-branches\fR
do not show commits pointed to by branches
.TP
\fB\-t\fR, \fB\-\-tags\fR
show commits pointed to by tags
.TP
\fB\-T\fR, \fB\-\-no\-tags\fR
do not show commits pointed to by tags
.TP
\fB\-r\fR, \fB\-\-roots\fR
show root commits
.TP
\fB\-R\fR, \fB\-\-no\-roots\fR
do not show root commits
.TP
\fB\-m\fR, \fB\-\-merges\fR
include merge commits
.TP
\fB\-M\fR, \fB\-\-no\-merges\fR
do not include merge commits
.TP
\fB\-i\fR, \fB\-\-bifurcations\fR
include bifurcation commits
.TP
\fB\-I\fR, \fB\-\-no\-bifurcations\fR
do not include bifurcation commits
.TP
\fB\-c\fR, \fB\-\-commit\-messages\fR
include commit messages on labels
.TP
\fB\-C\fR, \fB\-\-no\-commit\-messages\fR
do not include commit messages on labels