Little command-line tool for generating a changelog from a Subversion log.

type \SvnClg.exe help for more information.

This tool uses the StringTemplate Template Engine, so the output can easily be customized. The used template is located in the Templates folder (Templates\ChangeLog.st).
For more information about StringTemplate and how to use it please visit http://www.stringtemplate.org

Version 0.2.1General Usage:

Note: SVN log entries that should be ignored when generating the ChangeLog can be marked by a preceding special character. By default this is a minus ('-'). It can be changed in the .config file (key="escapeChar"). This way you can easily sort out the entries you don't want to have in the ChangeLog when committing changes.

Available commands:

Command Description Usage repo Specifies the repository from which the SVN-Log shall be fetched repo=svn://path/to/repo output or o This is where the generated ChangeLog will be saved output=D:\ChangeLog.txt svnpath Path to the svn.exe. This is not needed if svn.exe is already registered within the OS. svnpath=C:\path\to\svn.exe range or r A range of revisions that shall be merged to one log entry range=x-y or range=all or range=... > Wiki version or v The Version of the preceding range version=1.0.0 or version=1.0.* or version=1.0.5* -> Wiki swap Allows to swap the order of the entries swap=true or swap=false innerswap or iswap Allows to swap the order of the log messages within a changelog entry iswap=true or iswap=false help Shows the help help textwidth or tw Specifies the text width. A value of -1 means the text will not be wrapped tw=70 escapeChar or esc Specifies the character that's used to ignore particular SVN log entries esc= e.g. esc=

A full command line string could look something like this: \SvnClg.exe repo=http://svnclg.googlecode.com/svn/trunk/ output=D:\ChangeLog.txt range=1-100 version=1.0.0 range=101-200 version=2.0.0 swap

with v0.2 it can be distilled to: \SvnClg.exe repo=http://svnclg.googlecode.com/svn/trunk/ o=D:\ChangeLog.txt r=1-100,101-200 v=1.0.0,2.0.0 swap

When using none of the optional commands a ChangeLog entry will be generated for each (valid) svn log entry.

Note: The "version" command only works with a preceding "range" command

Config file (SvnClg.exe.config)Most of the above commands can be specified as default values in the .config file.
It stores default values for:
- Path to svn.exe (svnPath)
- The repository path (repoPath)
- The output path (outputPath)
- The escape character for ignoring log entries (escapeChar; default: )
The textwidth (textWidth; default: 70)
- Swap (swap; default: true)
- Innerswap (innerSwap; default: true)

These default settings will be overwritten when the accordant command line arguments are used.

StringTemplate variables

Name Description $date$ The date of the last revision in the given range $version$ The specified version $authors$ All authors that made commits $msg$ The log message(s) $revisions$ The revision numbers $paths$ The paths of the files that have been changed