]> granicus.if.org Git - apache/commitdiff
use example.com instead of other non-standard examples
authorJeff Trawick <trawick@apache.org>
Mon, 6 Dec 2010 18:48:30 +0000 (18:48 +0000)
committerJeff Trawick <trawick@apache.org>
Mon, 6 Dec 2010 18:48:30 +0000 (18:48 +0000)
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1042758 13f79535-47bb-0310-9956-ffa450edef68

12 files changed:
docs/manual/mod/core.xml
docs/manual/mod/mod_alias.xml
docs/manual/mod/mod_authnz_ldap.xml
docs/manual/mod/mod_info.xml
docs/manual/mod/mod_proxy.xml
docs/manual/rewrite/access.xml
docs/manual/rewrite/vhosts.xml
docs/manual/sections.xml
docs/manual/ssl/ssl_howto.xml
docs/manual/vhosts/examples.xml
docs/manual/vhosts/index.xml
docs/manual/vhosts/ip-based.xml

index dceab4a235e222254e06e0a92d0aaa61b3f02687..2a7e82f72ad9a97e3829cbb4fb76dd806f2ff2c3 100644 (file)
@@ -761,7 +761,7 @@ from the web</description>
     </example>
 
     <p>then an access to
-    <code>http://www.my.host.com/index.html</code> refers to
+    <code>http://my.example.com/index.html</code> refers to
     <code>/usr/web/index.html</code>. If the <var>directory-path</var> is 
     not absolute then it is assumed to be relative to the <directive 
     module="core">ServerRoot</directive>.</p>
@@ -3427,8 +3427,8 @@ to name-virtual hosts</description>
 
     <example>
       &lt;VirtualHost *:80&gt;<br />
-      ServerName server.domain.com<br />
-      ServerAlias server server2.domain.com server2<br />
+      ServerName server.example.com<br />
+      ServerAlias server server2.example.com server2<br />
       ServerAlias *.example.com<br />
       UseCanonicalName Off<br />
       # ...<br />
@@ -3896,10 +3896,10 @@ port</description>
     type a shortname, and a URL which is a directory, such as
     <code>http://www/splat</code>, <em>without the trailing
     slash</em> then Apache httpd will redirect them to
-    <code>http://www.domain.com/splat/</code>. If you have
+    <code>http://www.example.com/splat/</code>. If you have
     authentication enabled, this will cause the user to have to
     authenticate twice (once for <code>www</code> and once again
-    for <code>www.domain.com</code> -- see <a
+    for <code>www.example.com</code> -- see <a
     href="http://httpd.apache.org/docs/misc/FAQ.html#prompted-twice">the
     FAQ on this subject for more information</a>). But if
     <directive>UseCanonicalName</directive> is set <code>Off</code>, then
index 513367504bf621d5cf91e8314dea8e4b5f9d31ed..af2f00e8e4184a6f594cbd70458f2bf8637b7688 100644 (file)
@@ -361,7 +361,7 @@ of the current URL</description>
     another server, one might use:</p>
 
     <example>
-      RedirectMatch (.*)\.gif$ http://www.anotherserver.com$1.jpg
+      RedirectMatch (.*)\.gif$ http://other.example.com$1.jpg
     </example>
 
     <p>The considerations related to the difference between
index f503a7d62eae584a9d69e055f5dad4ffa21fd5fa..0cfe0a3250df994eb6d2f3afa3ba5eb27317b0dc 100644 (file)
@@ -337,7 +337,7 @@ for HTTP Basic authentication.</description>
     granted access by using multiple <code>Require ldap-user</code>
     directives, with one user per line. For example, with a <directive
     module="mod_authnz_ldap">AuthLDAPURL</directive> of
-    <code>ldap://ldap/o=Airius?cn</code> (i.e., <code>cn</code> is
+    <code>ldap://ldap/o=Example?cn</code> (i.e., <code>cn</code> is
     used for searches), the following Require directives could be used
     to restrict access:</p>
 <example>
@@ -367,47 +367,47 @@ Require ldap-user "Joe Manager"<br />
     For example, assume that the following entry existed in
     the LDAP directory:</p>
 <example>
