Slight tweak following a comment from noodl.
Apologies for the volume of mail, I promise to sort it. Honest :)
--
Tony
Tony Stevenson wrote:
Hi,
Please find attached a patch for Trunk : /custom-error.xml
Most of the changes were to bring the text up-to-date, i.e.
"Apache/0.8.15" will become "Apache/2.2.4"
--
Tony
------------------------------------------------------------------------
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
Index: custom-error.xml
===================================================================
--- custom-error.xml (revision 541699)
+++ custom-error.xml (working copy)
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="UTF-8" ?>
+<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="./style/manual.en.xsl"?>
<!-- $LastChangedRevision$ -->
@@ -25,14 +25,13 @@
<title>Custom Error Responses</title>
<summary>
- <p>Additional functionality allows webmasters to configure the response
- of Apache to some error or problem.</p>
+ <p>This function allows webmasters to configure the response
+ of Apache to specific HTTP error codes. Customizable responses
+ can be defined to be sent in the event of a server detected
+ error or problem.</p>
- <p>Customizable responses can be defined to be activated in the event of
- a server detected error or problem.</p>
-
- <p>If a script crashes and produces a "500 Server Error" response,
- then this response can be replaced with either some friendlier text or by
+ <p>For example if a script crashes and produces a "500 Server Error"
response,
+ this response can then be replaced with either some more informative text
or by
a redirection to another URL (local or external).</p>
</summary>
@@ -42,9 +41,10 @@
<section>
<title>Old Behavior</title>
- <p>NCSA httpd 1.3 would return some boring old error/problem message
- which would often be meaningless to the user, and would provide no
- means of logging the symptoms which caused it.</p>
+ <p>Older webservers would often return some rather simple statement
+ stating that there had been a problem. These error messages would
usually
+ be meaningless to the user, and would provide no means of logging the
+ symptoms, or offer any help in diagnosing the fault.</p>
</section>
<section>
@@ -53,8 +53,7 @@
<p>The server can be asked to:</p>
<ol>
- <li>Display some other text, instead of the NCSA hard coded
- messages, or</li>
+ <li>Display some other text, rather than displaying its default
message, or</li>
<li>redirect to a local URL, or</li>
@@ -75,12 +74,12 @@
9000/712)<br />
REDIRECT_PATH=.:/bin:/usr/local/bin:/etc<br />
REDIRECT_QUERY_STRING=<br />
- REDIRECT_REMOTE_ADDR=121.345.78.123<br />
- REDIRECT_REMOTE_HOST=ooh.ahhh.com<br />
- REDIRECT_SERVER_NAME=crash.bang.edu<br />
+ REDIRECT_REMOTE_ADDR=123.234.78.123<br />
+ REDIRECT_REMOTE_HOST=user-host.example.com<br />
+ REDIRECT_SERVER_NAME=www.example.com<br />
REDIRECT_SERVER_PORT=80<br />
- REDIRECT_SERVER_SOFTWARE=Apache/0.8.15<br />
- REDIRECT_URL=/cgi-bin/buggy.pl
+ REDIRECT_SERVER_SOFTWARE=Apache/2.2.4<br />
+ REDIRECT_URL=/cgi-bin/error500.pl
</example>
<p>Note the <code>REDIRECT_</code> prefix.</p>
@@ -107,10 +106,10 @@
<p>Here are some examples...</p>
<example>
- ErrorDocument 500 /cgi-bin/crash-recover <br />
+ ErrorDocument 500 /cgi-bin/error500.pl <br />
ErrorDocument 500 "Sorry, our script crashed. Oh dear" <br />
- ErrorDocument 500 http://xxx/ <br />
- ErrorDocument 404 /Lame_excuses/not_found.html <br />
+ ErrorDocument 500 http://www.example.com/ <br />
+ ErrorDocument 404 /sysdir/not_found.html <br />
ErrorDocument 401 /Subscription/how_to_subscribe.html
</example>
@@ -120,12 +119,12 @@
ErrorDocument <3-digit-code> <action>
</example>
- <p>where the action can be,</p>
+ <p>Where the action can be,</p>
<ol>
<li>Text to be displayed. Prefix the text with a quote
("). Whatever follows the quote is displayed. <em>Note:
- the (") prefix isn't displayed.</em></li>
+ the (") prefix isn't displayed in the error message sent to the
user.</em></li>
<li>An external URL to redirect to.</li>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]