git-summary
Summarize git repository information
TLDR
Display data about a Git repository
Display data about a Git repository since a commit-ish
Display data about a Git repository, merging committers using different emails into 1 statistic for each author
Display data about a Git repository, showing the number of lines modified by each contributor
SYNOPSIS
git summary [options] [revision range]
PARAMETERS
--author
Filter commits by author (regex).
--grep
Filter commits by commit message (regex).
--format=[short|medium|long]
Select the format of output (short, medium, long, default medium).
--no-merges
Exclude merge commits from the summary.
[revision range]
Specify a range of commits to summarize. Defaults to all commits.
DESCRIPTION
The `git-summary` command is a utility designed to generate project release summaries using information stored in a Git repository. It parses Git history, extracting commit messages, author details, and other relevant data to create a concise and informative overview of changes between releases or over a specified period. It aims to automate the often tedious process of manually compiling release notes by leveraging the structured commit information inherent in Git workflows.
The command supports various configuration options, allowing users to customize the output format, filter commits based on criteria like author or commit message patterns, and control the level of detail included in the summary. This flexibility makes it suitable for projects with diverse release practices and documentation requirements. Ultimately, `git-summary` helps improve transparency, communication, and efficiency in software development by simplifying the creation and dissemination of release information.
EXIT STATUS
The command exits with a status of 0 if successful, and a non-zero status if an error occurs.
SEE ALSO
git-log(1), git-shortlog(1), git-blame(1)