<document>
  <properties>
    <title>Introduction</title>
  </properties>
  <head>
    <meta name="description"
	content="StatSVN retrieves information from a Subversion repository and generates various tables and charts describing the project development."
	/>

    <meta name="keywords"
        content="SubVersion, StatCVS, Statistics Subversion, svn, Code Repository, svn statistics, svn graphs, java, open source" />
    <meta name="Subject" content="Statistics Subversion SVN" />
    <meta name="Copyright" content="StatSVN Team and ObjectLab Financial Ltd" />
    <meta name="Language" content="English" />
    <meta name="Designer" content="StatSVN Team and ObjectLab Financial Ltd" />
    <meta name="Distribution" content="Global" />
    <meta name="robots" content="ALL"/>
    <meta name="Revisit-After" content="20 Days" />
    <link rel="alternate" type="application/rss+xml"
                title="ObjectLab Open Source News" href="http://feeds.feedburner.com/ObjectLabOpenSourceNews?format=xml"/>
  </head>
  <body>
    <!-- The body of the document contains a number of sections -->
    <section name="StatSVN News">
    <p style="margin-top:10px; margin-bottom:0; padding-bottom:0; text-align:center; line-height:0"><a href="http://feeds.feedburner.com/~r/ObjectlabOpenSourceNews/~6/1"><img src="http://feeds.feedburner.com/ObjectlabOpenSourceNews.1.gif" alt="ObjectLab Open Source News" style="border:0"/></a></p><p style="margin-top:5px; padding-top:0; font-size:x-small; text-align:center"><a href="http://www.feedburner.com/fb/a/headlineanimator/install?id=829470&amp;w=1" target="_blank">Grab this Headline Animator</a></p>
    
    <p>2008-06-20: release of 0.4.1, re-launch of the <a href="http://wiki.statsvn.org">Wiki site</a> and inclusion of the forums as embedded pages: <a href="forum.html">User Forum</a>
    and <a href="dev-forum.html">Developers Forum</a>. Enjoy!</p>

    <p>2008-05-04 <a href="http://www.appendium.com">Appendium Ltd</a> and <a href="http://www.lavablast.com">LavaBlast</a> are pleased to announce the release of version 0.4.0 of StatSVN. More details on <a href="http://blog.lavablast.com/post/2008/03/Upcoming-StatCVSStatSVN-release.aspx">this blog!</a> and the <a href="changes-report.html">changelog</a>. </p>
	
    <p>2007-03-10 <strong>News</strong>: As part of release 0.3.1, we have launched a series of <a href="demo">demos</a> for some known projects: Subversion, Ant, Log4J, Spring Rich Client, Hibernate 3, Joda Time, Ruby, Groovy, Grails and Felix to start with.
    Go on, admit it, you always wanted to know who did what and when on those projects...
    <a href="http://digg.com/submit?phase=2&amp;url=www.statsvn.org&amp;title=StatSVN%200%2E3%2E1%20releases%20stats%20for%20well%20know%20OS%20projects&amp;bodytext=StatSVN%20and%20ObjectLab%20have%20released%20version%200%2E3%2E1%20of%20StatSVN%3A%20subversion%20statistics%20for%20Subversion%2E%20This%20release%20includes%20a%20demo%20site%20with%20statistics%20for%20some%20known%20projects%3A%20Subversion,%20Log4J,%20Spring%20Rich%20Client,%20Hibernate%203,%20Joda%20Time,%20Ruby,%20Groovy,%20Grails%20and%20Felix%20to%20start%20with&amp;topic=programming">
	<img src="http://digg.com/img/badges/91x17-digg-button.png" width="91" height="17" alt="Digg!" style="vertical-align:middle" /></a></p>
    
    <p><strong>Warning</strong>: if you're not using an English locale, please set the LANG environment variable to en_US when running the application until we resolve some i18n issues with StatSVN
    (the call to svn diff returns a localised string which may result in some results not being cached, the results are correct but StatSVN will ask for them again next time).</p>
	
	<p>2007-02-07: Want to help? We're considering replacing our command line invocations with calls to <a href="http://www.svnkit.com">SVNKit</a> (formerly JavaSVN). Want to write the prototype implementation and see how well it performs? Let us know!</p>
		
    <p>2007-01-12: Version 0.3.0 is in SVN and adds 2 reports (RepoMap and LOC/Churn) as well as fixing a number of issues with
    moving files, directories and deletion of those. More details on <a href="changes-report.html">this page</a>.</p>

    <p>2006-11-28: Version 0.2.0 is out and now supports Html and XDoc generation to ease integration with Maven (see <a href="statsvn/index.html">reports here</a>).
    <a href="http://digg.com/submit?phase=2&amp;url=www.statsvn.org&amp;title=StatSVN%3A%20Development%20Statistics%20from%20your%20Subversion%20Repository&amp;bodytext=The%20StatSVN%20team%20and%20ObjectLab%20are%20pleased%20to%20announce%20release%200%2E2%2E0%20of%20StatSVN,%20a%20tool%20that%20produces%20charts%20and%20reports%20such%20as%20the%20lines%20of%20code%20over%20time,%20per%20module%20and%20per%20developer%2E%20This%20release%20includes%20Html%20and%20Xdoc%20generation%20for%20easy%20integration%20with%20Maven%2E%20StatSVN%20is%20supported%20by%20ObjectLab%2Eco%2Euk&amp;topic=programming">
	<img src="http://digg.com/img/badges/91x17-digg-button.png" width="91" height="17" alt="Digg!" style="vertical-align:middle" /></a></p>
    <p>We're also pleased to mention that there is a Maven 2 plugin using StatSVN, it is available at <a href="http://stat-scm.sourceforge.net">http://stat-scm.sourceforge.net</a>.</p>
    <p><a href="http://feeds.feedburner.com/ObjectLabOpenSourceNews" rel="alternate" type="application/rss+xml"><img src="http://www.feedburner.com/fb/images/pub/feed-icon16x16.png" alt="" style="vertical-align:middle;border:0"/></a> <a href="http://feeds.feedburner.com/ObjectLabOpenSourceNews" rel="alternate" type="application/rss+xml">Subscribe to the ObjectLab Open Source News</a> (which includes news about StatSVN).</p>
    </section>

    <section name="So, what is StatSVN? Great statistics for SVN!">
    <p>StatSVN retrieves information from a Subversion repository and generates various tables and charts describing the project development, e.g.
    <ul>
    <li><a href="statsvn/loc.html">Timeline</a> for the lines of code</li>
    <li>Lines of code for each <a href="statsvn/developers.html">developer</a></li>
    <li>Activity by <a href="statsvn/developers.html#Activity_by_Clock_Time">Clock time</a></li>
    <li><a href="statsvn/developers.html#Author_Activity">Authors Activity</a></li>
    <li>Author activity per <a href="statsvn/user_jkealey.html#Modules">Module</a></li>
    <li>Author <a href="statsvn/user_jkealey.html#Most_Recent_Commits">Most Recent Commits</a> with links to ViewVc</li>
    <li>Stats per <a href="statsvn/dir_src_net_sf_statsvn_output.html">directory</a></li>
    <li><a href="statsvn/file_sizes.html#File_Count">File count</a></li>
    <li><a href="statsvn/file_sizes.html#Average_File_Size">Average file size</a></li>
    <li><a href="statsvn/file_sizes.html#Largest_Files">Largest files</a></li>
    <li><a href="statsvn/file_sizes.html#Files_With_Most_Revisions">Files with most revisions</a></li>
    <li><a href="statsvn/dir_sizes.html#Directory_Sizes">Directory Sizes</a></li>    
    <li><a href="statsvn/index.html#Repository_Tags">Repository Tags</a> Number of LOC per version.</li>
    <li><a href="statsvn/index.html#Directories">Repository tree</a> with file count and lines of code</li>
    <li><a href="statsvn/churn.html">LOC and Churn</a> the evolution of LOC and the amount of change per day</li>
    <li><a href="statsvn/repomap.html">Repo Map</a> the dynamic hierarchical view of your repo for the last 30 days</li>
    </ul>
    
    The current version of StatSVN generates a static suite of 
    HTML documents containing tables and chart images. StatSVN is open source software, released under the terms of the LGPL, based on StatCVS. 
    StatSVN uses JFreeChart to generate charts.</p>
    <p><img src="statsvn/loc_small.png"/></p>
    </section>
    
    <section name="Where is the manual?">
    <p>The manual is available online as a <a href="http://wiki.statsvn.org/">Wiki</a> and it is as up-to-date and comprehensive as you want it to be...</p>
    </section>

    <section name="Quick Example for Maven 1">
    <p>Prior to run maven site (or simply maven xdoc), you can generate the XDOC files by running:
    <source>
