[Pgp-tools-commit] r380 - in trunk: debian springgraph

[thijs at alioth.debian.org]

Author: thijs
Date: 2008-04-30 19:38:14 +0000 (Wed, 30 Apr 2008)
New Revision: 380

Modified:
   trunk/debian/changelog
   trunk/springgraph/springgraph
   trunk/springgraph/springgraph.1
Log:
springgraph: clarify help text (Closes: 474351).

Modified: trunk/debian/changelog
===================================================================
--- trunk/debian/changelog	2008-04-30 19:20:21 UTC (rev 379)
+++ trunk/debian/changelog	2008-04-30 19:38:14 UTC (rev 380)
@@ -2,8 +2,9 @@
 
   * gpg-mailkeys: Fix parameter escaping of printf, thanks
     Olivier Tetard (Closes: #478151).
+  * springgraph: clarify help text (Closes: 474351).
 
- -- Thijs Kinkhorst <thijs at debian.org>  Wed, 30 Apr 2008 21:19:19 +0200
+ -- Thijs Kinkhorst <thijs at debian.org>  Wed, 30 Apr 2008 21:37:41 +0200
 
 signing-party (1.0-1) unstable; urgency=low
 

Modified: trunk/springgraph/springgraph
===================================================================
--- trunk/springgraph/springgraph	2008-04-30 19:20:21 UTC (rev 379)
+++ trunk/springgraph/springgraph	2008-04-30 19:38:14 UTC (rev 380)
@@ -74,7 +74,6 @@
 # v0.80 Mar 19 2003 optimization patch from Marco Bodrato
 # v0.81 Aug 20 2003 Caption stderr progress notes
 
-use GD;
 use Getopt::Std;
 use strict;
 use vars qw(
@@ -180,6 +179,13 @@
 
 getopts('s:pvhtb:l:');
 
+# -h: Show some help
+if ($opt_h) {
+  usage();
+  exit 1;
+}
+use GD;
+
 # -s: set scale
 if ($opt_s)
 {
@@ -204,11 +210,6 @@
   $vrml = 0;
 }
 
-# -h: Show some help
-if ($opt_h) {
-  usage();
-  exit 1;
-}
 
 # -t: Make background transparent
 if ($opt_t)
@@ -880,9 +881,12 @@
 
 sub usage {
 print <<END
-springgraph - Render a .dot file into a graphic
+springgraph - Render a .dot file into a graphic, taking that dot file
+              on standard in and delivering a PNG on standard out.
 
-Usage: springgraph [-p] [-v] [-s scale] [-t] [-b color] [-l color] [-h]
+Usage:
+  springgraph [-p] [-v] [-s scale] [-t] [-b color] [-l color] [-h] \\
+  < example.dot > example.png
 
    -p   Create a file that can be rendered with POV-Ray
    -v   Create a VRML file

Modified: trunk/springgraph/springgraph.1
===================================================================
--- trunk/springgraph/springgraph.1	2008-04-30 19:20:21 UTC (rev 379)
+++ trunk/springgraph/springgraph.1	2008-04-30 19:38:14 UTC (rev 380)
@@ -18,15 +18,9 @@
 .SH NAME
 springgraph \- renders a graph from a .dot file
 .SH SYNOPSIS
-.B springgraph [OPTIONS] < input-file > output-file.png
+.B springgraph [OPTIONS] < input-file.dot > output-file.png
 .br
 .SH DESCRIPTION
-This manual page documents briefly the
-.B springgraph
-command.
-This manual page was written for the Debian distribution
-because the original program does not have a manual page.
-.PP
 Springgraph will read in a .dot file description of a graph, which,
 for each node, specifies its name and which other nodes it is
 connected to, and then renders a graph. The output is a PNG