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)