r1508 - packages/libdigest-sha-perl/trunk

[Gunnar Wolf]

Author: gwolf
Date: 2005-11-17 16:04:21 +0000 (Thu, 17 Nov 2005)
New Revision: 1508

Modified:
   packages/libdigest-sha-perl/trunk/shasum
Log:
Added a manpage for /usr/bin/shasum (taken stright from its 'usage' information)


Modified: packages/libdigest-sha-perl/trunk/shasum
===================================================================
--- packages/libdigest-sha-perl/trunk/shasum	2005-11-17 10:12:38 UTC (rev 1507)
+++ packages/libdigest-sha-perl/trunk/shasum	2005-11-17 16:04:21 UTC (rev 1508)
@@ -7,7 +7,45 @@
 	# Version: 5.31
 	# Mon Sep  5 00:52:42 MST 2005
 
+=head1 NAME
 
+shasum - Print or check SHA checksums
+
+=head1 SYNOPSIS
+
+Usage: shasum [OPTION] [FILE]...
+   or: shasum [OPTION] --check [FILE]
+Print or check SHA checksums.
+With no FILE, or when FILE is -, read standard input.
+
+  -a, --algorithm         1 (default), 224, 256, 384, 512
+  -b, --binary            read files in binary mode (default on DOS/Windows)
+  -c, --check             check SHA sums against given list
+  -t, --text              read files in text mode (default)
+
+The following two options are useful only when verifying checksums:
+      --status            don't output anything, status code shows success
+  -w, --warn              warn about improperly formatted MD5 checksum lines
+
+      --help              display this help and exit
+      --version           output version information and exit
+
+The sums are computed as described in FIPS PUB 180-2.  When checking,
+the input should be a former output of this program.  The default
+mode is to print a line with checksum, a character indicating type
+(`*' for binary, ` ' for text), and name for each FILE.
+
+=head1 AUTHOR
+
+Copyright (c) 2003-2005 Mark Shelor <mshelor at cpan.org>.
+
+=head1 SEE ALSO
+
+Shasum is implemented using the Perl module L<Digest::SHA> or 
+L<Digest::SHA::PurePerl>.
+
+=cut
+
 use strict;
 use Getopt::Long;
 
@@ -48,7 +86,7 @@
   -t, --text              read files in text mode (default)
 
 The following two options are useful only when verifying checksums:
-      --status            don't output anything, status code shows success
+      --status            don\'t output anything, status code shows success
   -w, --warn              warn about improperly formatted MD5 checksum lines
 
       --help              display this help and exit
@@ -57,7 +95,7 @@
 The sums are computed as described in FIPS PUB 180-2.  When checking,
 the input should be a former output of this program.  The default
 mode is to print a line with checksum, a character indicating type
-(`*' for binary, ` ' for text), and name for each FILE.
+(\`*\' for binary, \` \' for text), and name for each FILE.
 
 Report bugs to <mshelor at cpan.org>.
 END_OF_USAGE