Bug#411028: Harmful 'man pngcrush' typo: "pngcrush [options] [file1.png] [file2.png] ..."

[A. Costa]

After further thought, I now believe most of the brackets in the
current SYNOPSIS aren't needed. Using 'man cp' as a model:

        % man cp | grep -n SYN -A 4
        8:SYNOPSIS
        9-       cp [OPTION]... [-T] SOURCE DEST
        10-       cp [OPTION]... SOURCE... DIRECTORY
        11-       cp [OPTION]... -t DIRECTORY SOURCE...
        12-

Note how 'SOURCE' and others aren't in brackets.  Granted we can use
the '--help' switch and not need a 'SOURCE', but 'man cp' disregards that
as a harmless exception.

If that makes sense, attached is a new '.diff' of
'/usr/share/man/man1/pngcrush.1.gz'.


--- pngcrush.1	2006-12-02 01:54:58.000000000 -0500
+++ /tmp/pngcrush.1	2007-02-16 02:04:50.000000000 -0500
@@ -3,11 +3,11 @@
 pngcrush \(em optimizes (or modifies) PNG (Portable Network Graphics) files. 
 .SH "SYNOPSIS" 
 .PP 
-\fBpngcrush\fR [\fB\fIoptions\fR\fP]  [file1.png]  [file2.png] \fB...\fR 
+\fBpngcrush\fR [\fB\fIoptions\fR\fP]  infile.png  outfile.png 
 .PP 
-\fBpngcrush \-e \fIext\fR\fR [\fB\fIoptions\fR\fP]  [file1.png]  [file2.png] \fB...\fR 
+\fBpngcrush \-e \fIext\fR\fR [\fB\fIoptions\fR\fP]  file1.png  [file2.png] \fB...\fR 
 .PP 
-\fBpngcrush \-d \fIdir\fR\fR [\fB\fIoptions\fR\fP]  [file1.png]  [file2.png] \fB...\fR 
+\fBpngcrush \-d \fIdir\fR\fR [\fB\fIoptions\fR\fP]  file1.png  [file2.png] \fB...\fR 
 .SH "DESCRIPTION" 
 .PP 
 \fBpngcrush\fR is an optimizer for PNG (Portable Network Graphics) files.  Its