CVSCHANGELOGBUILDER(1) General Commands Manual CVSCHANGELOGBUILDER(1)
NAME
cvschangelogbuilder -- build cvs ChangeLogs and cvs html reports
SYNOPSIS
cvschangelogbuilder -output=outputmode [-m=module -d=repository] [-b=branch] [-tagstart=tagname] [-tagend=tagname] [-ssh] [-rlog-
file=rlogfile] [-keeprlogfile] [-dir=dirname] [-viewcvsurl=viewcvsurl] [-ignore=file/dir] [-only=file/dir] [-includeheader=file]
[-allowindex] [-debug=x]
DESCRIPTION
cvschangelogbuilder generates advanced ChangeLog/Report files for CVS projects/modules.
OPTIONS
-output=outputmode
Where outputmode is:
o listdeltabydate To get a changelog between 2 versions, sorted by date
o listdeltabylog To get a changelog between 2 versions, sorted by log
o listdeltabyfile To get a changelog between 2 versions, sorted by file
o listdeltaforrpm To get a changelog between 2 versions for rpm spec files
o buildhtmlreport To build an html report
Note that "between 2 versions" means (depends on tagstart/tagend options):
o from start to a tagged version (version changes included)
o from a tagged version (excluded) to another tagged version (included)
o or from a tagged version until now (version changes excluded)
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:
o nosummary To remove summary part
o nolinesofcode To remove lines of code part
o nodevelopers To remove developers part
o nodaysofweek To remove days of week part
o nohours To remove hours part
o notags To remove tags part
o nolastlogs To remove last logs part
o nolimit To not limit last logs to last 200
o sortbyrevision To sort last logs by revision
o includediff To include diff inside report page (very slow)
o loosecommits To separate commits for same log by spaces
-m=module -d=repository
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:
o -m=module To force value of module name
o -d=repository To force value of CVSROOT
-branch=branchname
To work on another branch than the default branch.
-tagstart=tagname
To specify start tag version.
-tagend=tagend
To specify end tag version.
-ssh To run CVS through ssh (this set env var CVS_RSH="ssh").
-rlogfile=rlogfile
If an up-to-date log file already exists localy, you can use this option to avoid log download, for a faster result.
-keeprlogfile
Once process is finished, you can ask to not remove the downloaded log file.
-dir=dirname
Output is built in directory dirname.
-viewcvsurl=viewcvsurl
File's revisions in reports built by buildhtmlreport output are links to "viewcvs". String '__MODULE__' will be replaced by name
of CVS module.
-ignore=file/dir
To exclude a file/dir off report.
-only=file/dir
To have reports only on file/dir that match.
-includeheader=file
To add content of a file after body tag.
-allowindex
To allow meta tag index (noindex by default).
-debug=x To output on stderr some debug info with level x.
SEE ALSO
cvs (1).
AUTHOR
This manual page was written by Adriaan Peeters apeeters@lashout.net for the Debian 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 Gen-
eral 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.
CVSCHANGELOGBUILDER(1)