YY.MM versioning FTW
[git-chart] / README.md
1 # git-chart
2
3 `git-chart` is a simple Perl script that generates a plot of commits over time
4 for a given repository. This was created as a quick&dirty hack, so expect rough
5 edges and lots of missing features.
6
7 Also note that it was developed independently and bears no relation to [flashcode's
8 gitchar](https://github.com/flashcode/gitchart) program, despite the similarity
9 in name and intent.
10
11 # Usage
12
13         Usage: git chart [options...] [log specs...]
14
15         Creates a chart plotting the distribution over time of the commits
16         specified as <log specs>. By default, commits are grouped by hour, day,
17         week, month or year depending on the time spanned, but this can be
18         controlled by the user.
19
20         Options:
21                 --hourly, --daily, --weekly, --monthly, --yearly:
22                         force a specific commit grouping
23                 --step=<integer>:
24                         force commits to be grouped each <integer> seconds
25                 --gnuplot:
26                         produce a chart with gnuplot (default)
27                 --google:
28                         produce a chart with Google Charts
29                 --chart-height=<integer>:
30                         set the Google Charts height; the width is set
31                         to a 4:3 ratio (default: 100)
32