git-big-picture(1)

Visualize Git repositories

Section 1 git-big-picture bookworm source

Description

GIT-BIG-PICTURE

NAME

git-big-picture - Visualize Git repositories

SYNOPSIS

git-big-picture OPTIONS [REPOSITORY]

DESCRIPTION

Visualize Git repositories

positional arguments:

REPOSITORY

path to the Git working directory (default: current directory)

optional arguments:

-h, --help

show this help message and exit

--version

show program’s version number and exit

--pstats FILE

run cProfile profiler writing pstats output to FILE

-d, --debug

activate debug output

output options:

Options to control output and format
-f
FMT, --format FMT

set output format [svg, png, ps, pdf, ...]

--history-direction {downwards,leftwards,rightwards,upwards}

enforce a specific direction of history on Graphviz (default: rightwards)

--simplify

remove edges implied by transitivity using Graphviz filter "tred" (default: do not remove implied edges)

-g, --graphviz

output lines suitable as input for dot/graphviz

-G, --no-graphviz

disable dot/graphviz output

-p, --processed

output the dot processed, binary data

-P, --no-processed

disable binary output

-v CMD, --viewer CMD

write image to tempfile and start specified viewer

-V, --no-viewer

disable starting viewer

-o FILE, --outfile FILE

write image to specified file

-O, --no-outfile

disable writing image to file

-w SECONDS, --wait 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

filter options:

Options to control commit/ref selection
-a
, --all

include all commits

-b, --branches

show commits pointed to by branches

-B, --no-branches

do not show commits pointed to by branches

-t, --tags

show commits pointed to by tags

-T, --no-tags

do not show commits pointed to by tags

-r, --roots

show root commits

-R, --no-roots

do not show root commits

-m, --merges

include merge commits

-M, --no-merges

do not include merge commits

-i, --bifurcations

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

-I, --no-bifurcations

do not include bifurcation commits

-c, --commit-messages

include commit messages on labels

-C, --no-commit-messages

do not include commit messages on labels

EPILOG

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!