.TH "CVSCHANGELOGBUILDER" "1" 
.SH "NAME" 
cvschangelogbuilder \(em build cvs ChangeLogs and cvs html reports 
.SH "SYNOPSIS" 
.PP 
\fBcvschangelogbuilder \fR \fB-output=outputmode\fP [\fB-m=module \-d=repository\fP]  [\fB-b=branch\fP]  [\fB-tagstart=tagname\fP]  [\fB-tagend=tagname\fP]  [\fB-ssh\fP]  [\fB-rlogfile=rlogfile\fP]  [\fB-keeprlogfile\fP]  [\fB-dir=dirname\fP]  [\fB-viewcvsurl=viewcvsurl\fP]  [\fB-ignore=file/dir\fP]  [\fB-only=file/dir\fP]  [\fB-includeheader=file\fP]  [\fB-allowindex\fP]  [\fB-debug=x\fP]  
.SH "DESCRIPTION" 
.PP 
\fBcvschangelogbuilder\fR       generates advanced ChangeLog/Report files for CVS projects/modules. 
 
.SH "OPTIONS" 
.IP "\fB-output=outputmode\fP" 10 
Where outputmode is: 
 
.RS 
.IP "   \(bu" 6 
listdeltabydate  To get a changelog between 2 versions, sorted by date 
.IP "   \(bu" 6 
listdeltabylog   To get a changelog between 2 versions, sorted by log 
.IP "   \(bu" 6 
listdeltabyfile  To get a changelog between 2 versions, sorted by file 
.IP "   \(bu" 6 
listdeltaforrpm  To get a changelog between 2 versions for rpm spec files 
.IP "   \(bu" 6 
buildhtmlreport  To build an html report 
.RE 
.IP "" 10 
Note that "between 2 versions" means (depends on tagstart/tagend options): 
.RS 
.IP "   \(bu" 6 
from start to a tagged version (version changes included) 
.IP "   \(bu" 6 
from a tagged version (excluded) to another tagged version (included) 
.IP "   \(bu" 6 
or from a tagged version until now (version changes excluded) 
.RE 
.IP "" 10 
You can also add extra parameters when output=buildhtmlreport by adding them 
after a colon and separated by a comma, like this: 
\-output=buildhtmlreport:param1,param2 
This is extra paremeters available for \-output=buildhtmlreport mode: 
 
.RS 
.IP "   \(bu" 6 
nosummary         To remove summary part 
.IP "   \(bu" 6 
nolinesofcode     To remove lines of code part 
.IP "   \(bu" 6 
nodevelopers      To remove developers part 
.IP "   \(bu" 6 
nodaysofweek      To remove days of week part 
.IP "   \(bu" 6 
nohours           To remove hours part 
.IP "   \(bu" 6 
notags            To remove tags part 
.IP "   \(bu" 6 
nolastlogs        To remove last logs part 
.IP "   \(bu" 6 
nolimit           To not limit last logs to last 200 
.IP "   \(bu" 6 
sortbyrevision    To sort last logs by revision 
.IP "   \(bu" 6 
includediff       To include diff inside report page (very slow) 
.IP "   \(bu" 6 
loosecommits      To separate commits for same log by spaces 
.RE 
.IP "\fB-m=module\fP \fB-d=repository\fP" 10 
The 'module' and 'repository' are the CVS module name and the CVS repository. 
If current directory is the root of a CVS project built from a cvs checkout, 
cvschangelogbuilder will retreive module and repository value automatically. 
If no local copy of repository are available or to force other value, use: 
 
.RS 
.IP "   \(bu" 6 
\-m=module           To force value of module name 
.IP "   \(bu" 6 
\-d=repository       To force value of CVSROOT 
.RE 
.IP "\fB-branch=branchname\fP" 10 
To work on another branch than the default branch. 
 
.IP "\fB-tagstart=tagname\fP" 10 
To specify start tag version. 
 
.IP "\fB-tagend=tagend\fP" 10 
To specify end tag version. 
 
.IP "\fB-ssh\fP" 10 
To run CVS through ssh (this set env var CVS_RSH="ssh"). 
 
.IP "\fB-rlogfile=rlogfile\fP" 10 
If an up-to-date log file already exists localy, you can 
use this option to avoid log download, for a faster result. 
 
.IP "\fB-keeprlogfile\fP" 10 
Once process is finished, you can ask to not remove the 
downloaded log file. 
 
.IP "\fB-dir=dirname\fP" 10 
Output is built in directory dirname. 
 
.IP "\fB-viewcvsurl=viewcvsurl\fP" 10 
File's revisions in reports built by buildhtmlreport 
output are links to "viewcvs". String '__MODULE__' 
will be replaced by name of CVS module. 
 
.IP "\fB-ignore=file/dir\fP" 10 
To exclude a file/dir off report. 
 
.IP "\fB-only=file/dir\fP" 10 
To have reports only on file/dir that match. 
 
.IP "\fB-includeheader=file\fP" 10 
To add content of a file after body tag. 
 
.IP "\fB-allowindex\fP" 10 
To allow meta tag index (noindex by default). 
 
.IP "\fB-debug=x\fP" 10 
To output on stderr some debug info with level x. 
 
.SH "SEE ALSO" 
.PP 
cvs (1). 
.SH "AUTHOR" 
.PP 
This manual page was written by Adriaan Peeters apeeters@lashout.net for 
the \fBDebian\fP system (but may be used by others). It is based on 
the help output of cvschangelogbuilder. Permission is 
granted to copy, distribute and/or modify this document under 
the terms of the GNU General Public 
License, Version 2 or any later version published by the Free 
Software Foundation; with no Invariant Sections, no Front-Cover 
Texts and no Back-Cover Texts. 
.\" created by instant / docbook-to-man, Fri 18 Jul 2008, 19:43