/[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.20, Fri Mar 14 01:38:39 2003 UTC revision 1.26, Sun Aug 15 16:58:22 2004 UTC
# Line 1  Line 1 
1  CvsGraph 1.3.0, 20-Jul-2002  CvsGraph 1.5.0, 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  -------------------  -------------------
 - Fix warnings in readconf on some 'older' compiler systems.  
13    
14  - Implement new option to generate proper maps for different levels of HTML.  - Add regex method for ignoring tags in the generation of the graph. Old trees
15    The option -x[34x] determines HTML 3.x (default), HTML 4.x or XHTML style    are overpolulated and this is a way to reduce it even further. New config
16    maps.    options tag_ignore, tag_nocase and tag_negate.
17    
18  - Implement a scheme to visualize merges based on tag names. If tags are  - Added drawing of partial trees. You now can select a subtree based on a
19    consistently named at the mergepoint and the destination, then these points    revision number, branch number or symbolic tag to show only that part of the
20    can be detected using regular expressions. Several new configuration    tree. New config option branch_subtree selects which part is shown. If the
21    options, merge_*, describe the tags.    subtree is empty, then the whole tree is shown.
22    
23  - Implemented HTMLizing of expansion with %(...%). This prevents a possible  - Most error and warning messages are now displayed in the graph, instead of
24    cross site scripting exploit when you use '<', '>' or '"' in tagnames.    being written to stderr. This enables you to see an image eventhough errors
25    This is a remote chance (you must be stupid to use these characters in a    might be present. The old method would generate a corrupt image.
26    tagname) but anyway, your system can be under attack.    New configuration options include msg_color and msg_font to control the looks
27      of it. Messages are always printed at the bottom of the image.
28  - Fixed backing up in the lexer. This improves speed slightly because no  
29    rule requires lookahead over one character anymore.  - Fixed a bug in the folding code where subtrees would not fold correctly.
30    
31  - Fixed a bug in the initial placing of left to right displaying.  - Added diff links in the map-generation for detected merges so that you can
32      get the differences in merge-operations. The options map_merge_href and
33  - Half-fixed a bug in the kerning code, where a loop-safeguard was triggered    map_merge_alt must be set accordingly.
34    way too soon (at 100 iterations). This has now been changed to 10000, but  
35    should be dependent on the number of drawable branches, as the function is  
36    _at least_ order O(N^2). However, more analysis is required to ensure  
37    safe guarding under all circumstances.  Known BUGS
38    ----------
39  - Implemented folding of empty branches. Many uses of CVS create many  
40    branches on the same revision but have no commits on them. This occurs  - The timezone variable does not seem to exist on Mac OSX. I have no clue how
41    often with stable files like .cvsignore files and the like. A new    to patch this yet.
42    configuration option branch_fold enables imaging consequtive brances    Anyhow, the timezone problem is much worse, because it needs to be calculated
43    with no commits in the same branch-box. This reduces images by a huge    from the revision's commit-time and not the current timezone (Daylight saving
44    factor (28000x1700 -> 2100x2300, i.e. a factor of 10). It also speeds up    must be accounted for at commit's time, not current).
   drawing considerably. The branch_fold option is *on* by default.  
   
 - Fix duplicate branch-boxes (branch_dupbox=true). No duplicates should be  
   created if there are no commits on a specific branch. There is no reason  
   for having two boxes on top of each other.  
45    
46    
47    
# Line 56  Line 50 
50    
51  create directory:  create directory:
52          $ cd /where/ever/you/want          $ cd /where/ever/you/want
53          $ tar xzf cvsgraph-1.3.0.tar.gz          $ tar xzf cvsgraph-1.5.0.tar.gz
54          $ cd cvsgraph-1.3.0          $ cd cvsgraph-1.5.0
55          $ ./configure          $ ./configure
56          $ make          $ make
57    
# Line 76  Line 70 
70          If you have linked libgd with freetype, then you might also need          If you have linked libgd with freetype, then you might also need
71          either --with-freetype-lib or --with-freetype2-lib.          either --with-freetype-lib or --with-freetype2-lib.
72    
73    There are often precompiled binaries for Linux, FreeBSD, NetBSD and Windows
74    (and probably other OSes too). Check your local mirror for details. I also have
75    some links on the homepage for precompiled binaries. Please do not complain to
76    me about these binaries.
77    
78    
79    
80  Installing  Installing
# Line 92  Line 91 
91  ----------------  ----------------
92  Do *NOT* execute the program directly from a webserver. Direct execution would  Do *NOT* execute the program directly from a webserver. Direct execution would
93  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
94  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:
95  at http://viewcvs.sourceforge.net and follow the instructions.  
96    - ViewCVS       http://viewcvs.sourceforge.net
97    - CVSweb        http://www.freebsd.org/projects/cvsweb.html
98    - Chora         http://www.horde.org/chora/
99    
 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.  
100    
101  To generate an image do something like:  To generate an image do something like:
102          $ 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 128  Line 126 
126    revision-connectors to make place). A start is made, but this is not very    revision-connectors to make place). A start is made, but this is not very
127    functional yet.    functional yet.
128    
 - draw only a part or parts of the tree.  
   
129    
130    
131  License  License

Legend:
Removed from v.1.20  
changed lines
  Added in v.1.26

  ViewVC Help
Powered by ViewVC 1.1.0 with CvsGraph 1.7.0