-dn: cn=Administrators, o=Airius<br />
+dn: cn=Administrators, o=Example<br />
 objectClass: groupOfUniqueNames<br />
-uniqueMember: cn=Barbara Jenson, o=Airius<br />
-uniqueMember: cn=Fred User, o=Airius<br />
+uniqueMember: cn=Barbara Jenson, o=Example<br />
+uniqueMember: cn=Fred User, o=Example<br />
 </example>
 
     <p>The following directive would grant access to both Fred and
     Barbara:</p>
-<example>Require ldap-group cn=Administrators, o=Airius</example>
+<example>Require ldap-group cn=Administrators, o=Example</example>
 
     <p>Members can also be found within sub-groups of a specified LDAP group
     if <directive module="mod_authnz_ldap">AuthLDAPMaxSubGroupDepth</directive>
     is set to a value greater than 0. For example, assume the following entries
     exist in the LDAP directory:</p>
 <example>
-dn: cn=Employees, o=Airius<br />
+dn: cn=Employees, o=Example<br />
 objectClass: groupOfUniqueNames<br />
-uniqueMember: cn=Managers, o=Airius<br />
-uniqueMember: cn=Administrators, o=Airius<br />
-uniqueMember: cn=Users, o=Airius<br />
+uniqueMember: cn=Managers, o=Example<br />
+uniqueMember: cn=Administrators, o=Example<br />
+uniqueMember: cn=Users, o=Example<br />
 <br />
-dn: cn=Managers, o=Airius<br />
+dn: cn=Managers, o=Example<br />
 objectClass: groupOfUniqueNames<br />
-uniqueMember: cn=Bob Ellis, o=Airius<br />
-uniqueMember: cn=Tom Jackson, o=Airius<br />
+uniqueMember: cn=Bob Ellis, o=Example<br />
+uniqueMember: cn=Tom Jackson, o=Example<br />
 <br />
-dn: cn=Administrators, o=Airius<br />
+dn: cn=Administrators, o=Example<br />
 objectClass: groupOfUniqueNames<br />
-uniqueMember: cn=Barbara Jenson, o=Airius<br />
-uniqueMember: cn=Fred User, o=Airius<br />
+uniqueMember: cn=Barbara Jenson, o=Example<br />
+uniqueMember: cn=Fred User, o=Example<br />
 <br />
-dn: cn=Users, o=Airius<br />
+dn: cn=Users, o=Example<br />
 objectClass: groupOfUniqueNames<br />
-uniqueMember: cn=Allan Jefferson, o=Airius<br />
-uniqueMember: cn=Paul Tilley, o=Airius<br />
-uniqueMember: cn=Temporary Employees, o=Airius<br />
+uniqueMember: cn=Allan Jefferson, o=Example<br />
+uniqueMember: cn=Paul Tilley, o=Example<br />
+uniqueMember: cn=Temporary Employees, o=Example<br />
 <br />
-dn: cn=Temporary Employees, o=Airius<br />
+dn: cn=Temporary Employees, o=Example<br />
 objectClass: groupOfUniqueNames<br />
-uniqueMember: cn=Jim Swenson, o=Airius<br />
-uniqueMember: cn=Elliot Rhodes, o=Airius<br />
+uniqueMember: cn=Jim Swenson, o=Example<br />
+uniqueMember: cn=Elliot Rhodes, o=Example<br />
 </example>
 
     <p>The following directives would allow access for Bob Ellis, Tom Jackson,
@@ -415,7 +415,7 @@ uniqueMember: cn=Elliot Rhodes, o=Airius<br />
     allow access for Jim Swenson, or Elliot Rhodes (since they are at a 
     sub-group depth of 2):</p>
 <example>
-Require ldap-group cn=Employees, o-Airius<br />
+Require ldap-group cn=Employees, o-Example<br />
 AuthLDAPSubGroupDepth 1<br />
 </example>
 
@@ -440,7 +440,7 @@ AuthLDAPSubGroupDepth 1<br />
 
     <p>The following directive would grant access to a specific
     DN:</p>
