[pkg-java] r6607 - in trunk/statcvs/debian: . manpages

[fourmond at alioth.debian.org]

Author: fourmond
Date: 2008-06-27 22:44:20 +0000 (Fri, 27 Jun 2008)
New Revision: 6607

Modified:
   trunk/statcvs/debian/changelog
   trunk/statcvs/debian/manpages/statcvs.1
Log:
[statcvs] Improvements in packaging of the newer upstream release

Modified: trunk/statcvs/debian/changelog
===================================================================
--- trunk/statcvs/debian/changelog	2008-06-26 16:19:42 UTC (rev 6606)
+++ trunk/statcvs/debian/changelog	2008-06-27 22:44:20 UTC (rev 6607)
@@ -1,15 +1,16 @@
 statcvs (1:0.4.0.dfsg-1) UNRELEASED; urgency=low
 
-  * New upstream release: updated debian/new-upstream to cope for the
-    new test files in the archive
-  * Updated 01-disable-unjar, to remove various tests and to
-    have jar as the default build target.
-  * Disabling 10-fix-null-exception, not needed anymore
+  * New upstream release (closes: #481798): 
+    - updated debian/new-upstream to cope for the new test 
+      files in the archive
+    - Updated 01-disable-unjar, to remove various tests and to
+      have jar as the default build target.
+    - Disabling 10-fix-null-exception, not needed anymore
   * Now depends on libjdom-java as well
   * Fix the old-fsf-address-in-copyright-file lintian warning
-  * DOES NOT CURRENTLY WORK !!!!!
+  * Improved manual page
 
- -- Vincent Fourmond <fourmond at debian.org>  Wed, 07 May 2008 21:48:37 +0200
+ -- Vincent Fourmond <fourmond at debian.org>  Wed, 25 Jun 2008 21:19:23 +0200
 
 statcvs (1:0.3.dfsg+1-1) unstable; urgency=low
 

Modified: trunk/statcvs/debian/manpages/statcvs.1
===================================================================
--- trunk/statcvs/debian/manpages/statcvs.1	2008-06-26 16:19:42 UTC (rev 6606)
+++ trunk/statcvs/debian/manpages/statcvs.1	2008-06-27 22:44:20 UTC (rev 6607)
@@ -18,10 +18,16 @@
 .SH NAME
 statcvs \- CVS Repository statistic analysis tool, written in Java
 .SH SYNOPSIS
+
+.\" TODO: document that the command cvs log must be run from within
+.\" the checkout directory.
+.B cvs log > 
+.I cvs-logfile.log
+
 .B statcvs
-.RI [ options ]
-.RI <logfile>
-.RI <directory>
+.I [ options ]
+.I path/to/cvs-logfile.log
+.I path/to/checkout
 .br
 .SH DESCRIPTION
 This manual page documents briefly the
@@ -33,7 +39,8 @@
 .\" TeX users may be more comfortable with the \fB<whatever>\fP and
 .\" \fI<whatever>\fP escape sequences to invode bold face and italics, 
 .\" respectively.
-\fBstatcvs\fP is a program that retrieves information from
+.B statcvs
+is a program that retrieves information from
 a CVS repository and generates
 various tables and charts describing
 the project development,
@@ -48,10 +55,17 @@
 .br
 StatCvs uses JFreeChart to generate charts.
 .TP
-.B <logfile>
-path to the cvs logfile of the module
+.I  cvs-logfile.log
+path to the cvs logfile of the module.
+.B Important note: 
+statcvs will fail if the log file was not produced with 
+.B cvs
+from within the checkout. It however does not matter if the file is
+not in the directory you're running 
+.B statcvs
+from.
 .TP
-.B <directory>
+.I path/to/checkout
 path to the directory of the checked out module
 
 .SH OPTIONS