[ID 20000424.004] 5.6 File::Glob documentation insufficient for use

The globbing described by the File::Glob manpage, which is also used
for the default globbing in 5.6, does not give any definition or even
enough examples to know what is provided and what is not.  (Older
Perls got away with "this does what your shell does", but that's no
longer true.)

I suppose I could wander through the source to find out, but a quick
description would be good on the manpage for those that don't have the
wherewithall to do that.

For example, I suspect the following is supported:

        [abc0-9]
        *
        ?
        non-matching of "." unless explicit
        multi-level like /*/*/foo.c
        \-quoting

because these are in V7 glob.  But I also see examples that show
csh-style globbing with "{foo,bar}*.c".  So, I'm left baffled with the
manpage, and I bet dozens of other users are as well.

• [ID 20000424.004] 5.6 File::Glob documentation insufficient for use by merlyn
• [perl #3149] 5.6 File::Glob documentation insufficient for use by James Keenan via RT