| 1 |
CvsGraph 1.1.0 |
CvsGraph 1.5.3, 14-Jun-2005 |
| 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 |
| 5 |
could not find something right away on the web and decided that it was time to |
could not find something right away on the web and decided that it was time to |
| 8 |
|
|
| 9 |
|
|
| 10 |
|
|
| 11 |
Notes |
New in this version |
| 12 |
----- |
------------------- |
| 13 |
- I only tested it with: |
|
| 14 |
* RedHat Linux 6.[12] and 7.0 |
- Fix all numeric author ID |
| 15 |
* cvs-1.10 |
|
| 16 |
* rcs-5.7 |
- Changed acceptable mail policy. See below in this file |
| 17 |
* gd-1.3 and gd-1.8 |
|
| 18 |
- CvsGraph generates only gifs for old versions of gd and only png and jpeg for |
- Fix incomplete parsing of access keyword in rcsfile |
| 19 |
newer version of gd. |
|
| 20 |
|
- Fix missing branch_bgcolor in manpage |
| 21 |
|
|
| 22 |
|
- Fix author names with spaces but not in @ encapsulation |
| 23 |
|
|
| 24 |
|
|
| 25 |
|
|
| 26 |
Compiling |
Compiling |
| 27 |
--------- |
--------- |
| 28 |
Go to a directory of your choice, unpack the package and cd into the newly |
|
| 29 |
create directory: |
create directory: |
| 30 |
$ cd /where/ever/you/want |
$ cd /where/ever/you/want |
| 31 |
$ tar xzf cvsgraph-1.1.0.tar.gz |
$ tar xzf cvsgraph-1.5.3.tar.gz |
| 32 |
$ cd cvsgraph-1.1.0 |
$ cd cvsgraph-1.5.3 |
| 33 |
$ ./configure |
$ ./configure |
| 34 |
$ make |
$ make |
| 35 |
|
|
| 36 |
This should do the trick and you have an executable file 'cvsgraph' in the |
This should do the trick and you have an executable file 'cvsgraph' in the |
| 37 |
current directory. |
current directory. |
| 38 |
|
|
| 39 |
|
NOTE: The GD library is required for CvsGraph to function. Get it from |
| 40 |
|
http://www.boutell.com, compile it and use either --with-gd-lib=DIR |
| 41 |
|
and --with-gd-inc=DIR to specify its location. You might also have |
| 42 |
|
to use --with-z-inc, --with-z-lib and --with-png-inc, --with-png-lib |
| 43 |
|
for gd versions 1.6 and higher. |
| 44 |
|
If you build with static libgd (i.e. libgd.a) and already have |
| 45 |
|
libpng.so and/or libjpeg6b.so (i.e. dynamic), then you might want to |
| 46 |
|
try to trick configure into adding these libs to the tests by adding |
| 47 |
|
commandline options '--with-png-lib=.' and '--with-jpeg-lib=.'. |
| 48 |
|
If you have linked libgd with freetype, then you might also need |
| 49 |
|
either --with-freetype-lib or --with-freetype2-lib. |
| 50 |
|
|
| 51 |
|
There are often precompiled binaries for Linux, FreeBSD, NetBSD and Windows |
| 52 |
|
(and probably other OSes too). Check your local mirror for details. I also have |
| 53 |
|
some links on the homepage for precompiled binaries. Please do not complain to |
| 54 |
|
me about these binaries. |
| 55 |
|
|
| 56 |
|
|
| 57 |
|
|
| 58 |
Installing |
Installing |
| 69 |
---------------- |
---------------- |
| 70 |
Do *NOT* execute the program directly from a webserver. Direct execution would |
Do *NOT* execute the program directly from a webserver. Direct execution would |
| 71 |
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 |
| 72 |
normally use. A nice way is to hack the 'cvsweb' package to call CvsGraph. |
normally use. There are several web-based viewers with CvsGraph support: |
| 73 |
|
|
| 74 |
|
- ViewCVS http://viewcvs.sourceforge.net |
| 75 |
|
- CVSweb http://www.freebsd.org/projects/cvsweb.html |
| 76 |
|
- Chora http://www.horde.org/chora/ |
| 77 |
|
|
| 78 |
|
|
| 79 |
To generate an image do something like: |
To generate an image do something like: |
| 80 |
$ cvsgraph -r /home/to/repository -m module -o mygraph.gif myfile.c,v |
$ cvsgraph -r /home/to/repository -m module -o mygraph.png myfile.c,v |
| 81 |
|
|
| 82 |
This generates a revison/branch image of the rcs file 'myfile.c,v' and puts it |
This generates a revison/branch image of the rcs file 'myfile.c,v' and puts it |
| 83 |
into 'mygraph.gif'. The '-r' option is the path to the repository *located and |
into 'mygraph.png'. The '-r' option is the path to the repository *located and |
| 84 |
accessible* on your filesystem. The '-m' is the module in the repository. Note |
accessible* on your filesystem. The '-m' is the module in the repository. Note |
| 85 |
that the extension of the file ends with ",v". |
that the extension of the file ends with ",v". |
| 86 |
|
|
| 87 |
|
Just to make it clear: You cannot make images from a cvs-repository over the |
| 88 |
|
internet as if you were using cvs. The repository files |
| 89 |
|
must be on a locally mounted filesystem. However, you |
| 90 |
|
can use cvsup or rsync to get a repository to your |
| 91 |
|
local filesystem and make then images from there. |
| 92 |
|
|
| 93 |
Type 'cvsgraph -h' to get a full list of options. If the output is not given |
Type 'cvsgraph -h' to get a full list of options. If the output is not given |
| 94 |
(no '-o'), then the output is written to standard output. |
(no '-o'), then the output is written to standard output. |
| 95 |
|
|
| 96 |
|
Please read the manual pages cvsgraph(1) and cvsgraph.conf(5) for more |
| 97 |
|
information on execution and configuration. |
| 98 |
|
|
| 99 |
|
|
| 100 |
|
|
| 101 |
|
Contributed code |
| 102 |
|
---------------- |
| 103 |
|
- contrib/automatic_documentation: |
| 104 |
|
If you are interested in tag-management with respect to the correct branch |
| 105 |
|
information, then I suggest that you take a look at the contribution from |
| 106 |
|
Henrik Carlqvist. He submitted some server-side scripts that can manage tags |
| 107 |
|
in a better fashion than cvs on its own. |
| 108 |
|
|
| 109 |
|
|
| 110 |
|
|
| 111 |
Todo |
Todo |
| 112 |
---- |
---- |
|
- use ImageMagick for better control over what is generated (also multiple |
|
|
output formats would be possible) |
|
| 113 |
- 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 |
| 114 |
revision-connectors to make place) |
revision-connectors to make place). A start is made, but this is not very |
| 115 |
- redo the entire code :-) All good programs are written twice (at least). The |
functional yet. |
|
structure is a real mess, but that is the price for hacking away without a |
|
|
real programming strategy... |
|
| 116 |
|
|
| 117 |
|
|
| 118 |
|
|
| 119 |
License |
License |
| 120 |
------- |
------- |
| 121 |
CvsGraph is distributed under GNU GPL v2. See 'LICENCE' for more information. |
CvsGraph is distributed under GNU GPL v2. See 'LICENSE' for more information. |
| 122 |
|
|
| 123 |
|
|
| 124 |
|
|
| 127 |
HomePage: http://www.akhphd.au.dk/~bertho/cvsgraph |
HomePage: http://www.akhphd.au.dk/~bertho/cvsgraph |
| 128 |
E-mail: cvsgraph@akhphd.au.dk |
E-mail: cvsgraph@akhphd.au.dk |
| 129 |
|
|
| 130 |
|
|
| 131 |
|
|
| 132 |
|
Mailnote |
| 133 |
|
-------- |
| 134 |
|
As of 20 August 2005, if you send me an email with a contained or attached |
| 135 |
|
disclaimer that includes one or more of the following items: |
| 136 |
|
|
| 137 |
|
* legal notice or threat(s) |
| 138 |
|
* disclosure restriction(s) |
| 139 |
|
* forward restriction(s) |
| 140 |
|
* "intended recipient" nonsense |
| 141 |
|
|
| 142 |
|
Then you automatically agree to pay me a license fee of DKK 1000,- for using my |
| 143 |
|
email address and a DKK 250,- fee for wasting my time on reading it. |
| 144 |
|
|
| 145 |
Greetings Bertho |
Greetings Bertho |
| 146 |
|
|
Parent Directory
| 
Revision Log
| 
Revision Graph
| 
Patch