svn log -v --xml https://svn.sourceforge.net/svnroot/statsvn/ > svn.log
java -jar statsvn.jar -xdoc -verbose -output-dir site\statsvn -tags "^0.2.0|^0.1.3|^0.1.2|^0.0.9" -title StatSVN 
     -exclude "**/qalab.xml|**/*.pdf|**/etc/LICENSE" -viewvc http://svn.sourceforge.net/viewvc/statsvn/trunk ./svn.log .
</source>This example will generate xdoc in directory site/statsvn, tag 0.2.0, 0.1.3, 0.1.2, 0.0.9, exclude qalab.xml and others. After that the XDOC would be picked up
by "maven site" or "maven xdoc". Please note that in order to use the tags, you must use a log file not at 'trunk' level but just above, in order to include
the tags directory. At the moment, StatSVN only works with "/tags/" directory.</p>
    
    </section>

    <section name="Quick Example of new 'dump'">
    <p>There is a new dump facility
    <source>
svn log -v --xml https://svn.sourceforge.net/svnroot/statsvn/ > svn.log
java -jar statsvn.jar -dump -verbose -exclude "**/qalab.xml|**/*.pdf|**/etc/LICENSE" ./svn.log .
</source>This will generate a large amount of output but at the end this, if it shows OK for everything it is likely that StatSVN correctly understood your repository:
<source>
----------------------------------
Current Repo Line Code :10508
-----Via Files--------------------
Number of Files via Files  :421
Sum Current LOC via File   :10508       Diff with Repo LOC 0 OK
# of File Revision via File:1902
-----Via Revisions----------------
# of Files via Revisions   :421         Diff with via Files:0 OK
# of File Revision via Revi:1902        Diff with via Files:0 OK
Sum Delta via Revisions    :10508       Diff with Repo LOC 0 OK
Tot LOC via Last Rev file  :10508       Diff with Repo LOC 0 OK
----------------------------------</source></p>    
    </section>


  </body>
</document>