From: Rafael Garcia-Suarez Date: Wed, 30 Mar 2005 08:03:13 +0000 (+0000) Subject: Minor POD nits. X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=9d70ac1bf1ad8f13286afaa13cb098444403f9fb;p=p5sagit%2Fp5-mst-13.2.git Minor POD nits. p4raw-id: //depot/perl@24098 --- diff --git a/ext/File/Glob/Glob.pm b/ext/File/Glob/Glob.pm index ac6eaaf..28af8a8 100644 --- a/ext/File/Glob/Glob.pm +++ b/ext/File/Glob/Glob.pm @@ -195,10 +195,10 @@ File::Glob - Perl extension for BSD glob routine =head1 SYNOPSIS use File::Glob ':glob'; - + @list = bsd_glob('*.[ch]'); $homedir = bsd_glob('~gnat', GLOB_TILDE | GLOB_ERR); - + if (GLOB_ERROR) { # an error occurred reading $homedir } @@ -215,16 +215,16 @@ File::Glob - Perl extension for BSD glob routine ## override the core glob forcing case insensitivity use File::Glob qw(:globally :nocase); my @sources = <*.{c,h,y}>; - + ## glob on all files in home directory use File::Glob ':globally'; my @sources = <~gnat/*>; =head1 DESCRIPTION -The glob angle-bracket operator <> is a pathname generator that implements the -rules for file name pattern matching used by Unix-like shells such as the -Bourne shell or C shell. +The glob angle-bracket operator C<< <> >> is a pathname generator that +implements the rules for file name pattern matching used by Unix-like shells +such as the Bourne shell or C shell. File::Glob::bsd_glob() implements the FreeBSD glob(3) routine, which is a superset of the POSIX glob() (described in IEEE Std 1003.2 "POSIX.2"). @@ -241,17 +241,17 @@ whereas bsd_glob() considers them as one pattern. =head2 META CHARACTERS - \ Quote the next metacharacter - [] Character class - {} Multiple pattern - * Match any string of characters - ? Match any single character - ~ User name home directory - -The metanotation ``a{b,c,d}e'' is a shorthand for ``abe ace ade''. Left -to right order is preserved, with results of matches being sorted sepa- -rately at a low level to preserve this order. As a special case `{', `}', -and `{}' are passed undisturbed. + \ Quote the next metacharacter + [] Character class + {} Multiple pattern + * Match any string of characters + ? Match any single character + ~ User name home directory + +The metanotation C is a shorthand for C. Left to +right order is preserved, with results of matches being sorted separately +at a low level to preserve this order. As a special case C<{>, C<}>, and +C<{}> are passed undisturbed. =head2 POSIX FLAGS @@ -384,8 +384,8 @@ Be aware that all filenames returned from File::Glob are tainted. =item * -If you want to use multiple patterns, e.g. C, you should -probably throw them in a set as in C. This is because +If you want to use multiple patterns, e.g. C, you should +probably throw them in a set as in C. This is because the argument to bsd_glob() isn't subjected to parsing by the C shell. Remember that you can use a backslash to escape things.