Skip to content

Commit 057da2d

Browse files
committed
Resolves bz66405:
Clarifies that IgnoreIndex is not equivalent to a unix glob-style matching. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1932828 13f79535-47bb-0310-9956-ffa450edef68
1 parent f542420 commit 057da2d

1 file changed

Lines changed: 25 additions & 5 deletions

File tree

docs/manual/mod/mod_autoindex.xml

Lines changed: 25 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -517,16 +517,36 @@ a directory</description>
517517
<usage>
518518
<p>The <directive>IndexIgnore</directive> directive adds to the
519519
list of files to hide when listing a directory. <var>File</var> is a
520-
shell-style wildcard expression or full
521-
filename. Multiple IndexIgnore directives add
522-
to the list, rather than replacing the list of ignored
523-
files. By default, the list contains <code>.</code> (the current
524-
directory).</p>
520+
filename or pattern which may contain the <code>?</code> and
521+
<code>*</code> wildcard characters. <code>?</code> matches any
522+
single character, and <code>*</code> matches any sequence of
523+
characters, including an empty sequence. Multiple IndexIgnore
524+
directives add to the list, rather than replacing the list of
525+
ignored files. By default, the list contains <code>.</code> (the
526+
current directory).</p>
525527

526528
<highlight language="config">
527529
IndexIgnore .??* *~ *# HEADER* README* RCS CVS *,v *,t
528530
</highlight>
529531

532+
<p>If <var>File</var> contains a <code>/</code> character, only
533+
the portion after the last <code>/</code> is used for matching
534+
against filenames. For example, <code>*/.??*</code> is equivalent
535+
to <code>.??*</code>.</p>
536+
537+
<note><title>Differences from shell wildcard patterns</title>
538+
<p>The wildcard matching used here is <em>not</em> the same as
539+
shell-style (glob) filename pattern matching. In particular:</p>
540+
<ul>
541+
<li>Bracket expressions such as <code>[abc]</code> or
542+
<code>[!.]</code> are not supported; they are treated as
543+
literal characters.</li>
544+
<li>A leading <code>.</code> in a filename is not treated
545+
specially. For example, <code>*~</code> will match
546+
<code>.example~</code>, whereas a shell glob would not.</li>
547+
</ul>
548+
</note>
549+
530550
<note><title>Regular Expressions</title>
531551
<p>This directive does not currently work in configuration sections
532552
that have regular expression arguments, such as <directive

0 commit comments

Comments
 (0)