diff options
author | Rafael Garcia-Suarez <rgarciasuarez@gmail.com> | 2005-03-30 08:03:13 +0000 |
---|---|---|
committer | Rafael Garcia-Suarez <rgarciasuarez@gmail.com> | 2005-03-30 08:03:13 +0000 |
commit | 9d70ac1bf1ad8f13286afaa13cb098444403f9fb (patch) | |
tree | 64627726ff32ee90f3a68c4bdf10aeea1ee14ee0 /ext/File | |
parent | 6bd08436b5facfa8804866632e55b76c48986285 (diff) | |
download | perl-9d70ac1bf1ad8f13286afaa13cb098444403f9fb.tar.gz |
Minor POD nits.
p4raw-id: //depot/perl@24098
Diffstat (limited to 'ext/File')
-rw-r--r-- | ext/File/Glob/Glob.pm | 38 |
1 files changed, 19 insertions, 19 deletions
diff --git a/ext/File/Glob/Glob.pm b/ext/File/Glob/Glob.pm index ac6eaafb3c..28af8a8a4f 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<a{b,c,d}e> is a shorthand for C<abe ace ade>. 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<bsd_glob "a* b*">, you should -probably throw them in a set as in C<bsd_glob "{a*,b*}">. This is because +If you want to use multiple patterns, e.g. C<bsd_glob("a* b*")>, you should +probably throw them in a set as in C<bsd_glob("{a*,b*}")>. 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. |