: clarify usage information to include possibility to + specify location of repository + +2005-12-25 14:44 arthur + + * [r44] svn2cl.1: add manual page, some parts taken from manual + page provided by Russ Allbery <rra@...> + +2005-12-25 13:56 arthur + + * [r43] svn2cl.xsl: preserve line breaks in log messages, trimming + all trailing and beginning line breaks + +2005-12-25 13:10 arthur + + * [r42] svn2cl.sh: clear up usage string, thanks to Tobias Schäfer + <tobiasschaefer@...> + +2005-12-25 13:03 arthur + + * [r41] NEWS, README: apply typo fixing and documentation improving + patch by Tobias Schäfer <tobiasschaefer@...> + +2005-12-17 20:20 arthur + + * [r40] svn2cl.sh: include --html option in --help output + +2005-12-04 21:26 arthur + + * [r38] .: move directory back + +2005-12-04 21:26 arthur + + * [r37] .: make release 0.4 + +2005-12-04 21:23 arthur + + * [r36] NEWS: add NEWS file + +2005-12-04 21:21 arthur + + * [r35] TODO: include TODO file + +2005-12-04 21:09 arthur + + * [r34] README, svn2cl.sh: bump version number to 0.4 + +2005-12-04 21:00 arthur + + * [r33] svn2cl.sh, svn2html.css, svn2html.xsl: add html stylesheet + and css and --help option to output html + +2005-12-04 20:50 arthur + + * [r32] svn2cl.sh: ensure that required arguments to options are + specified (avoid silent failure) + +2005-12-04 20:30 arthur + + * [r31] svn2cl.sh: implement passing options to the svn log + command, rename -r option (--include-rev) to -i + +2005-12-04 20:27 arthur + + * [r30] svn2cl.sh: handle --option=arg options as well as --option + arg + +2005-12-04 20:25 arthur + + * [r29] svn2cl.sh: implement handling of -f and --file options + +2005-12-03 12:55 arthur + + * [r28] svn2cl.xsl: move adding colon to path list one level up + +2005-12-03 12:52 arthur + + * [r27] svn2cl.xsl: remove TODO section (is now in a separate file) + +2005-12-03 12:52 arthur + + * [r26] svn2cl.xsl: ensure that we have a space everywhere before + /> + +2005-12-03 12:14 arthur + + * [r25] svn2cl.xsl: no need for xhtml namespace declaration + +2005-12-02 16:51 arthur + + * [r24] svn2cl.xsl: explain why we use ++ for options + +2005-12-02 16:34 arthur + + * [r23] svn2cl.xsl: switch ChangeLog encoding to utf-8 + +2005-09-13 19:27 arthur + + * [r21] README, svn2cl.sh: bump version number to 0.3 + +2005-09-09 19:04 arthur + + * [r20] svn2cl.sh: implement writing ChangeLog to a different file + or stdout + +2005-08-16 18:24 arthur + + * [r19] svn2cl.sh: make -r an alias for --include-rev + +2005-07-31 16:37 arthur + + * [r17] README: add simple installation instructions + +2005-07-31 16:33 arthur + + * [r16] README: add very basic README + +2005-07-31 16:08 arthur + + * [r15] svn2cl.sh: use basename when printing program name + +2005-07-31 16:00 arthur + + * [r14] svn2cl.sh: add code for finding the location of the .xsl + file relative to the installed location of the script following + symlinks + +2005-07-31 15:26 arthur + + * [r13] svn2cl.sh: add proper command line handling to shell script + +2005-07-31 14:51 arthur + + * [r12] svn2cl.sh: add simple shell script calling xsltproc + +2005-07-31 14:42 arthur + + * [r11] svn2cl.xsl: add an include-rev option to also list revision + number + +2005-07-31 14:41 arthur + + * [r10] svn2cl.xsl: fix copy-pasto + +2005-07-31 14:40 arthur + + * [r9] svn2cl.xsl: make groupbyday either have yes or no value + +2005-07-31 14:38 arthur + + * [r8] svn2cl.xsl: add a groupbyday option to group all changes per + day per author + +2005-03-25 17:11 arthur + + * [r7] svn2cl.xsl: make linelen really configurable (param instead + of variable + +2005-03-25 14:36 arthur + + * [r6] svn2cl.xsl: move printing of trailing newline to wrap + template (plus some small readability improvements) + +2005-03-25 14:29 arthur + + * [r5] svn2cl.xsl: make line length configurable + +2005-03-23 21:51 arthur + + * [r4] svn2cl.xsl: split out formatting of single pathname and also + handle situation with trailing slash in strip-prefix + +2005-03-23 21:19 arthur + + * [r3] svn2cl.xsl: use entities for outputting tabs, spaces and + newlines + +2005-03-23 20:45 arthur + + * [r1] ., svn2cl.xsl: check in initial version + Added: tools/trunk/svn2cl/NEWS =================================================================== --- tools/trunk/svn2cl/NEWS (rev 0) +++ tools/trunk/svn2cl/NEWS 2008-04-17 20:35:14 UTC (rev 803) @@ -0,0 +1,96 @@ +changes from 0.9 to 0.10 +------------------------ + +* add an --include-actions option that adds action labels about file + additions and removals +* small fix for other XSLT processors +* manual page improvement + + +changes from 0.8 to 0.9 +----------------------- + +* ignore files outside the base directory if --strip-prefix is specified + (the default with the wrapper shellscript) +* add --ignore-message-starting option to ignore any log messages that + start with the specified string + + +changes from 0.7 to 0.8 +----------------------- + +* added --title option for setting html page title (thanks Matt Doar) +* added --revision-link option to make the revision numbers in the html + output link to some url +* updated --break-before option to have an optional number of breaks +* authors file format improvements (see manual) +* fixes to the svn info command to guess working directory (thanks Iwasa + Kazmi) +* miscellaneous fixes (thanks Max Bane and Iwasa Kazmi) +* document calling svn2cl from ant by Rob Moore +* some wrapping fixes +* fixes for having directories and/or repositories with spaces in them + + +changes from 0.6 to 0.7 +----------------------- + +* performance improvements (svn2cl is about 40% faster when not using the + --group-by-day option plus a couple of percent when using the --authors + option) +* path to strip from file names is now automatically determined (works with + svn>=1.3.0) +* colon separated authors file is now supported +* html output improvements +* added --reparagraph option that re-wraps text inside paragraphs +* added --separate-daylogs option that inserts newlines between log messages + when --group-by-day is used +* manual page improvements + + +changes from 0.5 to 0.6 +----------------------- + +* added --authors option to expand full author names (experimental, if anyone + has a better performing implementation, please let me know) +* added --break-before-msg option (based on a patch by Vincent Danen) +* added another example to manual page (thanks to Bastian Kleineidam) +* preserve line breaks in html output +* output line breaks that are more likely to be correct on most platforms +* updated svn2html.css to give ChangeLog.html a little nicer layout + + +changes from 0.4 to 0.5 +----------------------- + +* preserve line breaks in svn log messages +* added manual page for shellscript wrapper +* wrapper script portability improvements +* documentation and --help output fixes and improvements + + +changes from 0.3 to 0.4 +----------------------- + +* added NEWS and TODO files +* support for passing options to svn log command +* preliminary support for generating an html version of the ChangeLog + (copy css file manually) +* switch encoding of generated files to utf-8 +* better command option handling + + +changes from 0.2 to 0.3 +----------------------- + +* added short equivalents for some commonly used command line options +* write the changelog to a different file or to stdout + + +changes from 0.1 to 0.2 +----------------------- + +* support grouping entries per day +* support for adding revision numbers in the log +* line length is configurable +* a wrapper shell script Added: tools/trunk/svn2cl/README =================================================================== --- tools/trunk/svn2cl/README (rev 0) +++ tools/trunk/svn2cl/README 2008-04-17 20:35:14 UTC (rev 803) @@ -0,0 +1,102 @@ + svn2cl - create a ChangeLog from a subversion log + + Copyright (C) 2004, 2005, 2006, 2007, 2008 Arthur de Jong + + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions + are met: + 1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + 2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in + the documentation and/or other materials provided with the + distribution. + 3. The name of the author may not be used to endorse or promote + products derived from this software without specific prior + written permission. + + THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR + IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED + WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY + DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE + GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER + IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR + OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN + IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + + +INTRODUCTION +============ + +svn2cl is a simple xsl transformation and shell script wrapper for generating +a classic GNU-style ChangeLog from a subversion repository log. It is made +from several changelog-like scripts using common xslt constructs found in +different places. + +I made it because it was the only thing that I missed from cvs after I +converted a repository to subversion. I used cvs2cl before. + +INSTALLING SVN2CL +================= + +Just unpack the tarball in some directory (e.g. /opt/svn2cl-0.10) +and symlink the svn2cl.sh script in your path somewhere (e.g. +ln -s /opt/svn2cl-0.10/svn2cl.sh /usr/local/bin/svn2cl). + +Note: Be sure to keep the svn2cl.xsl file in the same directory as the +svn2cl.sh script as the script looks for it there (symlinking is ok). + +USING SVN2CL IN AN ANT TARGET +============================= + +It is possible to use svn2cl in an ant target with a snippet like: + +<tempfile property="info.xml.file" + prefix="info-" suffix=".xml" + destdir="${}" /> +<java classname="org.tmatesoft.svn.cli.SVN" dir="${}" + fork="true" output="${}" + classpathref="http://cunt.meetingstrippeddevi.com/Stripped/en/javasvn-classpath"> + <arg line="log --xml --verbose" /> +</java> +<xslt in="${}" out="ChangeLog" style="svn2cl.xsl"> + <param name="strip-prefix" expression="trunk/myProject/" /> + <param name="groupbyday" expression="yes" /> + <param name="separate-daylogs" expression="yes" /> + <param name="include-rev" expression="yes" /> + <param name="breakbeforemsg" expression="yes" /> + <param name="reparagraph" expression="yes" /> +</xslt> +<delete file="${}" /> + +Although it seems that currently the xslt processor that is used by ant +inserts newlines in places it shouldn't. This can be worked around by +replacing &newl; throughout the xsl files by &#xa;. + +WINDOWS PORT +============ + +A VBScript port of the wrapper shell script has been made by Iwasa Kazmi, +which allows running svn2cl on Microsoft Windows without a POSIX compatibility +layer and xsltproc. More information is available here: Plugins i Menu a Menu asncsearchw Meetingstrippeddevi nsearchh Cunt myou.porn + +NOTES +===== + +The log is performed on the current directory '.' unless you specify URL +and/or PATH parameters. Before generating the ChangeLog you may want to make +your working copy up to date with 'svn update' (non-recursive update will do) +or pass --revision HEAD:1 as a parameter to svn2cl.sh. + +There will not be very frequent new releases but if there are they can be +found at: ~arthur/svn2cl/ + +FEEDBACK AND BUG REPORTS +======================== + +If you have any questions about svn2cl or would like to report a bug please +send an email to Arthur de Jong <arthur@...>. Added: tools/trunk/svn2cl/TODO =================================================================== --- tools/trunk/svn2cl/TODO (rev 0) +++ tools/trunk/svn2cl/TODO 2008-04-17 20:35:14 UTC (rev 803) @@ -0,0 +1,10 @@ +* support more xslt processors +* group changes per autor per day +* svn2rss? +* if an authors.xml file exists in the current directory automatically pick it up +* improve performance of processing authors.xml +* fix awk magic to not break with spaces in repository names +* find better names for options +* create backup of previous changelog file +* support specifying multiple --ignore-message-starting options +* svn2cl --strip-prefix=/ doesn't work as expected Added: tools/trunk/svn2cl/authors.xml =================================================================== --- tools/trunk/svn2cl/authors.xml (rev 0) +++ tools/trunk/svn2cl/authors.xml 2008-04-17 20:35:14 UTC (rev 803) @@ -0,0 +1,12 @@ +<?xml version="1.0" encoding="utf-8"?> +<authors xmlns:html="1999/xhtml"> + <author uid="arthur"> + Arthur de Jong &lt;<html:a href="http://cunt.meetingstrippeddevi.com/Stripped/en/mailto:arthur@...; + </author> + <author uid="nobody"> + Who's this &lt;nobody@...; + </author> + <author uid="root"> + Superman &lt;root@...; + </author> +</authors> Added: tools/trunk/svn2cl/svn2cl.1 =================================================================== --- tools/trunk/svn2cl/svn2cl.1 (rev 0) +++ tools/trunk/svn2cl/svn2cl.1 2008-04-17 20:35:14 UTC (rev 803) @@ -0,0 +1,208 @@ +.\" Copyright (C) 2005, 2006, 2007, 2008 Arthur de Jong +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in +.\" the documentation and/or other materials provided with the +.\" distribution. +.\" 3. The name of the author may not be used to endorse or promote +.\" products derived from this software without specific prior +.\" written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED +.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY +.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE +.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER +.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR +.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN +.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.TH "svn2cl" "1" "Apr 2008" "Version 0.10" "User Commands" +.nh +.SH "NAME" +svn2cl - Create a ChangeLog from a subversion log. +.SH "SYNOPSIS" +.B svn2cl +.RI [ OPTION ]... +