slive 01/07/15 18:38:47 Modified: htdocs/manual/mod directive-dict.html.en Log: Some updates to the directive dictionary. Primarily, this prepares for a little standardization of the "syntax" field of directive definitions to use common argument types. Other than that, there are a couple little changes: - Clarify that arguments to directives are space-separated. - Add a coment about the "default" field, since people are submitting bug reports claiming the "default" is wrong since httpd.conf-default says something different. Comments about the argument type standardizations are still very welcome. My next planned activity is going through core.html to make it match what I have written here. Revision Changes Path 1.5 +86 -8 httpd-docs-1.3/htdocs/manual/mod/directive-dict.html.en Index: directive-dict.html.en =================================================================== RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/mod/directive-dict.html.en,v retrieving revision 1.4 retrieving revision 1.5 diff -u -d -b -u -r1.4 -r1.5 --- directive-dict.html.en 2000/12/06 05:12:12 1.4 +++ directive-dict.html.en 2001/07/16 01:38:47 1.5 @@ -87,15 +87,91 @@ configuration file. This syntax is extremely directive-specific, and is described in detail in the directive's definition. Generally, the directive name is followed by a series of one or - more arguments. Optional arguments are enclosed in square brackets. - Where an argument can take on more than one possible value, possible - values are separated by a vertical bar. Literal text is presented - in the default font, while argument-types for which substitution - is necessary are emphasized. Directives which can take a variable - number of arguments will end in "..." indicating that the last - argument is repeated. + more space-separated arguments. If an argument contains a space, + the argument must be enclosed in double quotes. Optional arguments + are enclosed in square brackets. Where an argument can take on more + than one possible value, the possible values are separated by + vertical bars "|". Literal text is presented in the default font, + while argument-types for which substitution is necessary are + emphasized. Directives which can take a variable number of + arguments will end in "..." indicating that the last argument is + repeated.+
+ Directives use a great number of different argument types. + A few common ones are defined below.+ +
/path/to/file.html. The url-path +represents a web-view of a resource, as opposed to a file-system +view.
/usr/local/apache/htdocs/path/to/file.html. Unless +otherwise specified, a file-path which does not begin with a +slash will be treated as relative to the ServerRoot.
/usr/local/apache/htdocs/path/to/. + +
file.html.encontains two extensions:
.en. For Apache directives, you may specify +extensions with or without the leading dot. In addition, +extensions are not case sensitive.
text/html. + +
@@ -103,7 +179,9 @@ from your configuration entirely, the Apache Web server will behave as though you set it to a particular value), it is described here. If there is no default value, this section should say - "None". + "None". Note that the default listed here is not + necessarily the same as the value the directive takes in the + default httpd.conf distributed with the server.