Bug#881892: perl-base: File::Glob(3perl) bsd_glob does not document DEFAULT_FLAGS

Niko Tyni ntyni at debian.org
Thu Nov 16 09:29:13 UTC 2017


On Thu, Nov 16, 2017 at 04:40:10PM +1100, Tim Connors wrote:
> On Thu, 16 Nov 2017, Tim Connors wrote:
> > In the one argument form of File::Glob::bsd_glob, the default flags
> > are not documented.  They appear to be GLOB_CSH, although the
> 
> Hmm, it's there, just the summary is far less prominent than I feel it
> should be (usage usually goes at the top, not examples):
> 
>        "bsd_glob"
> 
>        This function, which is included in the two export tags listed above,
>        takes one or two arguments.  The first is the glob pattern.  The second
>        is a set of flags ORed together.  The available flags are listed below
>        under "POSIX FLAGS".  If the second argument is omitted, "GLOB_CSH" (or
>        "GLOB_CSH|GLOB_NOCASE" on VMS and DOSish systems) is used by default.

Thanks. FWIW, the corresponding change was 

 https://perl5.git.perl.org/perl.git/commitdiff/8c9e50e76ac4058a63c63a3d1714aa2556ca9393

And it's in the 'Exports' section, not 'Examples' :)
-- 
Niko Tyni   ntyni at debian.org




More information about the Perl-maintainers mailing list