From: André Malo Date: Wed, 29 Jan 2014 13:28:10 +0000 (+0000) Subject: - apply various table and formatting fixes, which halted the pdflatex run X-Git-Tag: 2.4.8~184 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=cabae8de6aba546e33253956e8a121ffca64c1e8;p=apache - apply various table and formatting fixes, which halted the pdflatex run - also add mod_filter_old.png (converted from .gif), required for inclusion in latex git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1562436 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/developer/API.xml b/docs/manual/developer/API.xml index ab9c5dd707..45cd728b99 100644 --- a/docs/manual/developer/API.xml +++ b/docs/manual/developer/API.xml @@ -387,7 +387,6 @@ int method_number; /* M_GET, M_POST, etc. */
void *per_dir_config;   /* Options set in config files, etc. */
 void *request_config;   /* Notes on *this* request */
-
}; diff --git a/docs/manual/expr.xml b/docs/manual/expr.xml index fcd1ea1280..0d5a29cb00 100644 --- a/docs/manual/expr.xml +++ b/docs/manual/expr.xml @@ -25,17 +25,16 @@ Expressions in Apache HTTP Server -

Historically, there are several syntax variants for expressions used to express - a condition in the different modules of the Apache HTTP Server. - There is some ongoing effort to only use a single variant, called ap_expr, - for all configuration directives. - This document describes the ap_expr expression parser. +

Historically, there are several syntax variants for expressions + used to express a condition in the different modules of the Apache + HTTP Server. There is some ongoing effort to only use a single + variant, called ap_expr, for all configuration directives. + This document describes the ap_expr expression parser.

The ap_expr expression is intended to replace most other - expression variants in HTTPD. For example, the deprecated - SSLRequire expressions can be - replaced by Require expr. -

+ expression variants in HTTPD. For example, the deprecated SSLRequire expressions can be replaced + by Require expr.

If @@ -66,12 +65,16 @@
Grammar in Backus-Naur Form notation -

Backus-Naur Form (BNF) is a notation - technique for context-free grammars, often used to describe the syntax of languages used in computing. +

Backus-Naur + Form (BNF) is a notation technique for context-free grammars, + often used to describe the syntax of languages used in computing. In most cases, expressions are used to express boolean values. - For these, the starting point in the BNF is expr. However, a few directives - like LogMessage accept expressions - that evaluate to a string value. For those, the starting point in the BNF is string. + For these, the starting point in the BNF is expr. + However, a few directives like LogMessage accept expressions + that evaluate to a string value. For those, the starting point in + the BNF is string.

@@ -238,8 +241,9 @@ listfunction ::= listfuncname "(" word ")"
         The DocumentRoot of
             the current vhost
     AUTH_TYPE
-        The configured AuthType
-            (e.g. "basic")
+        The configured AuthType (e.g.
+        "basic")
     CONTENT_TYPE
         The content type of the response
     HANDLER
@@ -288,14 +292,16 @@ listfunction ::= listfuncname "(" word ")"
         The day of the week (starting with 0
             for Sunday)
     TIME
-        The date and time in the format 20101231235959
+        The date and time in the format
+        20101231235959
     SERVER_SOFTWARE
         The server version string
     API_VERSION
         The date of the API version (module magic number)
     
 
-    

Some modules register additional variables, see e.g. mod_ssl.

+

Some modules register additional variables, see e.g. + mod_ssl.

@@ -427,7 +433,8 @@ listfunction ::= listfuncname "(" word ")" "false", or "no" (case insensitive). True otherwise. -R - Same as "%{REMOTE_ADDR} -ipmatch ...", but more efficient + Same as "%{REMOTE_ADDR} -ipmatch ...", but more + efficient @@ -443,7 +450,7 @@ listfunction ::= listfuncname "(" word ")" Modules may register additional functions.

- + @@ -455,7 +462,9 @@ listfunction ::= listfuncname "(" word ")" - + @@ -500,11 +509,11 @@ listfunction ::= listfuncname "(" word ")" the expression. The req_novary function can be used to prevent names from being added to the Vary header.

-

In addition to string-valued functions, there are also list-valued functions which - take one string as argument and return a wordlist, i.e. a list of strings. The wordlist - can be used with the special -in operator. - Functions names are not case sensitive. - Modules may register additional functions.

