Re: [PATCH v3 9/9] tag.c: implement '--merged' and '--no-merged' options

From: Karthik Nayak <redacted>

Using 'ref-filter' APIs implement the '--merged' and '--no-merged'
options into 'tag.c'. The '--merged' option lets the user to only
list tags merged into the named commit. The '--no-merged' option
lets the user to only list tags not merged into the named commit.
If no object is provided it assumes HEAD as the object.

Add documentation and tests for the same.

Mentored-by: Christian Couder [off-list ref]
Mentored-by: Matthieu Moy [off-list ref]
Signed-off-by: Karthik Nayak <redacted>
---
 Documentation/git-tag.txt | 10 +++++++++-
 builtin/tag.c             |  6 +++++-
 t/t7004-tag.sh            | 27 +++++++++++++++++++++++++++
 3 files changed, 41 insertions(+), 2 deletions(-)

diff --git a/Documentation/git-tag.txt b/Documentation/git-tag.txt
index 16e396c..74ed157 100644
--- a/Documentation/git-tag.txt
+++ b/Documentation/git-tag.txt

@@ -14,7 +14,7 @@ SYNOPSIS
 'git tag' -d <tagname>...
 'git tag' [-n[<num>]] -l [--contains <commit>] [--points-at <object>]
        [--column[=<options>] | --no-column] [--sort=<key>] [--format=<format>]
-       [<pattern>...]
+       [(--merged | --no-merged) [<commit>]] [<pattern>...]

 'git tag' -v <tagname>...

 DESCRIPTION

@@ -169,6 +169,14 @@ This option is only applicable when listing tags without annotation lines.
        `%09` to `\t` (TAB) and `%0a` to `\n` (LF).
        The fields are same as those in `git for-each-ref`.

+--merged [<commit>]::
+       Only list tags whose tips are reachable from the
+       specified commit (HEAD if not specified).
+
+--no-merged [<commit>]::
+       Only list tags whose tips are not reachable from the
+       specified commit (HEAD if not specified).

 CONFIGURATION
 -------------

diff --git a/builtin/tag.c b/builtin/tag.c
index cae113b..0fa1d31 100644
--- a/builtin/tag.c
+++ b/builtin/tag.c

@@ -23,7 +23,7 @@ static const char * const git_tag_usage[] = {
        N_("git tag [-a | -s | -u <key-id>] [-f] [-m <msg> | -F <file>] <tagname> [<head>]"),
        N_("git tag -d <tagname>..."),
        N_("git tag -l [-n[<num>]] [--contains <commit>] [--points-at <object>]"
-               "\n\t\t[<pattern>...]"),
+               "\n\t\t[--merged [<commit>]] [--no-merged [<commit>]] [<pattern>...]"),