-<example>Require ldap-dn cn=Barbara Jenson, o=Airius</example>
+<example>Require ldap-dn cn=Barbara Jenson, o=Example</example>
 
     <p>Behavior of this directive is modified by the <directive
     module="mod_authnz_ldap">AuthLDAPCompareDNOnServer</directive>
@@ -505,7 +505,7 @@ AuthLDAPSubGroupDepth 1<br />
         Grant access to anyone who exists in the LDAP directory,
         using their UID for searches. 
 <example>
-AuthLDAPURL "ldap://ldap1.airius.com:389/ou=People, o=Airius?uid?sub?(objectClass=*)"<br />
+AuthLDAPURL "ldap://ldap1.example.com:389/ou=People, o=Example?uid?sub?(objectClass=*)"<br />
 Require valid-user
 </example>
       </li>
@@ -514,7 +514,7 @@ Require valid-user
         The next example is the same as above; but with the fields
         that have useful defaults omitted. Also, note the use of a
         redundant LDAP server. 
-<example>AuthLDAPURL "ldap://ldap1.airius.com ldap2.airius.com/ou=People, o=Airius"<br />
+<example>AuthLDAPURL "ldap://ldap1.example.com ldap2.example.com/ou=People, o=Example"<br />
 Require valid-user
 </example>
       </li>
@@ -529,7 +529,7 @@ Require valid-user
         choose an attribute that is guaranteed unique in your
         directory, such as <code>uid</code>. 
 <example>
-AuthLDAPURL "ldap://ldap.airius.com/ou=People, o=Airius?cn"<br />
+AuthLDAPURL "ldap://ldap.example.com/ou=People, o=Example?cn"<br />
 Require valid-user
 </example>
       </li>
@@ -538,19 +538,19 @@ Require valid-user
         Grant access to anybody in the Administrators group. The
         users must authenticate using their UID. 
 <example>
-AuthLDAPURL ldap://ldap.airius.com/o=Airius?uid<br />
-Require ldap-group cn=Administrators, o=Airius
+AuthLDAPURL ldap://ldap.example.com/o=Example?uid<br />
+Require ldap-group cn=Administrators, o=Example
 </example>
       </li>
 
       <li>
-        The next example assumes that everyone at Airius who
+        The next example assumes that everyone at Example who
         carries an alphanumeric pager will have an LDAP attribute
         of <code>qpagePagerID</code>. The example will grant access
         only to people (authenticated via their UID) who have
         alphanumeric pagers: 
 <example>
-AuthLDAPURL ldap://ldap.airius.com/o=Airius?uid??(qpagePagerID=*)<br />
+AuthLDAPURL ldap://ldap.example.com/o=Example?uid??(qpagePagerID=*)<br />
 Require valid-user
 </example>
       </li>
@@ -566,7 +566,7 @@ Require valid-user
         have a pager, but does need to access the same
         resource:</p>
 <example>
-AuthLDAPURL ldap://ldap.airius.com/o=Airius?uid??(|(qpagePagerID=*)(uid=jmanager))<br />
+AuthLDAPURL ldap://ldap.example.com/o=Example?uid??(|(qpagePagerID=*)(uid=jmanager))<br />
 Require valid-user
 </example>
 
@@ -1047,9 +1047,9 @@ group membership</description>
     membership.  Otherwise, the username will be used. For example,
     assume that the client sent the username <code>bjenson</code>,
     which corresponds to the LDAP DN <code>cn=Babs Jenson,
-    o=Airius</code>. If this directive is set,
+    o=Example</code>. If this directive is set,
     <module>mod_authnz_ldap</module> will check if the group has
-    <code>cn=Babs Jenson, o=Airius</code> as a member. If this
+    <code>cn=Babs Jenson, o=Example</code> as a member. If this
     directive is not set, then <module>mod_authnz_ldap</module> will
     check if the group has <code>bjenson</code> as a member.</p>
 </usage>
@@ -1293,7 +1293,7 @@ You can of course use search parameters on each of these.</p>
     <code>(&amp;(<em>filter</em>)(<em>attribute</em>=<em>username</em>))</code>.</p>
 
     <p>For example, consider an URL of
