ViewVC logotype

Annotate of /cvsgraph/README

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

Revision 1.36 - (show annotations)
Sat Dec 4 02:18:13 2004 UTC (13 years, 11 months ago) by bertho
Branch: MAIN
Changes since 1.35: +2 -0 lines
Fix the configure script to detect gd-2:
  The mystery is solved, I think. The problem seems to be a bug in the GIF
  support of gd-2.0.33. I didn't look into it further because CvsGraph was
  configured to output PNGs and shouldn't have been outputting GIFs in the
  first place. The reason it was outputting GIFs was a bug in CvsGraph's
  configure script which causes CvsGraph to be built without PNG support.
1 CvsGraph 1.5.2, 23-Oct-2004
2 ===========================
3 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
5 could not find something right away on the web and decided that it was time to
6 write a stand-alone version. I might have been doing some double work, but hey,
7 I like a hack.
11 New in this version
12 -------------------
14 - Fix POSIX compliance in timezone handling. Only putenv() is used now.
16 - Fix branch-count when branches get folded.
18 - Fix configure script to detect gd-2 problems (Thanks to Russell Yanofsky)
22 Compiling
23 ---------
25 create directory:
26 $ cd /where/ever/you/want
27 $ tar xzf cvsgraph-1.5.2.tar.gz
28 $ cd cvsgraph-1.5.2
29 $ ./configure
30 $ make
32 This should do the trick and you have an executable file 'cvsgraph' in the
33 current directory.
35 NOTE: The GD library is required for CvsGraph to function. Get it from
36 http://www.boutell.com, compile it and use either --with-gd-lib=DIR
37 and --with-gd-inc=DIR to specify its location. You might also have
38 to use --with-z-inc, --with-z-lib and --with-png-inc, --with-png-lib
39 for gd versions 1.6 and higher.
40 If you build with static libgd (i.e. libgd.a) and already have
41 libpng.so and/or libjpeg6b.so (i.e. dynamic), then you might want to
42 try to trick configure into adding these libs to the tests by adding
43 commandline options '--with-png-lib=.' and '--with-jpeg-lib=.'.
44 If you have linked libgd with freetype, then you might also need
45 either --with-freetype-lib or --with-freetype2-lib.
47 There are often precompiled binaries for Linux, FreeBSD, NetBSD and Windows
48 (and probably other OSes too). Check your local mirror for details. I also have
49 some links on the homepage for precompiled binaries. Please do not complain to
50 me about these binaries.
54 Installing
55 ----------
56 Put the executable file 'cvsgraph' somewhere where you think it should go.
57 Normally this would be "/usr/local/bin" or "/usr/bin". The configuration file
58 ought to be put in "/usr/local/etc" or "/etc". The exact position can be
59 overriden on the commandline anyway. Edit the configuration file to your liking
60 and you should be all set.
64 Running CvsGraph
65 ----------------
66 Do *NOT* execute the program directly from a webserver. Direct execution would
67 be very insecure. Make a wrapper cgi-script in php, perl, or whatever you
68 normally use. There are several web-based viewers with CvsGraph support:
70 - ViewCVS http://viewcvs.sourceforge.net
71 - CVSweb http://www.freebsd.org/projects/cvsweb.html
72 - Chora http://www.horde.org/chora/
75 To generate an image do something like:
76 $ cvsgraph -r /home/to/repository -m module -o mygraph.png myfile.c,v
78 This generates a revison/branch image of the rcs file 'myfile.c,v' and puts it
79 into 'mygraph.png'. The '-r' option is the path to the repository *located and
80 accessible* on your filesystem. The '-m' is the module in the repository. Note
81 that the extension of the file ends with ",v".
83 Just to make it clear: You cannot make images from a cvs-repository over the
84 internet as if you were using cvs. The repository files
85 must be on a locally mounted filesystem. However, you
86 can use cvsup or rsync to get a repository to your
87 local filesystem and make then images from there.
89 Type 'cvsgraph -h' to get a full list of options. If the output is not given
90 (no '-o'), then the output is written to standard output.
92 Please read the manual pages cvsgraph(1) and cvsgraph.conf(5) for more
93 information on execution and configuration.
97 Contributed code
98 ----------------
99 - contrib/automatic_documentation:
100 If you are interested in tag-management with respect to the correct branch
101 information, then I suggest that you take a look at the contribution from
102 Henrik Carlqvist. He submitted some server-side scripts that can manage tags
103 in a better fashion than cvs on its own.
107 Todo
108 ----
109 - do a better job in making a layout (auto moving branches and rubber banding
110 revision-connectors to make place). A start is made, but this is not very
111 functional yet.
115 License
116 -------
117 CvsGraph is distributed under GNU GPL v2. See 'LICENSE' for more information.
121 Contact
122 -------
123 HomePage: http://www.akhphd.au.dk/~bertho/cvsgraph
124 E-mail: cvsgraph@akhphd.au.dk
126 Greetings Bertho

  ViewVC Help
Powered by ViewVC 1.1.0 with CvsGraph 1.7.0