CVSRDIFF2CVSWEB

NAME
SYNOPSIS
DESCRIPTION
FILES
EXAMPLE
BUGS
AUTHOR

NAME

cvsrdiff2cvsweb − convert a cvs rdiff -s output to HTML

SYNOPSIS

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

DESCRIPTION

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.

FILES

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.

EXAMPLE

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!

BUGS

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.

AUTHOR

Martin Kammerhofer <mkamm@gmx.net>