-    <code>ldap://ldap.airius.com/o=Airius?cn?sub?(posixid=*)</code>. When
+    <code>ldap://ldap.example.com/o=Example?cn?sub?(posixid=*)</code>. When
     a client attempts to connect using a username of <code>Babs
     Jenson</code>, the resulting search filter will be
     <code>(&amp;(posixid=*)(cn=Babs Jenson))</code>.</p>
index fea553bac70494abf283be9d6cd0ed66559b3730..6151a6c3a30727033a28e890e1de622b0567031f 100644 (file)
@@ -50,7 +50,7 @@ configuration</description>
       &lt;Location /server-info&gt;<br />
       <indent>
         SetHandler server-info<br />
-        Require host yourcompany.com<br />
+        Require host example.com<br />
       </indent>
       &lt;/Location&gt;
     </example>
index e0b01784080624b6874322c0445986eb8145c46c..85e7776d9abb09072f6a84014c6ef2c50ae1262d 100644 (file)
@@ -1311,14 +1311,13 @@ proxied</description>
     well. That may slow down the startup time of the server.</p>
 
     <example><title>Example</title>
-      ProxyBlock joes-garage.com some-host.co.uk rocky.wotsamattau.edu
+      ProxyBlock news.example.com auctions.example.com friends.example.com
     </example>
 
-    <p><code>rocky.wotsamattau.edu</code> would also be matched if referenced by
-    IP address.</p>
+    <p>Note that <code>example</code> would also be sufficient to match any
+    of these sites.</p>
 
-    <p>Note that <code>wotsamattau</code> would also be sufficient to match
-    <code>wotsamattau.edu</code>.</p>
+    <p>Hosts would also be matched if referenced by IP address.</p>
 
     <p>Note also that</p>
 
index 60e3c5fcfa1aba3695b5b0adf3295d1966f6fb46..f51b155ad554ce6fb80e52845e1f4df9fb467ffe 100644 (file)
@@ -97,12 +97,12 @@ RewriteRule <strong>\.(gif|jpg|png)$</strong>    /images/go-away.png   [R,NC]
 </pre></example>
 
     <p>In the third example, we redirect the request to an image on some
-    third-party site.</p>
+    other site.</p>
 
 <example><pre>
 RewriteCond %{HTTP_REFERER} <strong>!^$</strong>
 RewriteCond %{HTTP_REFERER} !www.example.com [NC]
-RewriteRule <strong>\.(gif|jpg|png)$</strong> http://other.site.com/image.gif   [R,NC]
+RewriteRule <strong>\.(gif|jpg|png)$</strong> http://other.example.com/image.gif   [R,NC]
 </pre></example>
 
     <p>Of these techniques, the last two tend to be the most effective
@@ -294,9 +294,9 @@ RewriteRule ^.* ${deflector:%{HTTP_REFERER}} [R,L]
 ##  deflector.map
 ##
 
-http://www.badguys.com/bad/index.html    -
-http://www.badguys.com/bad/index2.html   -
-http://www.badguys.com/bad/index3.html   http://somewhere.com/
+http://badguys.example.com/bad/index.html    -
+http://badguys.example.com/bad/index2.html   -
+http://badguys.example.com/bad/index3.html   http://somewhere.example.com/
 </pre></example>
 
     </dd>
