1 |
CvsGraph 1.1.4, 19-Dec-2001 |
CvsGraph 1.2.0, 18-Feb-2002 |
2 |
=========================== |
=========================== |
3 |
CvsGraph creates a graphic representation of the revisions and branches in a |
CvsGraph creates a graphic representation of the revisions and branches in a |
4 |
cvs/rcs repository. CvsGraph is inspired on the 'graph'-option from WinCVS. I |
cvs/rcs repository. CvsGraph is inspired on the 'graph'-option from WinCVS. I |
20 |
|
|
21 |
- You can now instruct CvsGraph to ommit all revisions that are not tagged. This |
- You can now instruct CvsGraph to ommit all revisions that are not tagged. This |
22 |
is highly usefull for very large trees/trunks to reduce the produced image |
is highly usefull for very large trees/trunks to reduce the produced image |
23 |
size. Note that the first and the last revision in a trunk never are hidden. |
size. Note that the first and the last revision in a trunk are not hidden. |
24 |
A new configuration option 'strip_untagged' with boolean argument enables this |
A new configuration option 'strip_untagged' with boolean argument enables this |
25 |
feature. Alternatively, the command-line provides option '-s' wich negates the |
feature. Alternatively, the command-line provides option '-s' wich negates the |
26 |
value set in the configuration file. |
value set in the configuration file. You can also strip the first revision if |
27 |
|
it is untagged using '-S' and/or strip_first_rev. |
28 |
|
|
29 |
- The boxes to identify the branches can now be drawn on both sides of the trunk. |
- The boxes to identify the branches can now be drawn on both sides of the trunk. |
30 |
Configuration option 'branch_dupbox' with boolean argument activates this |
Configuration option 'branch_dupbox' with boolean argument activates this |
31 |
feature, which is usefull when the tree is drawn upside-down.The command-line |
feature, which is usefull when the tree is drawn upside-down.The command-line |
32 |
option '-b' negated the configured value. |
option '-b' negated the configured value. |
33 |
|
|
34 |
|
- Configuration no longer requires a configuration file. All options can now be |
35 |
|
entered on the commandline using '-O'. CvsGraph will still read the |
36 |
|
configuration file if one is avaliable, but it is no longer an error if none |
37 |
|
is found. |
38 |
|
|
39 |
|
- If no file is entered on the command-line, then the input is taken from |
40 |
|
standard input, like all decent *nix programs. |
41 |
|
|
42 |
- ViewCVS (http://viewcvs.sourceforge.net) is now officially supporting the use |
- ViewCVS (http://viewcvs.sourceforge.net) is now officially supporting the use |
43 |
of CvsGraph in their code as of version 0.8. So, no bad hacks needed anymore |
of CvsGraph in their code as of version 0.8. So, no bad hacks needed anymore |
44 |
to get it working, and it always looks nice :-) |
to get it working, and it always looks nice :-) |
45 |
|
|
46 |
|
- Implemented string drawing using freetype interface of libgd. It looks very |
47 |
|
nice, but it is significantly slower than gd's standard bitmap fonts. Extra |
48 |
|
configuration parameters *_ttfont and *_ttsize set font and size. Option |
49 |
|
use_ttf enables ttf rendering. Note that gd's bitmap fonts are used as a |
50 |
|
fallback in case where the ttfont contains errors or is not found. |
51 |
|
|
52 |
|
- The branch tag color and font can now be set separately using branch_tag_* |
53 |
|
configuration options. |
54 |
|
|
55 |
|
- It is now possible to draw the connector lines between the boxes thicker |
56 |
|
by setting thick_lines to something else than 1. Maximum thickness is |
57 |
|
limited to lines of 11 pixels wide. |
58 |
|
|
59 |
|
|
60 |
|
|
61 |
Compiling |
Compiling |
62 |
--------- |
--------- |
63 |
|
|
64 |
create directory: |
create directory: |
65 |
$ cd /where/ever/you/want |
$ cd /where/ever/you/want |
66 |
$ tar xzf cvsgraph-1.1.4.tar.gz |
$ tar xzf cvsgraph-1.2.0.tar.gz |
67 |
$ cd cvsgraph-1.1.4 |
$ cd cvsgraph-1.2.0 |
68 |
$ ./configure |
$ ./configure |
69 |
$ make |
$ make |
70 |
|
|
80 |
libpng.so and/or libjpeg6b.so (i.e. dynamic), then you might want to |
libpng.so and/or libjpeg6b.so (i.e. dynamic), then you might want to |
81 |
try to trick configure into adding these libs to the tests by adding |
try to trick configure into adding these libs to the tests by adding |
82 |
commandline options '--with-png-lib=.' and '--with-jpeg-lib=.'. |
commandline options '--with-png-lib=.' and '--with-jpeg-lib=.'. |
83 |
|
If you have linked libgd with freetype, then you might also need |
84 |
|
either --with-freetype-lib or --with-freetype2-lib. |
85 |
|
|
86 |
|
|
87 |
|
|
88 |
Installing |
Installing |
99 |
---------------- |
---------------- |
100 |
Do *NOT* execute the program directly from a webserver. Direct execution would |
Do *NOT* execute the program directly from a webserver. Direct execution would |
101 |
be very insecure. Make a wrapper cgi-script in php, perl, or whatever you |
be very insecure. Make a wrapper cgi-script in php, perl, or whatever you |
102 |
normally use. A nice way is to hack the 'cvsweb' package to call CvsGraph. |
normally use. The easiest way is to get the ViewCVS package from their website |
103 |
There are several scripts and patches available from the CvsGraph homepage (see |
at http://viewcvs.sourceforge.net and follow the instructions. |
104 |
below for address). |
|
105 |
|
Alternately, you can hack the 'cvsweb' package to call CvsGraph. There are |
106 |
|
several scripts and patches available from the CvsGraph homepage (see below for |
107 |
|
address). However, the scripts are no longer maintained because ViewCVS has |
108 |
|
native support now. |
109 |
|
|
110 |
To generate an image do something like: |
To generate an image do something like: |
111 |
$ cvsgraph -r /home/to/repository -m module -o mygraph.png myfile.c,v |
$ cvsgraph -r /home/to/repository -m module -o mygraph.png myfile.c,v |
132 |
Todo |
Todo |
133 |
---- |
---- |
134 |
- do a better job in making a layout (auto moving branches and rubber banding |
- do a better job in making a layout (auto moving branches and rubber banding |
135 |
revision-connectors to make place) |
revision-connectors to make place). A start is made, but this is not very |
136 |
|
functional yet. |
137 |
|
|
138 |
|
- draw only a part or parts of the tree. |
139 |
|
|
140 |
|
|
141 |
|
|