cvsrdiff2cvsweb − convert a "cvs rdiff −s" output to HTML
|
• |
cvsrdiff2cvsweb [−−cvsweb= URL ] [−−urlsuffix= SFX ] [−−branch= TAG ] [−−output−file= FILE ] rdiff-file |
||
|
• |
cvsrdiff2cvsweb [−−cvsweb= URL ] [−−urlsuffix= SFX ] [−−branch= TAG ] [−−output−file= FILE ] −−repository= REPO −−rev1= REV1 −−rev2= REV2 module... |
||
|
• |
cvsrdiff2cvsweb −−version |
The cvsrdiff2cvsweb program takes output from "cvs rdiff −s" (change summary) and converts it into HTML . Names of changed (added, updatet or deleted) files are replaced with hyperlinks to a "cvsweb" CGI script.
This means you can click on any of the updated files and see the CVS log (change history) and have access to all the revisions and deltas.
(The cgi-script "cvsweb.cgi" was originally written by Bill Fenner <fenner@freebsd.org> for the FreeBSD project. It allows browsing of CVS-repositories with a HTML−browser. CVS is a popular version control system.)
Options may be
abbreviated to a unique prefix. The options are as follows:
−−cvsweb= URL
Specify URL of cvsweb.cgi script.
−−urlsuffix= SFX
Specify some extra information for appending to generated URLs. (You should not type a leading "?" or "&" character because it will be added automatically.)
−−branch= TAG
Tell "cvsweb.cgi" that you are only interested in file revisions on the specified branch.
−−output−file= FILENAME
Specify the output file. If no output file is specified standard output is used.
−−repository= REPOSITORY
This is used to invoke the "cvs rdiff" command. This option requires options "−−rev1" and "−−rev2" too.
−−rev1= REVISION1 −−rev2= REVISION2
Specify which revisions to compare. Unless "CVSROOT" is set in your environment this will also require option "−−repository".
−−version
Print version information and exit.
"cvsrdiff2cvsweb" looks for a configuration file in three places.
|
• |
If the variable "CVSWEB_CONVERTERS_CONF" is set in the environment its content is interpreted as the name of the configuration file, otherwise |
||
|
• |
the file ~/.cvsweb−converters.conf is examined, and finally |
||
|
• |
/tmp/etc/cvsweb−converters.conf is tried. |
Only the first found file is read.
Suppose you are running the FreeBSD operating and want to know in detail how the networking code changed between FreeBSD 6.1 and the latest 6−X−stable.
"CVSROOT=:pserver:anoncvs@anoncvs.FreeBSD.org:/home/ncvs"
"export CVSROOT; cvs login # password ’anoncvs’"
"cvs rdiff −s −r RELENG_6_1_0_RELEASE −r RELENG_6 sys/netinet >netinet.rdiff"
"cvsrdiff2cvsweb −cvsweb http://www.jp.FreeBSD.org/cgi/cvsweb.cgi −branch RELENG_6 −out netinet.html netinet.rdiff"
Now open netinet.html with your favorite browser!
There is no provision to invoke "cvs rdiff −s" with custom options or dates ("−D") rather than revision numbers or tags. It is however possible to run "cvs rdiff −s" manually and feed the output into "cvsrdiff2cvsweb".
Martin Kammerhofer <mkamm@gmx.net>