git-series - Linux

Overview

git-series is a tool for managing and submitting series of Git commits as patches to a remote repository. It simplifies the process of creating and updating a series of related commits and allows for easy submission and management of multiple patches simultaneously.

Syntax

git series [--debug] [--push] [--rebased-as-parent]
               [--wip] [--compose-args] [--compose-file]
               [--summary] [--non-empty-summary]
               [--include-branch] [--include-tag]
               [--tag-args] [--tag-file]
               [--allow-empty] [--check] [--ignore-edit]
               [--interactive] [--ignore-uncommitted]
               [--no-signoff] [--signoff] [--gpg-sign]
               [--name] [--next-name] [--mailmap]
               [--base] [--base-boundary] [--base-ref]
               [--series-boundary] [--head-boundary]
               [--head] [--head-boundary-series-prefix]
               [--cc] [--cover-letter]
               [--from] [--to] [--by] [--edit-header]
               [--compose] [--compose-hook]
               [--detach] [--no-detach] [--reintegrate]
               [--fetch] [--rebase] [--push-branch]
               [--apply] [--split] [--patch-title]
               [--prefix] [--extra-cmdline] [--path]
               [--rev-list-args] [--fixes] [--reviewers]
               [--skip-review] [--skip-wiki]
               [--verbose] [--quiet]
               [--no-strip] [--assume-unchanged] [--set-upstream]
               [--no-set-upstream] [--cem] [--issue] [--stable-fix]
               [--no-stable-fix] [--atomic] [--dry-run]
               [--update-only] [--no-update-only]
               [--include-merges] [--ignore-merges]
               [--date-order] [--no-date-order]
               [--auto-cc] [--no-auto-cc]
               [--no-verify-push] [--check-patch]
               [--amend] [--edit-patch] [--edit-cover-letter]
               [--fetch-series-ref] [--only-set-fields]
               [--set-fields] [--set-series-status]
               [--set-comment] [--set-upstream-option]
               [--verify-git-version] [--max-uncommitted]
               [--send-empty] [--series-list]
               [<series>]

Options/Flags

–debug: Print debugging information.
–push: Push the series to the remote repository.
–rebased-as-parent: Add a "Rebased-As-Parent" tag to the series.
–wip: Mark the series as a work in progress.
–compose-args and –compose-file: Specify additional arguments or a file to be passed to the compose hook.
–summary and –non-empty-summary: Create a summary of the series.
–include-branch and –include-tag: Include branch or tag information in the series.
–tag-args and –tag-file: Specify additional arguments or a file to be passed to the tag command.
–allow-empty: Allow empty series.
–check: Check the series for errors.
–ignore-edit: Ignore changes to the series description.
–interactive: Enter interactive mode.
–ignore-uncommitted: Ignore uncommitted changes when checking for errors.
–no-signoff: Do not add a Signed-off-by line to the series.
–signoff: Add a Signed-off-by line to the series.
–gpg-sign: GPG-sign the series.
–name, –next-name: Specify the name or next name of the series.
–mailmap: Specify a mailmap file.
–base, –base-boundary, –base-ref: Specify the base commit, boundary commit, or reference for the series.
–series-boundary, –head-boundary: Specify the series boundary or head boundary for the series.
–head, –head-boundary-series-prefix: Specify the head commit or head boundary series prefix for the series.
–cc: Specify additional recipients to CC.
–cover-letter: Specify a cover letter file.
–from, –to: Specify the from and to addresses for the series.
–by: Specify the author of the series.
–edit-header: Edit the series header.
–compose: Compose the series.
–compose-hook: Specify a hook to run when composing the series.
–detach: Detach the series after applying it.
–no-detach: Do not detach the series after applying it.
–reintegrate: Reintegrate the series after applying it.
–fetch: Fetch the series from the remote repository.
–rebase: Rebase the series onto the current branch.
–push-branch: Push the series to a new branch in the remote repository.
–apply: Apply the series to the current branch.
–split: Split the series into individual patches.
–patch-title: Specify the title for the patch files.
–prefix: Specify a prefix for the patch files.
–extra-cmdline: Specify additional command-line arguments.
–path: Specify a path to the series directory.
–rev-list-args: Specify additional arguments to the rev-list command.
–fixes: Specify a list of issue IDs that the series fixes.
–reviewers: Specify a list of reviewers for the series.
–skip-review: Skip the review process.
–skip-wiki: Skip updating the wiki.
–verbose: Enable verbose output.
–quiet: Enable quiet output.
–no-strip: Do not strip whitespace from the series description.
–assume-unchanged: Assume that all files in the series are unchanged.
–set-upstream: Set upstream for the series.
–no-set-upstream: Do not set upstream for the series.
–cem: Create a Change-Id for the series.
–issue: Specify an issue ID for the series.
–stable-fix: Mark the series as a stable fix.
–no-stable-fix: Do not mark the series as a stable fix.
–atomic: Apply the series as an atomic unit.
–dry-run: Perform a dry run of the series application.
–update-only: Only update the series, do not apply it.
–no-update-only: Apply the series, do not only update it.
–include-merges: Include merges in the series.
–ignore-merges: Ignore merges in the series.
–date-order: Order the series by date.
–no-date-order: Do not order the series by date.
–auto-cc: Automatically CC maintainers of modified files.
–no-auto-cc: Do not automatically CC maintainers of modified files.
–no-verify-push: Do not verify the status of the remote repository before pushing.
–check-patch: Check the series for errors using check-patch.
–amend: Amend the series to the current branch.
–edit-patch: Edit the specified patch in the series.
–edit-cover-letter: Edit the series cover letter.
–fetch-series-ref: Fetch the series reference from the remote repository.
–only-set-fields: Only set the specified fields in the series.
–set-fields: Set the specified fields in the series.
–set-series-status: Set the series status.
–set-comment: Set the series comment.
–set-upstream-option: Set the upstream option for the series.
–verify-git-version: Verify that the current Git version is compatible with git-series.
–max-uncommitted: Specify the maximum number of uncommitted changes to allow.
–send-empty: Send an empty series.
–series-list: List available series.
: The name of the series to operate on.

Examples

Create a new series:

git series init my-series

Add a commit to the series:

git series add my-patch

Submit the series:

git series submit my