Your message dated Sat, 2 Apr 2016 12:55:31 +0100
with message-id <[email protected]>
and subject line Re: Bug#278322: perl-base: 'man perl' lists switches, but no
descriptions
has caused the Debian Bug report #278322,
regarding perl-base: 'man perl' lists switches, but no descriptions
to be marked as done.
This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.
(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact [email protected]
immediately.)
--
278322: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=278322
Debian Bug Tracking System
Contact [email protected] with problems
--- Begin Message ---
Package: perl-base
Version: 5.8.4-2.3
Severity: normal
I type 'man perl', and on the first page, under SYNOPSIS, there are
many command line switches:
perl [ -sTuU ] [ -hv ] [ -V[:configvar] ]
[ -cw ] [ -d[:debugger] ] [ -D[number/list] ]
[ -pna ] [ -Fpattern ] [ -l[octal] ] [ -0[octal] ]
[ -Idir ] [ -m[-]module ] [ -M[-]'module...' ]
[ -P ] [ -S ] [ -x[dir] ]
[ -i[extension] ] [ -e 'command' ] [ -- ] [ programfile ] [ argu-
ment ]...
...yet in the rest of the manual these switches are hardly mentioned.
There's a long list of perl help files, with descriptions, but those
descriptions don't even contain the keywords "command" or "switch".
Not till three pages in does one find:
perlrun Perl execution and options
Compare this to 'man gcc', 'man python', 'man ruby', etc... those
pages show the switches, then describe them under OPTIONS.
Suggestions: perhaps '/usr/share/man/man1/perl.1.gz' should contain
more of more of '/usr/share/man/man1/perlrun.1.gz'. Lacking that
an OPTIONS section might be added to refer the user to 'man perlrun'.
Hope this helps...
-- System Information:
Debian Release: 3.1
APT prefers unstable
APT policy: (500, 'unstable'), (1, 'experimental')
Architecture: i386 (i686)
Kernel: Linux 2.4.26-1-686
Locale: LANG=C, LC_CTYPE=C (charmap=ANSI_X3.4-1968) (ignored: LC_ALL set to C)
Versions of packages perl-base depends on:
ii libc6 2.3.2.ds1-18 GNU C Library: Shared libraries an
-- no debconf information
--- End Message ---
--- Begin Message ---
Version: 5.18.0~rc1-1
On Tue, Oct 26, 2004 at 02:09:56AM -0400, A Costa wrote:
> Package: perl-base
> Version: 5.8.4-2.3
> Severity: normal
>
>
> I type 'man perl', and on the first page, under SYNOPSIS, there are
> many command line switches:
>
> perl [ -sTuU ] [ -hv ] [ -V[:configvar] ]
> [ -cw ] [ -d[:debugger] ] [ -D[number/list] ]
> [ -pna ] [ -Fpattern ] [ -l[octal] ] [ -0[octal] ]
> [ -Idir ] [ -m[-]module ] [ -M[-]'module...' ]
> [ -P ] [ -S ] [ -x[dir] ]
> [ -i[extension] ] [ -e 'command' ] [ -- ] [ programfile ] [ argu-
> ment ]...
>
> ...yet in the rest of the manual these switches are hardly mentioned.
> There's a long list of perl help files, with descriptions, but those
> descriptions don't even contain the keywords "command" or "switch".
> Not till three pages in does one find:
>
> perlrun Perl execution and options
>
> Compare this to 'man gcc', 'man python', 'man ruby', etc... those
> pages show the switches, then describe them under OPTIONS.
>
> Suggestions: perhaps '/usr/share/man/man1/perl.1.gz' should contain
> more of more of '/usr/share/man/man1/perlrun.1.gz'. Lacking that
> an OPTIONS section might be added to refer the user to 'man perlrun'.
This is now more promininent:
SYNOPSIS
perl [ -sTtuUWX ] [ -hv ] [ -V[:configvar] ]
[ -cw ] [ -d[t][:debugger] ] [ -D[number/list] ]
[ -pna ] [ -Fpattern ] [ -l[octal] ] [ -0[octal/hexadecimal] ]
[ -Idir ] [ -m[-]module ] [ -M[-]'module...' ] [ -f ] [ -C
[number/list] ]
[ -S ] [ -x[dir] ] [ -i[extension] ]
[ [-e|-E] 'command' ] [ -- ] [ programfile ] [ argument ]...
For more information on these options, you can run "perldoc perlrun".
Closing this bug.
Thanks,
Dominic.
--- End Message ---
