develooper Front page | perl.perl5.porters | Postings from February 2013

Re: [perl #116963] Add documentation on the advantages of perldocfor man users to perl.pod

Thread Previous | Thread Next
H.Merijn Brand
February 27, 2013 14:43
Re: [perl #116963] Add documentation on the advantages of perldocfor man users to perl.pod
Message ID:
On Wed, 27 Feb 2013 14:17:57 +0000, Reuben Thomas <> wrote:

> On 27 February 2013 14:15, Dagfinn Ilmari Mannsåker via RT
> <> wrote:
> > Reuben Thomas <> writes:
> >
> >> On 27 February 2013 14:01, H. Merijn Brand via RT
> >> <> wrote:
> >>> there is no -Q option
> >>
> >> Thanks, that should have been -q. Revised patch:
> >
> > You should also metion the C<-v> switch for looking up individual
> > variables in L<perlvar>.
> It is probably as well to agree the patch in principle first. Also,
> every additional switch mentioned adds maintenance burden, and once
> having used perldoc the user can quite easily look up its
> documentation. Hence, I suggest it's better to stick with just one or
> two switches, enough to provide a compelling reason to use perldoc in
> the first place.

You could refer to its own docs, somewhat like
Some documentation is not available as man pages, so if a
cross-reference is not found by man, try it with L<perldoc>.  Perldoc can
also take you directly to documentation for functions (with the B<-f>
switch). See C<perldoc --help> (or C<perldoc perldoc> or C<man perldoc>
for other helpful options L<perldoc> has to offer.

FWIW I think I like the intent of the patch

H.Merijn Brand   Perl Monger
using perl5.00307 .. 5.17   porting perl5 on HP-UX, AIX, and openSUSE

Thread Previous | Thread Next Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About