.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  | will give a
.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
.\" expand to `' in nroff, nothing in troff, for use with C<>.
.tr \(*W-|\(bv\*(Tr
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "CVSRDIFF2CVSWEB 1"
.TH CVSRDIFF2CVSWEB 1 "2006-06-22" "perl v5.8.8" "User Contributed Perl Documentation"
.SH "NAME"
cvsrdiff2cvsweb \- convert a \f(CW\*(C`cvs rdiff \-s\*(C'\fR output to HTML
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.IP "\(bu" 4
cvsrdiff2cvsweb [\-\-cvsweb=\fI\s-1URL\s0\fR] [\-\-urlsuffix=\fI\s-1SFX\s0\fR] [\-\-branch=\fI\s-1TAG\s0\fR]
[\-\-output\-file=\fI\s-1FILE\s0\fR] \fIrdiff-file\fR
.IP "\(bu" 4
cvsrdiff2cvsweb [\-\-cvsweb=\fI\s-1URL\s0\fR] [\-\-urlsuffix=\fI\s-1SFX\s0\fR]
[\-\-branch=\fI\s-1TAG\s0\fR] [\-\-output\-file=\fI\s-1FILE\s0\fR] \-\-repository=\fI\s-1REPO\s0\fR
\&\-\-rev1=\fI\s-1REV1\s0\fR \-\-rev2=\fI\s-1REV2\s0\fR \fImodule\fR...
.IP "\(bu" 4
cvsrdiff2cvsweb \-\-version
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
The cvsrdiff2cvsweb program takes output from \f(CW\*(C`cvs rdiff \-s\*(C'\fR (change
summary) and converts it into \s-1HTML\s0. Names of changed (added, updatet
or deleted) files are replaced with hyperlinks to a \f(CW\*(C`cvsweb\*(C'\fR \s-1CGI\s0
script.
.PP
This means you can click on any of the updated files and see the \s-1CVS\s0
log (change history) and have access to all the revisions and deltas.
.PP
(The cgi-script \f(CW\*(C`cvsweb.cgi\*(C'\fR was originally written by Bill Fenner
<fenner@freebsd.org> for the FreeBSD project. It allows browsing of
CVS-repositories with a HTML\-browser. \s-1CVS\s0 is a popular version control
system.)
.PP
Options may be abbreviated to a unique prefix. The options are as
follows:
.IP "\-\-cvsweb=\fI\s-1URL\s0\fR" 4
.IX Item "--cvsweb=URL"
Specify \s-1URL\s0 of cvsweb.cgi script.
.IP "\-\-urlsuffix=\fI\s-1SFX\s0\fR" 4
.IX Item "--urlsuffix=SFX"
Specify some extra information for appending to generated URLs. (You
should not type a leading \f(CW\*(C`?\*(C'\fR or \f(CW\*(C`&\*(C'\fR character because it will be
added automatically.)
.IP "\-\-branch=\fI\s-1TAG\s0\fR" 4
.IX Item "--branch=TAG"
Tell \f(CW\*(C`cvsweb.cgi\*(C'\fR that you are only interested in file revisions on
the specified branch.
.IP "\-\-output\-file=\fI\s-1FILENAME\s0\fR" 4
.IX Item "--output-file=FILENAME"
Specify the output file. If no output file is specified standard
output is used.
.IP "\-\-repository=\fI\s-1REPOSITORY\s0\fR" 4
.IX Item "--repository=REPOSITORY"
This is used to invoke the \f(CW\*(C`cvs rdiff\*(C'\fR command. This option requires
options \f(CW\*(C`\-\-rev1\*(C'\fR and \f(CW\*(C`\-\-rev2\*(C'\fR too.
.IP "\-\-rev1=\fI\s-1REVISION1\s0\fR \-\-rev2=\fI\s-1REVISION2\s0\fR" 4
.IX Item "--rev1=REVISION1 --rev2=REVISION2"
Specify which revisions to compare. Unless \f(CW\*(C`CVSROOT\*(C'\fR is set in your environment this will also require option \f(CW\*(C`\-\-repository\*(C'\fR.
.IP "\-\-version" 4
.IX Item "--version"
Print version information and exit.
.SH "FILES"
.IX Header "FILES"
\&\f(CW\*(C`cvsrdiff2cvsweb\*(C'\fR looks for a configuration file in three places.
.IP "\(bu" 4
If the variable \f(CW\*(C`CVSWEB_CONVERTERS_CONF\*(C'\fR is set in the environment its
content is interpreted as the name of the configuration file, otherwise
.IP "\(bu" 4
the file \fI~/.cvsweb\-converters.conf\fR is examined, and finally
.IP "\(bu" 4
\&\fI/tmp/etc/cvsweb\-converters.conf\fR is tried.
.PP
Only the first found file is read.
.SH "EXAMPLE"
.IX Header "EXAMPLE"
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.
.PP
\&\f(CW\*(C`CVSROOT=:pserver:anoncvs@anoncvs.FreeBSD.org:/home/ncvs\*(C'\fR
.PP
\&\f(CW\*(C`export CVSROOT; cvs login # password 'anoncvs'\*(C'\fR
.PP
\&\f(CW\*(C`cvs rdiff \-s \-r RELENG_6_1_0_RELEASE \-r RELENG_6 sys/netinet >netinet.rdiff\*(C'\fR
.PP
\&\f(CW\*(C`cvsrdiff2cvsweb \-cvsweb http://www.jp.FreeBSD.org/cgi/cvsweb.cgi \-branch RELENG_6 \-out netinet.html netinet.rdiff\*(C'\fR
.PP
Now open \fInetinet.html\fR with your favorite browser!
.SH "BUGS"
.IX Header "BUGS"
There is no provision to invoke \f(CW\*(C`cvs rdiff \-s\*(C'\fR with custom options or
dates (\f(CW\*(C`\-D\*(C'\fR) rather than revision numbers or tags. It is however
possible to run \f(CW\*(C`cvs rdiff \-s\*(C'\fR manually and feed the output into
\&\f(CW\*(C`cvsrdiff2cvsweb\*(C'\fR.
.SH "AUTHOR"
.IX Header "AUTHOR"
Martin Kammerhofer <mkamm@gmx.net>