diff xml/en/docs/http/server_names.xml @ 490:9913f1d51c07

Replaced "nginx" domain names with example domains.
author Ruslan Ermilov <ru@nginx.com>
date Thu, 19 Apr 2012 12:30:24 +0000
parents 6135f3c95bf6
children be54c443235a
line wrap: on
line diff
--- a/xml/en/docs/http/server_names.xml
+++ b/xml/en/docs/http/server_names.xml
@@ -20,13 +20,13 @@ They may be defined using exact names, w
 <programlisting>
 server {
     listen       80;
-    server_name  nginx.org  www.nginx.org;
+    server_name  example.org  www.example.org;
     ...
 }
 
 server {
     listen       80;
-    server_name  *.nginx.org;
+    server_name  *.example.org;
     ...
 }
 
@@ -38,7 +38,7 @@ server {
 
 server {
     listen       80;
-    server_name  ~^(?&lt;user&gt;.+)\.nginx\.net$;
+    server_name  ~^(?&lt;user&gt;.+)\.example\.net$;
     ...
 }
 </programlisting>
@@ -52,7 +52,7 @@ exact names;
 </listitem>
 
 <listitem>
-wildcard names starting with an asterisk: <url>*.nginx.org</url>;
+wildcard names starting with an asterisk: <url>*.example.org</url>;
 </listitem>
 
 <listitem>
@@ -75,20 +75,20 @@ The first match stops the search.
 
 <para>
 A wildcard name may contain an asterisk only on the name's start or end,
-and only on a dot border. The names “<literal>www.*.nginx.org</literal>”
-and “<literal>w*.nginx.org</literal>” are invalid.
+and only on a dot border. The names “<literal>www.*.example.org</literal>”
+and “<literal>w*.example.org</literal>” are invalid.
 However, these names can be specified using regular expressions,
-for example, “<literal>~^www\..+\.nginx\.org$</literal>” and
-“<literal>~^w.*\.nginx\.org$</literal>”.
+for example, “<literal>~^www\..+\.example\.org$</literal>” and
+“<literal>~^w.*\.example\.org$</literal>”.
 An asterisk can match several name parts.
-The name “<literal>*.nginx.org</literal>” matches not only
-<url>www.nginx.org</url> but <url>www.sub.nginx.org</url> as well.
+The name “<literal>*.example.org</literal>” matches not only
+<url>www.example.org</url> but <url>www.sub.example.org</url> as well.
 </para>
 
 <para>
-A special wildcard in the form “<literal>.nginx.org</literal>” can be used
-to match both the exact name “<literal>nginx.org</literal>”
-and the wildcard name “<literal>*.nginx.org</literal>”.
+A special wildcard in the form “<literal>.example.org</literal>” can be used
+to match both the exact name “<literal>example.org</literal>”
+and the wildcard name “<literal>*.example.org</literal>”.
 </para>
 
 </section>
@@ -104,7 +104,7 @@ To use a regular expression, the server 
 character:
 
 <programlisting>
-server_name  ~^www\d+\.nginx\.net$;
+server_name  ~^www\d+\.example\.net$;
 </programlisting>
 
 otherwise it will be treated as an exact name, or if the expression contains
@@ -116,7 +116,7 @@ A regular expression containing the char
 and &ldquo;}&rdquo; should be quoted:
 
 <programlisting>
-server_name  "~^(?&lt;name&gt;\w\d<b>{</b>1,3<b>}</b>+)\.nginx\.net$";
+server_name  "~^(?&lt;name&gt;\w\d<b>{</b>1,3<b>}</b>+)\.example\.net$";
 </programlisting>
 
 otherwise nginx will fail to start and display the error message:
@@ -196,7 +196,7 @@ in a server block which is not the defau
 <programlisting>
 server {
     listen       80;
-    server_name  nginx.org  www.nginx.org  "";
+    server_name  example.org  www.example.org  "";
     ...
 }
 </programlisting>
@@ -221,8 +221,8 @@ and you can handle the request using the
 <programlisting>
 server {
     listen       80;
-    server_name  nginx.org
-                 www.nginx.org
+    server_name  example.org
+                 www.example.org
                  ""
                  <b>192.168.1.1</b>
                  ;
@@ -278,14 +278,14 @@ while the other will be the default for 
 server {
     listen       80;
     listen       8080  default_server;
-    server_name  nginx.net;
+    server_name  example.net;
     ...
 }
 
 server {
     listen       80  default_server;
     listen       8080;
-    server_name  nginx.org;
+    server_name  example.org;
     ...
 }
 </programlisting>
@@ -312,7 +312,7 @@ If the name is not found there, the wild
 ending with an asterisk is searched.
 Searching wildcard names hashes is slower than searching exact name hash
 because names are searched by domain parts.
-Note that the special wildcard form “<literal>.nginx.org</literal>”
+Note that the special wildcard form “<literal>.example.org</literal>”
 is stored in a wildcard names hash and not in an exact names hash.
 Regular expressions are tested sequentially
 and therefore are the slowest method and are non-scalable.
@@ -321,13 +321,13 @@ and therefore are the slowest method and
 <para>
 For these reasons, it is better to use exact names where possible.
 For example, if the most frequently requested names of a server
-are <url>nginx.org</url> and <url>www.nginx.org</url>,
+are <url>example.org</url> and <url>www.example.org</url>,
 it is more efficient to define them explicitly:
 
 <programlisting>
 server {
     listen       80;
-    server_name  nginx.org  www.nginx.org  *.nginx.org;
+    server_name  example.org  www.example.org  *.example.org;
     ...
 }
 </programlisting>
@@ -337,7 +337,7 @@ than to use the simplified form:
 <programlisting>
 server {
     listen       80;
-    server_name  .nginx.org;
+    server_name  .example.org;
     ...
 }
 </programlisting>
@@ -354,7 +354,7 @@ The default value of the
 may be equal to 32, or 64, or another value,
 depending on your CPU cache line size.
 If the default value is 32 and you define
-&ldquo;too.long.server.name.nginx.org&rdquo; as a server name,
+&ldquo;too.long.server.name.example.org&rdquo; as a server name,
 then nginx will fail to start and display the error message:
 
 <programlisting>
@@ -433,15 +433,15 @@ Regular expression server names have bee
 </listitem>
 
 <listitem>
-Wildcard form <url>nginx.*</url> has been supported since 0.6.0.
+Wildcard form <url>example.*</url> has been supported since 0.6.0.
 </listitem>
 
 <listitem>
-The special form <url>.nginx.org</url> has been supported since 0.3.18.
+The special form <url>.example.org</url> has been supported since 0.3.18.
 </listitem>
 
 <listitem>
-Wildcard form <url>*.nginx.org</url> has been supported since 0.1.13.
+Wildcard form <url>*.example.org</url> has been supported since 0.1.13.
 </listitem>
 
 </list>