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 |
||
• |
/usr/local/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_4 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_4 cvsup.log >cvsuplog.html Open cvsuplog.html with your favourite browser now! |
Martin Kammerhofer <mkamm@gmx.net> |