0d26a2bd71224b954baab529bbadc4d676c35b95slive<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
e942c741056732f50da2074b36fe59805d370650slive<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
5f5d1b4cc970b7f06ff8ef6526128e9a27303d88nd<!-- $LastChangedRevision$ -->
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding Licensed to the Apache Software Foundation (ASF) under one or more
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding contributor license agreements. See the NOTICE file distributed with
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding this work for additional information regarding copyright ownership.
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding The ASF licenses this file to You under the Apache License, Version 2.0
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding (the "License"); you may not use this file except in compliance with
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding the License. You may obtain a copy of the License at
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd Unless required by applicable law or agreed to in writing, software
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd distributed under the License is distributed on an "AS IS" BASIS,
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd See the License for the specific language governing permissions and
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd limitations under the License.
0abdaeda8c30d0fd3c1c8766373992560e17a540rbowen<description>Attempts to correct mistaken URLs by ignoring
0abdaeda8c30d0fd3c1c8766373992560e17a540rbowencapitalization, or attempting to correct various minor
0abdaeda8c30d0fd3c1c8766373992560e17a540rbowenmisspellings.</description>
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen <p>Requests to documents sometimes cannot be served by the core
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen apache server because the request was misspelled or
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen miscapitalized. This module addresses this problem by trying to
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen find a matching document, even after all other modules gave up.
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen It does its work by comparing each document name in the
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen requested directory against the requested document name
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen <strong>without regard to case</strong>, and allowing
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen <strong>up to one misspelling</strong> (character insertion /
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen omission / transposition or wrong character). A list is built
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen with all document names which were matched using this
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen strategy.</p>
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen <li>no matching document was found, Apache will proceed as
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen usual and return a "document not found" error.</li>
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen <li>only one document is found that "almost" matches the
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen request, then it is returned in the form of a redirection
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen response.</li>
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen <li>more than one document with a close match was found, then
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen the list of the matches is returned to the client, and the
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen client can select the correct candidate.</li>
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen<directivesynopsis>
860b4efe27e7c1c9a2bf5c872b29c90f76849b51jim<description>Enables the spelling
0d26a2bd71224b954baab529bbadc4d676c35b95slivemodule</description>
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen<contextlist>
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen</contextlist>
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen <p>This directive enables or disables the spelling module. When
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen enabled, keep in mind that</p>
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen <li>the directory scan which is necessary for the spelling
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen correction will have an impact on the server's performance
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen when many spelling corrections have to be performed at the
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen same time.</li>
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen <li>the document trees should not contain sensitive files
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen which could be matched inadvertently by a spelling
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen "correction".</li>
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen <li>the module is unable to correct misspelled user names (as
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen in <code>http://my.host/~apahce/</code>), just file names or
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen directory names.</li>
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen <li>spelling corrections apply strictly to existing files, so
0d26a2bd71224b954baab529bbadc4d676c35b95slive a request for the <code><Location /status></code> may
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen get incorrectly treated as the negotiated file
b9b166bce28378f88ecba40c17f788f510b8357and <!-- XXX: is that really true?! -nd -->
b1d5e64b28c637587fe6809bc1a19be1730545d4martin <p>mod_speling should not be enabled in <a href="mod_dav.html">DAV</a>
b1d5e64b28c637587fe6809bc1a19be1730545d4martin enabled directories, because it will try to "spell fix" newly created
b1d5e64b28c637587fe6809bc1a19be1730545d4martin resource names against existing filenames, e.g., when trying to upload
b1d5e64b28c637587fe6809bc1a19be1730545d4martin a new document <code>doc43.html</code> it might redirect to an existing
b1d5e64b28c637587fe6809bc1a19be1730545d4martin document <code>doc34.html</code>, which is not what was intended.
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen</directivesynopsis>
6666167d402bfbfe002ab2626b788f5822e831e6niq<directivesynopsis>
6666167d402bfbfe002ab2626b788f5822e831e6niq<description>Limits the action of the speling module to case corrections</description>
6666167d402bfbfe002ab2626b788f5822e831e6niq<contextlist>
6666167d402bfbfe002ab2626b788f5822e831e6niq</contextlist>
84802238b3f7b6535810043722d54e535b70e454jailletc <p>When set, this directive limits the action of the spelling correction
6666167d402bfbfe002ab2626b788f5822e831e6niq Other potential corrections are not performed.</p>
6666167d402bfbfe002ab2626b788f5822e831e6niq</directivesynopsis>
84802238b3f7b6535810043722d54e535b70e454jailletc<directivesynopsis>
84802238b3f7b6535810043722d54e535b70e454jailletc<description>Extend the action of the speling module to also check filename
84802238b3f7b6535810043722d54e535b70e454jailletcwithout paying attention to the extention. (e.g. foo.gif and foo.jpg).
84802238b3f7b6535810043722d54e535b70e454jailletcThis can be particulary useful in conjunction with
84802238b3f7b6535810043722d54e535b70e454jailletc<a href="/content-negotiation.html">MultiViews</a></description>
84802238b3f7b6535810043722d54e535b70e454jailletc<contextlist>
84802238b3f7b6535810043722d54e535b70e454jailletc</contextlist>
84802238b3f7b6535810043722d54e535b70e454jailletc <p>This option has no effect if <directive>CheckCaseOnly</directive> is set.</p>
84802238b3f7b6535810043722d54e535b70e454jailletc</directivesynopsis>
15b99496bfd5c7809028689a3accc488b23ab0b4rbowen</modulesynopsis>