GetOptions(\my %opt,
'debug!',
+ '', # stdin
'count|c!',
'simplify|s:s',
'ignore-case|i!',
'help|man|?' => sub { Getopt::Long::HelpMessage(-verbose => 2) },
) or exit 129;
+my $inputstream = $opt{''} ? \*ARGV : eval {
+ require Git;
+ Git::command_output_pipe('log', '-z', '--pretty=format:%b', @ARGV);
+} || die "Automatic git log failed: $@";
+
local $| = 1;
local $/ = "\0";
my (%headercount, @headercache);
-while (readline) {
+while (readline $inputstream) {
s/^([0-9a-f]{4,40})\n//m and
my $hash = $1;
=head1 SYNOPSIS
-F<git> log --pretty=%b%x00 | F<git-grep-footer> [OPTIONS]
+F<git-grep-footer> [OPTIONS] [-- <git log options>]
+
+F<git> log -z --pretty=format:%b | F<git-grep-footer> [OPTIONS] -
=head1 DESCRIPTION
=back
+=head1 EXAMPLES
+
+=over
+
+=item git-grep-footer --grep=^ack v2.6.32..v2.6.33
+
+Search for I<Acked-by> lines for version I<v2.6.33>.
+Append C<-uin> to skip reoccurrences.
+
+=item git-grep-footer -u --grep=junio
+
+Show distinct lines mentioning a specific author.
+
+=item git-grep-footer -c --simplify --grep=^si
+
+Compare various capitalisations and (mis)spellings of signoffs.
+
+=item git-grep-footer -c --simplify=all -i | sort -n -r | head -n10
+
+List the ten most frequently used attribute names.
+
+=item git-grep-footer -n2 -i -s -- --reverse
+
+The earliest two usages of each distinct identifier.
+
+=back
+
=head1 AUTHOR
Mischa POSLAWSKY <perl@shiar.org>
=head1 LICENSE
-Copyright. All rights reserved.
+This software is free software;
+you can redistribute and/or modify it under the terms of the GNU GPL
+version 2 or later.