summaryrefslogtreecommitdiff
path: root/ext/File
diff options
context:
space:
mode:
authorRafael Garcia-Suarez <rgarciasuarez@gmail.com>2005-03-30 08:03:13 +0000
committerRafael Garcia-Suarez <rgarciasuarez@gmail.com>2005-03-30 08:03:13 +0000
commit9d70ac1bf1ad8f13286afaa13cb098444403f9fb (patch)
tree64627726ff32ee90f3a68c4bdf10aeea1ee14ee0 /ext/File
parent6bd08436b5facfa8804866632e55b76c48986285 (diff)
downloadperl-9d70ac1bf1ad8f13286afaa13cb098444403f9fb.tar.gz
Minor POD nits.
p4raw-id: //depot/perl@24098
Diffstat (limited to 'ext/File')
-rw-r--r--ext/File/Glob/Glob.pm38
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.