svn2cl

svn2cl is an easy-to-use, completely free and open source command-line software, designed as an XSL stylesheet that can be used for generating GNU-style ChangeLogs from Subversion (SVN) repository log files.

Outputs a friendly-looking changelog

It is a small XSLT (EXtensible Stylesheet Language) script created from multiple changelog-like scripts. After the actual conversion process, the script will output a friendly-looking changelog (see the screenshot for more details).

Requires no installation

The svn2cl software requires no installation. To use it on your GNU/Linux operating system, just download the latest release from Softoware or the project’s website (see the homepage link at the end of the article), save the archive on your Home directory and unpack it.

Open a terminal emulator application and symlink the svn2cl.sh script in your path (e.g. ln -s /opt/svn2cl-0.x/svn2cl.sh /usr/local/bin/svn2cl (where x should be replaced with the current version of svn2cl)).

Command-line options

To view the program's command-line options, as well as the usage message, run the ‘svn2cl.sh --help’ command. Among the available options, we can mention the ability to specify the prefix used for stripping all entries, to specify the maximum length of an output line, to group changelog entries by day, as well as to put a blank line between entries that are grouped by day.

Users will also be able to include revision numbers, to add various tags to files, to add a line break or multiple breaks between the log message and the paths, to rewrap lines inside a paragraph, to specify a title for the HTML file, and to link revision numbers in the HTML output.

In addition, you can change #foo strings to links, ignore messages that start with a given string, output the result to a specific file or stdout instead of ChangeLog, to output the result as HTML instead of Plain Text, to specify the file to read for authors, and to specify the alias for the output.

What is new in this release:

• This version fixes two issues related to the --ticket-link and --ticket-prefix options.

What is new in version 0.12:

• This release fixes an annoying bug that surfaced due to an update in Gnome's libxml.
• It also includes some accumulated smaller bugfixes.

What is new in version 0.11:

• This version includes some small portability improvements to the wrapper shell script.