cvs2html1

Overview

The cvs2html script fetches the commit log for a CVS module and renders it in HTML.

-a

Generate additional fields and files containing differences between versions in an xdiff-like side by side manner.

-b

Use spaces as breakpoints to wrap the text, if -a is specified. This is used to stop the two columns from exceeding the total width.

-c | -C filename

Save a chronologically sorted list of all log entries in html format in filename. Use -C to reverse-sort the file.

-d MMM DD [YYYY]

Omit all log messages prior to the given date. The first three letters of the month should be used (eg Jun 5). The year is optional.

-D DD

Omit all log messages older than DD days.

-e

Print log messages in courier (non-proportional) font.

-f

Generate individual log files for each file when using -o.

-h

Show help

-i image

Make image the background image.

-k

Ignore changes in lines caused by CVS-keyword substitutions when -a is specified.

-l home

Make links relative to home.

-L home

Make links relative to home, but substitute file extensions with .html.

-n numdiff

Output only the latest numdiff diffs in the log. Older commits will only have the log data displayed.

-N maxchrono

Show only the latest maxchrono file changes in the chronological list of changes.

-o outputFr

If output is a directory, all html files produced are stored there, using the name of the repository as the base filename. Otherwise, output is used as the base name. Generate frames for easier browsing.

-O output

If output is a directory, all html files produced are stored there, using the name of the repository as the base filename. Otherwise, output is used as the base name.

-P cvspath

Set the cvs path to cvspath.

-rrev1:rev2

Show only the log messages between rev1, and rev2. If a file isn't tagged, then the whole revision story of the file is shown.

-s percentage

Make the width of the left frame, percentage of the window.

-v

Insert CVSROOT information in the index.

-V verbosity

Set the verbosity. The higher verbosity is, the more output is printed out.

-w framewidth

Make the width of the left frame, framewidth pixels.

Examples

cvs2html -l http://cvs.sslug.dk/linuxbog -f -p \\ -o cvs2html/index.html -v -a -b -n 6 -C chrono.html

Will create a directory called cvs2html directory. This directory will contain a log data file, for every file in the repository. The last 6 commits to every file will have a diff available. All links will be relative to http://cvs.sslug.dk/linuxbog. It will also create a file with all the log data in it, in chronological order.