From: Chip Salzenberg Date: Tue, 25 Mar 1997 19:04:34 +0000 (+1200) Subject: Patch for perl.pod X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=fc952deced8adfa1a27dbf2dcdd64176b24c41da;p=p5sagit%2Fp5-mst-13.2.git Patch for perl.pod (this is the same change as commit 69cddaa00596e831c0492189df41823d75a1b069, but as applied) --- diff --git a/pod/perl.pod b/pod/perl.pod index 2c1dde2..fc41582 100644 --- a/pod/perl.pod +++ b/pod/perl.pod @@ -34,7 +34,7 @@ of sections: perlform Perl formats perllocale Perl locale support - perlref Perl references + perlref Perl references perldsc Perl data structures intro perllol Perl data structures: lists of lists perltoot Perl OO tutorial @@ -52,27 +52,38 @@ of sections: perlpod Perl plain old documentation perlbook Perl book information - perlembed Perl how to embed perl in your C or C++ app + perlembed Perl ways to embed perl in your C or C++ application perlapio Perl internal IO abstraction interface perlxs Perl XS application programming interface perlxstut Perl XS tutorial - perlguts Perl internal functions for those doing extensions + perlguts Perl internal functions for those doing extensions perlcall Perl calling conventions from C (If you're intending to read these straight through for the first time, the suggested order will tend to reduce the number of forward references.) -Additional documentation for Perl modules is available in the -F directory. Some of this is distributed standard with -Perl, but you'll also find third-party modules there. You should be able -to view this with your man(1) program by including the proper directories -in the appropriate start-up files. To find out where these are, type: +By default, all of the above manpages are installed in the +F directory. + +Extensive additional documentation for Perl modules is available. The +default configuration for perl will place this additional documentation +in the F directory (or else in the F +subdirectory of the Perl library directory). Some of this additional +documentation is distributed standard with Perl, but you'll also find +documentation for third-party modules there. + +You should be able to view Perl's documentation with your man(1) +program by including the proper directories in the appropriate start-up +files, or in the MANPATH environment variable. To find out where the +configuration has installed the manpages, type: perl -V:man.dir -If the directories were F and F, -you would need to add only F to your MANPATH. If -they are different, you'll have to add both stems. +If the directories have a common stem, such as F +and F, you need only to add that stem +(F) to your man(1) configuration files or your MANPATH +environment variable. If they do not share a stem, you'll have to add +both stems. If that doesn't work for some reason, you can still use the supplied F script to view module information. You might @@ -142,7 +153,7 @@ will continue to work unchanged. Perl variables may now be declared within a lexical scope, like "auto" variables in C. Not only is this more efficient, but it contributes -to better privacy for "programming in the large". Anonymous +to better privacy for "programming in the large". Anonymous subroutines exhibit deep binding of lexical variables (closures). =item * Arbitrarily nested data structures @@ -200,7 +211,7 @@ semantics for undefined subroutine calls. It's not for just autoloading. =item * Regular expression enhancements -You can now specify non-greedy quantifiers. You can now do grouping +You can now specify nongreedy quantifiers. You can now do grouping without creating a backreference. You can now write regular expressions with embedded whitespace and comments for readability. A consistent extensibility mechanism has been added that is upwardly compatible with @@ -215,7 +226,7 @@ code. See F for a site near you. =item * Compilability While not yet in full production mode, a working perl-to-C compiler -does exist. It can generate portable bytecode, simple C, or +does exist. It can generate portable byte code, simple C, or optimized C code. =back