+

In addition to string-valued functions, there are also + list-valued functions which take one string as argument and return a + wordlist, i.e. a list of strings. The wordlist can be used with the + special -in operator. Functions names are not case + sensitive. Modules may register additional functions.

There are no built-in list-valued functions. mod_ssl provides PeerExtList. See the description of @@ -517,7 +526,8 @@ listfunction ::= listfuncname "(" word ")"

Example expressions -

The following examples show how expressions might be used to evaluate requests:

+

The following examples show how expressions might be used to + evaluate requests:

# Compare the host name to example.com and redirect to www.example.com if it matches @@ -549,7 +559,8 @@ listfunction ::= listfuncname "(" word ")"
- + diff --git a/docs/manual/images/mod_filter_old.png b/docs/manual/images/mod_filter_old.png new file mode 100644 index 0000000000..56c02d834e Binary files /dev/null and b/docs/manual/images/mod_filter_old.png differ diff --git a/docs/manual/mod/mod_alias.xml b/docs/manual/mod/mod_alias.xml index 326f594d27..53088cba4d 100644 --- a/docs/manual/mod/mod_alias.xml +++ b/docs/manual/mod/mod_alias.xml @@ -125,7 +125,9 @@ Alias /foo /gaq URL-path then the server will require a trailing / in order to expand the alias. That is, if you use

-
Alias /icons/ /usr/local/apache/icons/
+ + Alias /icons/ /usr/local/apache/icons/ +

then the url /icons will not be aliased, as it lacks that trailing /. Likewise, if you omit the slash on the diff --git a/docs/manual/mod/mod_proxy_ajp.xml b/docs/manual/mod/mod_proxy_ajp.xml index 4665761ad4..d39bd1293a 100644 --- a/docs/manual/mod/mod_proxy_ajp.xml +++ b/docs/manual/mod/mod_proxy_ajp.xml @@ -194,11 +194,12 @@ ProxyPassReverse /apps/foo http://www.example.com/foo suggest that the maximum payload could be as large as 2^16, in fact, the code sets the maximum to be 8K.

NameDescriptionRestricted
req, http
resp Get HTTP response header
reqenvLookup request environment variable (as a shortcut, v can be used too to access variables).
Lookup request environment variable (as a shortcut, + v can be used too to access + variables).
osenv Lookup operating system environment variable
note string contained in string list
/regexp/ m#regexp#Regular expression (the second form allows different delimiters than /)
Regular expression (the second form allows different + delimiters than /)
/regexp/i m#regexp#i Case insensitive regular expression
+ - + - + @@ -206,7 +207,7 @@ ProxyPassReverse /apps/foo http://www.example.com/foo - + @@ -214,11 +215,12 @@ ProxyPassReverse /apps/foo http://www.example.com/foo
Packet Format (Server->Container)Packet Format (Server->Container)
ByteByte 0 1 24...(n+3)
ContentsContents 0x12 0x34 Data Length (n)
+ - + - + @@ -226,7 +228,7 @@ ProxyPassReverse /apps/foo http://www.example.com/foo - + @@ -241,6 +243,7 @@ ProxyPassReverse /apps/foo http://www.example.com/foo

The web server can send the following messages to the servlet container:

Packet Format (Container->Server)Packet Format (Container->Server)
ByteByte 0 1 24...(n+3)
ContentsContents A B Data Length (n)
+ @@ -282,6 +285,7 @@ ProxyPassReverse /apps/foo http://www.example.com/foo

The servlet container can send the following types of messages to the webserver:

Code Type of Packet
+ diff --git a/docs/manual/mod/mod_remoteip.xml b/docs/manual/mod/mod_remoteip.xml index bb764d33eb..02f680cb41 100644 --- a/docs/manual/mod/mod_remoteip.xml +++ b/docs/manual/mod/mod_remoteip.xml @@ -178,11 +178,11 @@ RemoteIPInternalProxyList conf/trusted-proxies.lst conf/trusted-proxies.lst contents -
+    
 # Our internally trusted proxies;
 10.0.2.0/24         #Everyone in the testing group
 gateway.localdomain #The front end balancer
-         
+
Code Type of Packet