index 0276323dfa8f1cd3635bfb6b5cbe4c33e1f74808..48adf03b17290cf75a889225e6a5cb1eb4998438 100644 (file)
@@ -176,10 +176,10 @@ RewriteRule  ^/(.*)$  /www/hosts/${lowercase:%{SERVER_NAME}}/cgi-bin/$1  [H=cgi-
     this:</p>
 
 <example>
-www.customer-1.com  /www/customers/1<br />
-www.customer-2.com  /www/customers/2<br />
+customer-1.example.com  /www/customers/1<br />
+customer-2.example.com  /www/customers/2<br />
 # ...<br />
-www.customer-N.com  /www/customers/N<br />
+customer-N.example.com  /www/customers/N<br />
 </example>
 
     <p>The <code>httpd.conf</code> should contain the following:</p>
index 9af3f3a5f8541941dd237b62a9b0787202645c91..344b55821c0e4f6566d4ca545b6442c29e657a9c 100644 (file)
@@ -373,10 +373,10 @@ containers apply enclosed configuration directives only
 to sites accessed through <module>mod_proxy</module>'s proxy server
 that match the specified URL.  For example, the following configuration
 will prevent the proxy server from being used to access the
-<code>cnn.com</code> website.</p>
+<code>www.example.com</code> website.</p>
 
 <example>
-&lt;Proxy http://cnn.com/*&gt;<br />
+&lt;Proxy http://www.example.com/*&gt;<br />
 Order allow,deny<br />
 Deny from all<br />
 &lt;/Proxy&gt;
index 845aaf1ef26a5480bfdd9cae99cba7941a933b6b..c8129e324dfb01e9164c74dbe4ee4c912b9e4d20 100644 (file)
@@ -52,10 +52,10 @@ following directives.</p>
    Listen 443<br />
    &lt;VirtualHost _default_:443&gt;<br />
    <indent>
-        ServerName www.domain.com<br />
+        ServerName www.example.com<br />
         SSLEngine on<br />
-        SSLCertificateFile /path/to/www.comain.com.cert<br />
-        SSLCertificateKeyFile /path/to/www.domain.com.key<br />
+        SSLCertificateFile /path/to/www.example.com.cert<br />
+        SSLCertificateKeyFile /path/to/www.example.com.key<br />
    </indent>
    &lt;/VirtualHost&gt;
 </example>
index ebfa97d9bcc00c54deffccf7413073745d013fbc..a7c25e8d994bb0234a0b07d559d0d76ea2195cbf 100644 (file)
     </note>
 
     <p>The server has two IP addresses. On one (<code>172.20.30.40</code>), we
-    will serve the "main" server, <code>server.domain.com</code> and on the
+    will serve the "main" server, <code>server.example.com</code> and on the
     other (<code>172.20.30.50</code>), we will serve two or more virtual hosts.</p>
 
     <example>
     Listen 80<br />
     <br />
     # This is the "main" server running on 172.20.30.40<br />
-    ServerName server.domain.com<br />
+    ServerName server.example.com<br />
     DocumentRoot /www/mainserver<br />
     <br />
     # This is the other address<br />
index 90607a1254c5b6733c7f5be0a7c4cf1f2f6c586c..fbb2c247fe1627254b9a8d722756a041bec0d5cc 100644 (file)
@@ -29,7 +29,7 @@
 
     <p>The term <cite>Virtual Host</cite> refers to the practice of
     running more than one web site (such as
-    <code>www.company1.com</code> and <code>www.company2.com</code>)
+    <code>company1.example.com</code> and <code>company2.example.com</code>)
     on a single machine. Virtual hosts can be "<a
     href="ip-based.html">IP-based</a>", meaning that you have a
     different IP address for every web site, or "<a
index a526c6325065cdb50274013dbf6bc37ba21659e4..db6ba5fa5c4a0628c9874beb433176636aba745b 100644 (file)
     that daemon services. e.g.</p>
 
     <example>
-    Listen www.smallco.com:80
+    Listen www.example.com:80
     </example>
 
     <p>It is recommended that you use an IP address instead of a
 
     <example>
     &lt;VirtualHost 172.20.30.40:80&gt;<br />
-    ServerAdmin webmaster@mail.smallco.com<br />
-    DocumentRoot /groups/smallco/www<br />
-    ServerName www.smallco.com<br />
-    ErrorLog /groups/smallco/logs/error_log<br />
-    TransferLog /groups/smallco/logs/access_log<br />
+    ServerAdmin webmaster@mail.example.com<br />
+    DocumentRoot /groups/example/www<br />
+    ServerName www.example.com<br />
+    ErrorLog /groups/example/logs/error_log<br />
+    TransferLog /groups/example/logs/access_log<br />
     &lt;/VirtualHost&gt;<br />
     <br />
     &lt;VirtualHost 172.20.30.50:80&gt;<br />