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]   [-rlogfile=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:

· listdeltabydate To get a changelog between 2 versions,

sorted by date

· listdeltabylog To get a changelog between 2 versions,

sorted by log

· listdeltabyfile To get a changelog between 2 versions,

sorted by file

· listdeltaforrpm To get a changelog between 2 versions

for rpm spec files

· buildhtmlreport To build an html report

Note that "between 2 versions" means (depends on tagstart/tagend options):

· from start to a tagged version (version changes

included)

· from a tagged version (excluded) to another tagged ver

sion (included)

· 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:

· nosummary To remove summary part

· nolinesofcode To remove lines of code part

· nodevelopers To remove developers part

· nodaysofweek To remove days of week part

· nohours To remove hours part

· notags To remove tags part

· nolastlogs To remove last logs part

· nolimit To not limit last logs to last 200

· sortbyrevision To sort last logs by revision

· includediff To include diff inside report page

(very slow)

· 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:

· -m=module To force value of module name

· -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 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.

CVSCHANGELOGBUILDER(1)