| Subject: | manual page - unclear option syntax definitions |
Perl: This is perl, v5.10.0 built for x86_64-linux-gnu-thread-multi
OS : Debian/testing
Cf : http://bugs.debian.org/550248
Package: pod2pdf
Version: 0.42-1
Severity: minor
Manual page reads:
perldoc -u File::Find | pod2pdf [options] >File-Find.pdf
Options
pod2pdf accepts the following command-line options:
"--output-file"
Sets the output filename for the generated PDF file. By
default pod2pdf will output to STDOUT.
"--page-size"
Sets the page size to be used in the PDF file, can be set
to any of the standard paper sizes (A4, A5, Letter,
etc). Defaults to A4.
...
Many of these options take arguments, but this isn't expressed in the
option syntax. The options are also presented inside quotes, which is
not typical to manual pages.
SUGGESTION
Please add arguments to the options, make the options appear inbold,
and remove the quoting. An example:
--output-file FILENAME
Sets the output FILENAME for the generated PDF file. By
default pod2pdf will output to STDOUT.
--page-size TYPE
Sets the page size TYPE to be used in the PDF file, can be
set
to any of the standard paper sizes. The TYPE can be A4, A5,
Letter,
etc. Default value is A4.
...