Permalink
Find file
Fetching contributors…
Cannot retrieve contributors at this time
90 lines (56 sloc) 2.22 KB
= git-line-history(1) =
== NAME ==
git-line-history - Track changes in a line from a file using git
== SYNOPSIS ==
git-line-history file regexp
== DESCRIPTION ==
+git-line-history+ helps to find out which commits have modified a line in
the whole revision history of a single file from a git repository.
This tool was formerly made to retrieve the version changes in a git tree in
order to create tags.
== ARGUMENTS ==
The 2 mandatory arguments are the file on which the research should be
performed, and the regexp to be used to track the line change.
== USAGE ==
=== Version changes ===
To search for all commits that change the version from a python module, this
line could be used:
----
git line-history setup.py version
----
A possible output with all version changes could be something similar to:
----
382f92b58bc64e128bb2f066801b3ab6c6dcff6a: version="1.3d",
24dbec800e5c59ecc3419a92bf778f16cdd7a45d: version="1.3c",
fe46da172abea13c304bb23de671433f65f5da96: version="1.3b",
ff8ba7be2aac3a809a0410ffbb59ddf07e930a2f: version="1.3a",
501934e10a4b1d71c734c5dc2c224161dcdbe96b: version="1.2b",
bf82e0fff633be15c13ae3063daf935b94ec58c5: version="1.2a",
2cfb388181e14cae105d9c2c63e21199539d1872: version="1.1a",
adf625d464a4a7b06241a1b5685c209296740992: version="1.0e",
4050a0b87467797d1aef1887aac6d396b1e6586b: version="1.0d",
648343e2de71a37099eeef62f53a4adf077e2703: version="1.0c",
696f3a72f936038e85245832f5564d9d40ddff9a: version="1.0b",
717178019715c0dcd9b90d53c897f06fa77b42f1: version="1.0a",
----
=== Setting up tags ===
To tag a repository against change sets from the previous example, the
following command could be used:
----
git line-history setup.py version | sed -n \
's/^\([^:]\+\):.*"\([^"]\+\)".*/git tag -m "Version \2" \2 \1/p' \
| sh
----
== SEE ALSO ==
git(1), grep(1), regex(7).
== HISTORY ==
2011/03/26:
First release.
== BUGS ==
No time to include bugs, command actions might seldom lead astray user's
assumption.
== AUTHORS ==
+git-line-history+ is written by Sébastien Gross <seb•ɑƬ•chezwam•ɖɵʈ•org>.
== COPYRIGHT ==
Copyright © 2011 Sébastien Gross <seb•ɑƬ•chezwam•ɖɵʈ•org>.
Relased under WTFPL (http://sam.zoy.org/wtfpl/COPYING[]).