cvsuplog2cvsweb − convert a "cvsup" log file to HTML
|
. |
cvsuplog2cvsweb [−−cvsweb= URL ] [−−urlsuffix= STR ] [−−branch= TAG ] [−−cvsrootdir= DIR ] [−−output−file= FILE ] cvsup.log |
||
|
. |
cvsuplog2cvsweb −−version |
The cvsuplog2cvsweb program takes a logfile from "cvsup" and converts it into HTML . Names of changed (added, updated 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.
("cvsup" is written by John Polstra <jdp@polstra.com>. It is a network distribution package for CVS repositories. 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 then standard output is used.
−−cvsrootdir= DIR
Add HTML "file:" links to non-versioned (rsynced or appended) files. The directory DIR is prepended to the generated "file:" URLs.
−−version
Print version information and exit.
"cvsuplog2cvsweb" 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 system and want to upgrade your sources from the RELENG_6 branch. You already have a working cvsup config file in /usr/share/examples/cvsup/stable−supfile. Since your nearest cvsup mirror is in Germany you use
"cvsup −g −h cvsup.de.freebsd.org −L2 /usr/share/examples/cvsup/stable−supfile >cvsup.log"
Now you want to know what all this source updates are about and invoke
"cvsuplog2cvsweb −−cvsweb=http://cvsweb.FreeBSD.org/ −−branch=RELENG_6 cvsup.log >cvsuplog.html"
Finally open cvsuplog.html with your favourite browser!
Martin Kammerhofer <mkamm@gmx.net>