gitstats: Add a description about the index module
authorSverre Rabbelier <sverre@rabbelier.nl>
Mon, 28 Jul 2008 12:49:28 +0000 (28 14:49 +0200)
committerSverre Rabbelier <sverre@rabbelier.nl>
Mon, 28 Jul 2008 20:51:03 +0000 (28 22:51 +0200)
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/index.txt [new file with mode: 0644]

diff --git a/doc/index.txt b/doc/index.txt
new file mode 100644 (file)
index 0000000..66c79eb
--- /dev/null
@@ -0,0 +1,19 @@
+syntax: stats.py index <options>
+
+The purpose of the index module is to gather statistics
+about the index, or related to the index.
+
+Currently the available metrics in the index module are the
+following:
+* List all the commits that touch the same files as the
+  staged files. This can be useful to find out which commit
+  introduced the bug fixed in this commit (by piping the
+  output of this method to one that looks at which lines
+  were touched for example).
+
+It also defines the following auxillery functions:
+* Get all the staged changes (optionally ignoring newly
+  added files). This is used internally to find all the
+  commits that touched the same files as those that are
+  currently staged.
+