From 0a818e2cbdcda1598da41824b6f18e1499284de0 Mon Sep 17 00:00:00 2001 From: Sverre Rabbelier Date: Mon, 28 Jul 2008 14:49:28 +0200 Subject: [PATCH] gitstats: Add a description about the diff module This briefly lists the most useful functions it exports, it should later be made to include a more detailed description of what metrics the user should expect this subcommand to contain. --- doc/diff.txt | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 doc/diff.txt diff --git a/doc/diff.txt b/doc/diff.txt new file mode 100644 index 0000000..68cdd5c --- /dev/null +++ b/doc/diff.txt @@ -0,0 +1,24 @@ +syntax: stats.py diff + +The purpose of the diff module is to gather statistics +about diffs, or related to diffs. + +Currently the available metrics in the diff module are the +following: +* Determine whether two commit diffs are equal, optionally + checking whether they are reverts instead. It is also + possible to just look at what lines were changed (and + ignore the actual changes). + +* Find all commits that are reverted by the specified + commit by first retrieving the touched files, and then + examining all the commits that that touch the same files. + +It also defines the following auxillery functions: +* Parse a raw commit diff and store it on a hunk-by-hunk + basis so that later on it can be examined more carefully + by other tools. Line numbers are optionally included so + that one can use those. For example, by comparing all the + added hunks with the deleted hunks of a second commit, + and vise versa, one can check for (partial) reverts. + -- 2.11.4.GIT