/[CvsGraph]/cvsgraph/README
ViewVC logotype

Diff of /cvsgraph/README

Parent Directory Parent Directory | Revision Log Revision Log | View Revision Graph Revision Graph | View Patch Patch

revision 1.15, Sat Jul 20 00:48:16 2002 UTC revision 1.25, Sat Aug 14 14:56:18 2004 UTC
# Line 1  Line 1 
1  CvsGraph 1.3.0, 20-Jul-2002  CvsGraph 1.4.2, 16-Jul-2004
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
# Line 10  Line 10 
10    
11  New in this version  New in this version
12  -------------------  -------------------
 - Implement a workaround for browsers that do not understand unordered  
   y-coordinates in the imagemap when generated upside down.  
13    
14  - Fix the slowness of CvsGraph when parsing very large (typically -kb files)  - Add regex method for ignoring tags in the generation of the graph. Old trees
15    by bypassing the parsing of the actual deltatext. On my machine (K6-2/500/256M    are overpolulated and this is a way to reduce it even further. New config
16    it makes a difference of 7.5s vs 0.04s on a 93MByte file, without counting    options tag_ignore, tag_nocase and tag_negate.
17    disk-overhead; with disk-overhead it takes 12.5s).  
18    Downside is that the logentry cannot be expanded if the file is not parsed in  
19    full (see below). Use option parse_logs to enable log-expansions.  
20    Known BUGS
21  - Implemented logentry expansions using %l and %L. You must enable full parsing  ----------
22    (option parse_logs) for this to work.  
23    - The timezone variable does not seem to exist on Mac OSX. I have no clue how
24  - Fixed a possible buffer overflow in the string expansion. However, this is a    to patch this yet.
25    very low-risk overflow, since it will trash the heap and _not_ the stack.    Anyhow, the timezone problem is much worse, because it needs to be calculated
26    Furthermore, you need to pass strings from CGI directly to cvsgraph without    from the revision's commit-time and not the current timezone (Daylight saving
27    any checks to come even close to trash the heap.    must be accounted for at commit's time, not current).
   
 - Fixed a segfault on IRIX in the bsearch calls. These lookups could be called  
   with a NULL pointer and IRIX's libc doesn't like that.  
   
 - Implement left to right and right to left images. The entire tree can now be  
   drawn horizontally when option left_right is set. Using both left_right and  
   upside_down results in right to left images.  
28    
29    
30    
# Line 42  Line 33 
33    
34  create directory:  create directory:
35          $ cd /where/ever/you/want          $ cd /where/ever/you/want
36          $ tar xzf cvsgraph-1.3.0.tar.gz          $ tar xzf cvsgraph-1.4.2.tar.gz
37          $ cd cvsgraph-1.3.0          $ cd cvsgraph-1.4.2
38          $ ./configure          $ ./configure
39          $ make          $ make
40    
# Line 78  Line 69 
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. The easiest way is to get the ViewCVS package from their website  normally use. There are several web-based viewers with CvsGraph support:
73  at http://viewcvs.sourceforge.net and follow the instructions.  
74    - ViewCVS       http://viewcvs.sourceforge.net
75    - CVSweb        http://www.freebsd.org/projects/cvsweb.html
76    - Chora         http://www.horde.org/chora/
77    
 Alternately, you can hack the 'cvsweb' package to call CvsGraph. There are  
 several scripts and patches available from the CvsGraph homepage (see below for  
 address). However, the scripts are no longer maintained because ViewCVS has  
 native support now.  
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.png myfile.c,v          $ cvsgraph -r /home/to/repository -m module -o mygraph.png myfile.c,v
# Line 98  Line 88 
88                          internet as if you were using cvs. The repository files                          internet as if you were using cvs. The repository files
89                          must be on a locally mounted filesystem. However, you                          must be on a locally mounted filesystem. However, you
90                          can use cvsup or rsync to get a repository to your                          can use cvsup or rsync to get a repository to your
91                          local filesystem and make then image from there.                          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.

Legend:
Removed from v.1.15  
changed lines
  Added in v.1.25

  ViewVC Help
Powered by ViewVC 1.1.0 with CvsGraph 1.7.0