[deployment-guide/comm-rel: 469/727] Updated the AddIcon directive description.

Jaromir Hradilek jhradile at fedoraproject.org
Tue Oct 19 13:04:17 UTC 2010


commit d42ed2e57c369cb69ea56644e814adaac038960c
Author: Jaromir Hradilek <jhradile at redhat.com>
Date:   Tue Aug 24 14:04:01 2010 +0200

    Updated the AddIcon directive description.

 en-US/The_Apache_HTTP_Server.xml |   72 +++++++++++++++++++++++++++++--------
 1 files changed, 56 insertions(+), 16 deletions(-)
---
diff --git a/en-US/The_Apache_HTTP_Server.xml b/en-US/The_Apache_HTTP_Server.xml
index 357b0fe..c84804b 100644
--- a/en-US/The_Apache_HTTP_Server.xml
+++ b/en-US/The_Apache_HTTP_Server.xml
@@ -276,9 +276,9 @@ httpd (pid 19014) is running...</screen>
             <para>
               The <option>AddDescription</option> directive allows you to specify a short description of a file to be displayed in server-generated directory listings. It takes the following form:
             </para>
-            <screen>AddDescription "<replaceable>description</replaceable>" <replaceable>pattern</replaceable></screen>
+            <screen>AddDescription "<replaceable>description</replaceable>" <replaceable>pattern</replaceable>...</screen>
             <para>
-              The <replaceable>pattern</replaceable> can be either a full filename, or a file extension. You can also use common wildcards.
+              The <replaceable>pattern</replaceable> can be a filename, a file extension, or a wildcard expression.
             </para>
             <example id="example-apache-httpdconf-adddescription">
               <title>Using the <option>AddDescription</option> directive</title>
@@ -318,21 +318,61 @@ httpd (pid 19014) is running...</screen>
             </example>
           </listitem>
         </varlistentry>
+        <varlistentry>
+          <term><option>AddIcon</option></term>
+          <listitem>
+            <para>
+              The <option>AddIcon</option> directive allows you to specify an icon to be displayed for different files in server-generated directory listings. It takes the following form:
+            </para>
+            <screen>AddIcon <replaceable>icon</replaceable> <replaceable>pattern</replaceable>...</screen>
+            <para>
+              The <replaceable>icon</replaceable> is a path to an existing icon. The <replaceable>pattern</replaceable> can be a filename, a file extension, a wildcard expression, or a special form as described in <xref linkend="table-apache-httpdconf-addicon" />.
+            </para>
+            <table id="table-apache-httpdconf-addicon">
+              <title>Available options</title>
+              <tgroup cols="2">
+                <colspec colname="option" colnum="1" colwidth="20*" />
+                <colspec colname="description" colnum="2" colwidth="60*" />
+                <thead>
+                  <row>
+                    <entry>
+                      Option
+                    </entry>
+                    <entry>
+                      Description
+                    </entry>
+                  </row>
+                </thead>
+                <tbody>
+                  <row>
+                    <entry>
+                      <option>^^DIRECTORY^^</option>
+                    </entry>
+                    <entry>
+                      A directory.
+                    </entry>
+                  </row>
+                  <row>
+                    <entry>
+                      <option>^^BLANKICON^^</option>
+                    </entry>
+                    <entry>
+                      A blank line.
+                    </entry>
+                  </row>
+                </tbody>
+              </tgroup>
+            </table>
+            <example id="example-apache-httpdconf-addicon">
+              <title>Using the <option>AddIcon</option> directive</title>
+              <screen>AddIcon /icons/back.png ..
+AddIcon /icons/text.png .txt README
+AddIcon /icons/folder.png ^^DIRECTORY^^
+AddIcon /icons/blank.png ^^BLANKICON^^</screen>
+            </example>
+          </listitem>
+        </varlistentry>
       </variablelist>
-      <formalpara id="s2-apache-addicon">
-        <title>AddIcon</title>
-        <indexterm>
-          <primary><command>AddIcon</command></primary>
-          <secondary>Apache configuration directive</secondary>
-        </indexterm>
-        <indexterm>
-          <primary>configuration directives, Apache</primary>
-          <secondary><command>AddIcon</command></secondary>
-        </indexterm>
-        <para>
-          <command>AddIcon</command> specifies which icon to show in server generated directory listings for files with certain extensions. For example, the Web server is set to show the icon <filename>binary.gif</filename> for files with <filename>.bin</filename> or <filename>.exe</filename> extensions.
-        </para>
-      </formalpara>
       <formalpara id="s2-apache-addiconbyencoding">
         <title>AddIconByEncoding</title>
         <indexterm>


More information about the docs-commits mailing list