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 |
||
• |
/usr/local/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 4.10 and the latest 4-X−stable. CVSROOT=:pserver:anoncvs@anoncvs.FreeBSD.org:/home/ncvs export CVSROOT; cvs login # password ’anoncvs’ cvs rdiff -s -r RELENG_4_10_0_RELEASE -r RELENG_4 sys/netinet >netinet.rdiff cvsrdiff2cvsweb -cvsweb http://www.jp.FreeBSD.org/cgi/cvsweb.cgi -branch RELENG_4 -out netinet.html netinet.rdiff Now open netinet.html with your favourite 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> |