Skip to content

feature: add --describe support for git-describe options - #1436

Open
iam-TJ wants to merge 1 commit into
jonas:masterfrom
iam-TJ:feature-support_git-describe_options
Open

feature: add --describe support for git-describe options#1436
iam-TJ wants to merge 1 commit into
jonas:masterfrom
iam-TJ:feature-support_git-describe_options

Conversation

@iam-TJ

@iam-TJ iam-TJ commented Jul 10, 2026

Copy link
Copy Markdown

In my case - working with multiple Linux kernel remote trees - the default Ref: reported for a commit isn't helpful since it shows a prior tag rather than the containing tag.

In almost all cases I need to see the equivalent of:

git describe --contains

and additionally need to filter the returned tags with e.g:

--exclude 'next-*'

or

--match ...

This feature adds the command-line option --describe= that accepts additional git-describe options and appends them to the args passed to git-describe.

An example usage:

tig --describe="--exclude 'next-*' --contains" v6.18..v6.19 drivers/iommu/intel

Closes: #1435

In my case - working with multiple Linux kernel remote trees -
the default Ref: reported for a commit isn't helpful since it
shows a prior tag rather than the containing tag.

In almost all cases I need to see the equivalent of:

  git describe --contains

and additionally need to filter the returned tags with e.g:

  --exclude 'next-*'

or

  --match ...

This feature adds the command-line option --describe= that accepts
additional git-describe options and appends them to the args passed to
git-describe.

An example usage:

tig --describe="--exclude 'next-*' --contains" v6.18..v6.19 drivers/iommu/intel

Signed-off-by: Tj <hacker@iam.tj>
@iam-TJ
iam-TJ force-pushed the feature-support_git-describe_options branch from 08ebd3d to 6d5f5ce Compare July 10, 2026 15:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add ability to use git-describe options to influence Refs

1 participant