.\" DO NOT MODIFY THIS FILE!  It was generated by help2man.
.TH GIT-BIG-PICTURE "1" "March 2024" "git-big-picture 1.3.0" "User Commands"
.SH NAME
git-big-picture \- Visualize Git repositories
.SH SYNOPSIS

.B git\-big\-picture
OPTIONS [REPOSITORY]
.SH DESCRIPTION
.PP
Visualize Git repositories
.SS "positional arguments:"
.TP
REPOSITORY
path to the Git working directory
(default: current directory)
.SS "options:"
.TP
\fB\-h\fR, \fB\-\-help\fR
show this help message and exit
.TP
\fB\-\-version\fR
show program's version number and exit
.TP
\fB\-\-pstats\fR FILE
run cProfile profiler writing pstats output to FILE
.TP
\fB\-d\fR, \fB\-\-debug\fR
activate debug output
.SS "output options:"
.PP
Options to control output and format
.TP
\fB\-f\fR FMT, \fB\-\-format\fR FMT
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: rightwards)
.TP
\fB\-\-simplify\fR
remove edges implied by transitivity using Graphviz
filter "tred" (default: do not remove implied edges)
.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 CMD
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 FILE
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
.SS "filter options:"
.PP
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; a bifurcation commit is a
commit that is a parent to more than one other commits,
i.e. it marks the point where one or more new branches
came to life; bifurcation commits can also be thought of
as the counterpart of merge 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
.PP
.SH EPILOG

.B git\-big\-picture
is software libre, licensed under the GPL v3 or later license.
Please report bugs at https://github.com/git\-big\-picture/git\-big\-picture/issues — thank you!