From: Paul Fenwick <pjf@perltraining.com.au>
Date: Thu, 26 Jun 2008 11:41:45 +0000 (+1000)
Subject: Re: [perl #56348] [PATCH] glob() with spaces - documentation unclear
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=5c0c92498b6ba0a383a35500e079d57433a354d4;p=p5sagit%2Fp5-mst-13.2.git

Re: [perl #56348] [PATCH] glob() with spaces - documentation unclear
Message-ID: <4862F3D9.5010105@perltraining.com.au>

p4raw-id: //depot/perl@34089
---

diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod
index 840ddbc..e5518af 100644
--- a/pod/perlfunc.pod
+++ b/pod/perlfunc.pod
@@ -2348,8 +2348,14 @@ implementing the C<< <*.c> >> operator, but you can use it directly. If
 EXPR is omitted, C<$_> is used.  The C<< <*.c> >> operator is discussed in
 more detail in L<perlop/"I/O Operators">.
 
+Note that C<glob> will split its arguments on whitespace, treating
+each segment as separate pattern.  As such, C<glob('*.c *.h')> would
+match all files with a F<.c> or F<.h> extension.  The expression
+C<glob('.* *')> would match all files in the current working directory.
+
 Beginning with v5.6.0, this operator is implemented using the standard
-C<File::Glob> extension.  See L<File::Glob> for details.
+C<File::Glob> extension.  See L<File::Glob> for details, including
+C<bsd_glob> which does not treat whitespace as a pattern separator.
 
 =item gmtime EXPR
 X<gmtime> X<UTC> X<Greenwich>