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

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

Thread Previous | Thread Next
From:
Reuben Thomas
Date:
February 27, 2013 14:06
Subject:
Re: [perl #116963] Add documentation on the advantages of perldoc forman users to perl.pod
Message ID:
CAOnWdoj_PAM_RhF-U1dKV7VnBpqArXqZccH9MdzfZRCi6xXE5w@mail.gmail.com
On 27 February 2013 14:01, H. Merijn Brand via RT
<perlbug-followup@perl.org> wrote:
> there is no -Q option

Thanks, that should have been -q. Revised patch:

diff --git a/pod/perl.pod b/pod/perl.pod
index d3f9c05..2a17ec5 100644
--- a/pod/perl.pod
+++ b/pod/perl.pod
@@ -280,6 +280,12 @@ aux a2p c2ph h2ph h2xs perlbug pl2pm pod2html
pod2man s2p splain xsubpp
 On a Unix-like system, these documentation files will usually also be
 available as manpages for use with the F<man> program.

+Some documentation is not available as man pages, so if a
+cross-reference is not found by man, try it with perldoc.  Perldoc can
+also take you directly to documentation for functions (with the B<-f>
+switch) and FAQ entries (with the B<-q> switch).  For these reasons,
+you may prefer to use perldoc instead of man.
+
 In general, if something strange has gone wrong with your program and you're
 not sure where you should look for help, try making your code comply with
 B<use strict> and B<use warnings>.  These will often point out exactly
--
1.7.10.4


--
http://rrt.sc3d.org

Thread Previous | Thread Next


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About