]> git.ipfire.org Git - thirdparty/apache/httpd.git/commitdiff
Style guide: use <program> to reference programs/scripts.
authorRich Bowen <rbowen@apache.org>
Thu, 16 Apr 2026 14:59:32 +0000 (14:59 +0000)
committerRich Bowen <rbowen@apache.org>
Thu, 16 Apr 2026 14:59:32 +0000 (14:59 +0000)
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1933119 13f79535-47bb-0310-9956-ffa450edef68

docs/manual/programs/configure.xml

index ab3523c80dc5e30b8a79b17f4ec2c3e74ba604da..013f93e5f7b9277f4401e2227ea98331f52f6f46 100644 (file)
@@ -26,7 +26,7 @@
   <title>configure - Configure the source tree</title>
 
 <summary>
-    <p>The <code>configure</code> script configures the source tree
+    <p>The <program>configure</program> script configures the source tree
     for compiling and installing the Apache HTTP Server on your
     particular platform. Various options allow the compilation of a
     server corresponding to your personal requirements.</p>
@@ -40,7 +40,7 @@
 <seealso><a href="../install.html">Compiling and Installing</a></seealso>
 
 <section id="synopsis"><title>Synopsis</title>
-    <p>You should call the <code>configure</code> script from within the
+    <p>You should call the <program>configure</program> script from within the
     root directory of the distribution.</p>
 
     <p><code><strong>./configure</strong> [<var>OPTION</var>]...
@@ -64,7 +64,7 @@
   <section id="configurationoptions"><title>Configuration options</title>
 
     <p>The following options influence the behavior of
-    <code>configure</code> itself.</p>
+    <program>configure</program> itself.</p>
 
     <dl>
       <dt><code>-C</code></dt>
@@ -84,7 +84,7 @@
 
       <dt><code>-n</code></dt>
       <dt><code>--no-create</code></dt>
-      <dd>The <code>configure</code> script is run normally but does
+      <dd>The <program>configure</program> script is run normally but does
         not create output files. This is useful to check the test results
         before generating makefiles for compilation.</dd>
 
@@ -95,7 +95,7 @@
 
       <dt><code>--srcdir=<var>DIR</var></code></dt>
       <dd>Defines directory <var>DIR</var> to be the source file directory.
-        Default is the directory where <code>configure</code> is located, or
+        Default is the directory where <program>configure</program> is located, or
         the parent directory.</dd>
 
       <dt><code>--silent</code></dt>
       </dl>
 
       <note><title>Note</title>
-        <code>configure</code> will not complain about
+        <program>configure</program> will not complain about
         <code>--enable-<var>foo</var></code> even if <var>foo</var> doesn't
         exist, so you need to type carefully.
       </note>
             modules. The module source file <code><var>module-file</var></code>
             will be searched in the <code>modules/<var>module-type</var></code>
             subdirectory of your Apache HTTP server source tree. If it is not found
-            there <code>configure</code> is considering <var>module-file</var> to be
+            there <program>configure</program> is considering <var>module-file</var> to be
             an absolute file path and tries to copy the source file into the
             <var>module-type</var> subdirectory. If the subdirectory doesn't
             exist it will be created and populated with a standard
           is part of the httpd
           source distribution and will automatically be build together with the
           HTTP server. If you want to use an already installed APR instead you
-          have to tell <code>configure</code> the path to the
+          have to tell <program>configure</program> the path to the
           <code>apr-config</code> script. You may set the absolute path and name
           or the directory to the installed APR. <code>apr-config</code> must
           exist within this directory or the subdirectory
         <dd>The Apache Portable Runtime Utilities (APU) are part of the
           httpd source distribution and will automatically be build
           together with the HTTP server. If you want to use an already installed
-          APU instead you have to tell <code>configure</code> the path to the
+          APU instead you have to tell <program>configure</program> the path to the
           <code>apu-config</code> script. You may set the absolute path and name
           or the directory to the installed APU. <code>apu-config</code> must
           exist within this directory or the subdirectory
           <code>bin</code>.</dd>
 
         <dt><code>--with-ssl=<var>DIR</var></code></dt>
-        <dd>If <module>mod_ssl</module> has been enabled <code>configure</code>
+        <dd>If <module>mod_ssl</module> has been enabled <program>configure</program>
           searches for an installed OpenSSL. You can set the directory path
           to the SSL/TLS toolkit instead.</dd>
 
         <dt><code>--with-z=<var>DIR</var></code></dt>
-        <dd><code>configure</code> searches automatically for an installed
+        <dd><program>configure</program> searches automatically for an installed
           <code>zlib</code> library if your source configuration requires one
           (e.g., when <module>mod_deflate</module> is enabled). You can set the
           directory path to the compression library instead.</dd>
 
       <dl>
         <dt><code>--with-gdbm[=<var>path</var>]</code></dt>
-        <dd>If no <var>path</var> is specified, <code>configure</code> will
+        <dd>If no <var>path</var> is specified, <program>configure</program> will
           search for the include files and libraries of a GNU DBM
           installation in the usual search paths. An explicit
-          <var>path</var> will cause <code>configure</code> to look in
+          <var>path</var> will cause <program>configure</program> to look in
           <code><var>path</var>/lib</code> and
           <code><var>path</var>/include</code> for the relevant files.
           Finally, the <var>path</var> may specify specific include and
     </dl>
 
     <section id="suexec">
-      <title><code>suexec</code> configuration options</title>
+      <title><program>suexec</program> configuration options</title>
       <p>The following options are used to fine tune the behavior of <program>
         suexec</program>. See <a
         href="suexec.html#install">Configuring and installing suEXEC</a>
 
 <section id="env"><title>Environment variables</title>
   <p>There are some useful environment variables to override the choices made by
-    <code>configure</code> or to help it to find libraries and programs with
+    <program>configure</program> or to help it to find libraries and programs with
     nonstandard names or locations.</p>
 
   <!-- are these all useful variables? -->