/[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.3, Sat Feb 24 21:52:28 2001 UTC revision 1.8, Tue Dec 18 22:50:12 2001 UTC
# Line 1  Line 1 
1  CvsGraph 1.0.1  CvsGraph 1.1.4, 20-Nov-2001
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
# Line 8  Line 8 
8    
9    
10    
11  Notes  New in this version
12  -----  -------------------
13  - I only tested it with:  This version of CvsGraph includes more control over the graphical presentation
14          * RedHat Linux 6.[12] and 7.0  of the boxes drawn to show revisions and branches (notably background colors
15          * cvs-1.10  and shadows). Imagemaps can now generate links to generate diffs. A couple of
16          * rcs-5.7  manual pages has been written for both executable and configuration.
         * gd-1.3 and gd-1.8  
 - CvsGraph generates only gifs for old versions of gd and only png and jpeg for  
   newer version of gd.  
17    
18    
19    
# Line 25  Line 22 
22  Go to a directory of your choice, unpack the package and cd into the newly  Go to a directory of your choice, unpack the package and cd into the newly
23  create directory:  create directory:
24          $ cd /where/ever/you/want          $ cd /where/ever/you/want
25          $ tar xzf cvsgraph-1.0.1.tar.gz          $ tar xzf cvsgraph-1.1.4.tar.gz
26          $ cd cvsgraph-1.0.1          $ cd cvsgraph-1.1.4
   
 Edit the Makefile to suit your needs and run:  
27          $ ./configure          $ ./configure
28          $ make          $ make
29    
# Line 52  Line 47 
47  Do *NOT* execute the program directly from a webserver. Direct execution would  Do *NOT* execute the program directly from a webserver. Direct execution would
48  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
49  normally use. A nice way is to hack the 'cvsweb' package to call CvsGraph.  normally use. A nice way is to hack the 'cvsweb' package to call CvsGraph.
50    There are several scripts and patches available from the CvsGraph homepage (see
51    below for address).
52    
53  To generate an image do something like:  To generate an image do something like:
54          $ 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
55    
56  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
57  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
58  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
59  that the extension of the file ends with ",v".  that the extension of the file ends with ",v".
60    
61  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
62  (no '-o'), then the output is written to standard output.  (no '-o'), then the output is written to standard output.
63    
64    Please read the manual pages cvsgraph(1) and cvsgraph.conf(5) for more
65    information on execution and configuration.
66    
67    
68    
69  Todo  Todo
70  ----  ----
71  - use ImageMagick for better control over what is generated (also multiple  - use ImageMagick for better control over what is generated (also multiple
72    output formats would be possible)    output formats would be possible)
 - find a way to use cvs directly instead of rcs (rlog) without the need for a  
   full checkout of the repository/module  
 - clean up the mess of finding revisions, tags and branches. The main branch  
   does not nessecarily start with revision 1.1  
73  - 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
74    revision-connectors to make place)    revision-connectors to make place)
 - redo the entire code :-) All good programs are written twice (at least). The  
   structure is a real mess, but that is the price for hacking away without a  
   real programming strategy...  
75    
76    
77    

Legend:
Removed from v.1.3  
changed lines
  Added in v.1.8

  ViewVC Help
Powered by ViewVC 1.1.0 with CvsGraph 1.7.0