Fix for Apache configuration directives from bug 174255 and

de-stupidifying of emacs destruction of <programlisting> tags.

webtools/bugzilla/docs/sgml/installation.sgml

@@ -525,18 +525,25 @@
       </note>
       </para>
 
-      <para>You'll want to make sure that your web server will run any file
-      with the .cgi extension as a CGI and not just display it. If you're
+      <para>You'll want to make sure that your web server will <emphasis>run</emphasis>
+      any file
+      with the .cgi extension as a CGI program and not simply display the source
+      code. If you're
       using Apache that means uncommenting the following line in the httpd.conf
       file: 
-      <programlisting>AddHandler cgi-script .cgi</programlisting>
+      <programlisting>
+AddHandler cgi-script .cgi
+      </programlisting>
       </para>
 
       <para>With Apache you'll also want to make sure that within the
-      httpd.conf file the line: 
-      <programlisting>Options ExecCGI AllowOverride Limit</programlisting>
+      httpd.conf file these lines: 
+      <programlisting><![CDATA[
+Options +ExecCGI 
+AllowOverride Limit
+]]></programlisting>
 
-      is in the stanza that covers the directories into which you intend to
+      are in the stanza that covers the directories into which you intend to
       put the bugzilla .html and .cgi files.
 
         <note>
@@ -544,7 +551,7 @@
           .htaccess file generated by checksetup.pl</para>
 
           <para>Users of older versions of Apache may find the above lines 
-          in the srm.conf and access.conf files, respecitvely.</para>
+          in the srm.conf and access.conf files, respectively.</para>
         </note>
       </para>
       
@@ -603,9 +610,9 @@
       </para>
       
       <para> 
-        <programlisting>perl -pi -e
-        's@#\!/usr/bonsaitools/bin/perl@#\!/usr/bin/perl@' *cgi *pl Bug.pm
-        processmail syncshadowdb</programlisting>
+        <programlisting>
+perl -pi -e 's@#\!/usr/bonsaitools/bin/perl@#\!/usr/bin/perl@' *cgi *pl Bug.pm processmail syncshadowdb
+        </programlisting>
 
         Change <filename>/usr/bin/perl</filename> to match the location
         of Perl on your machine.
@@ -1028,7 +1035,9 @@
         <para>Depending on your system, crontab may have several manpages.
         The following command should lead you to the most useful page for
         this purpose: 
-        <programlisting>man 5 crontab</programlisting>
+        <programlisting>
+man 5 crontab
+	</programlisting>
         </para>
       </tip>
     </section>
@@ -1137,7 +1146,8 @@
       you understand what the script is doing before executing it.</para>
 
       <para>
-        <programlisting>bash# perl -pi -e "s/Content-Type\: text\/html/Content-Type\: text\/html\; charset=ISO-8859-1/i" *.cgi *.pl
+        <programlisting>
+bash# perl -pi -e "s/Content-Type\: text\/html/Content-Type\: text\/html\; charset=ISO-8859-1/i" *.cgi *.pl
         </programlisting>
       </para>
 
@@ -1205,7 +1215,7 @@
       <para>
       
 <programlisting><![CDATA[
-  <Directory /usr/local/bugzilla/>
+<Directory /usr/local/bugzilla/>
   Options +FollowSymLinks +Indexes +Includes +ExecCGI
   AllowOverride All
 </Directory>

webtools/bugzilla/docs/xml/installation.xml

@@ -525,18 +525,25 @@
       </note>
       </para>
 
-      <para>You'll want to make sure that your web server will run any file
-      with the .cgi extension as a CGI and not just display it. If you're
+      <para>You'll want to make sure that your web server will <emphasis>run</emphasis>
+      any file
+      with the .cgi extension as a CGI program and not simply display the source
+      code. If you're
       using Apache that means uncommenting the following line in the httpd.conf
       file: 
-      <programlisting>AddHandler cgi-script .cgi</programlisting>
+      <programlisting>
+AddHandler cgi-script .cgi
+      </programlisting>
       </para>
 
       <para>With Apache you'll also want to make sure that within the
-      httpd.conf file the line: 
-      <programlisting>Options ExecCGI AllowOverride Limit</programlisting>
+      httpd.conf file these lines: 
+      <programlisting><![CDATA[
+Options +ExecCGI 
+AllowOverride Limit
+]]></programlisting>
 
-      is in the stanza that covers the directories into which you intend to
+      are in the stanza that covers the directories into which you intend to
       put the bugzilla .html and .cgi files.
 
         <note>
@@ -544,7 +551,7 @@
           .htaccess file generated by checksetup.pl</para>
 
           <para>Users of older versions of Apache may find the above lines 
-          in the srm.conf and access.conf files, respecitvely.</para>
+          in the srm.conf and access.conf files, respectively.</para>
         </note>
       </para>
       
@@ -603,9 +610,9 @@
       </para>
       
       <para> 
-        <programlisting>perl -pi -e
-        's@#\!/usr/bonsaitools/bin/perl@#\!/usr/bin/perl@' *cgi *pl Bug.pm
-        processmail syncshadowdb</programlisting>
+        <programlisting>
+perl -pi -e 's@#\!/usr/bonsaitools/bin/perl@#\!/usr/bin/perl@' *cgi *pl Bug.pm processmail syncshadowdb
+        </programlisting>
 
         Change <filename>/usr/bin/perl</filename> to match the location
         of Perl on your machine.
@@ -1028,7 +1035,9 @@
         <para>Depending on your system, crontab may have several manpages.
         The following command should lead you to the most useful page for
         this purpose: 
-        <programlisting>man 5 crontab</programlisting>
+        <programlisting>
+man 5 crontab
+	</programlisting>
         </para>
       </tip>
     </section>
@@ -1137,7 +1146,8 @@
       you understand what the script is doing before executing it.</para>
 
       <para>
-        <programlisting>bash# perl -pi -e "s/Content-Type\: text\/html/Content-Type\: text\/html\; charset=ISO-8859-1/i" *.cgi *.pl
+        <programlisting>
+bash# perl -pi -e "s/Content-Type\: text\/html/Content-Type\: text\/html\; charset=ISO-8859-1/i" *.cgi *.pl
         </programlisting>
       </para>
 
@@ -1205,7 +1215,7 @@
       <para>
       
 <programlisting><![CDATA[
-  <Directory /usr/local/bugzilla/>
+<Directory /usr/local/bugzilla/>
   Options +FollowSymLinks +Indexes +Includes +ExecCGI
   AllowOverride All
 </Directory>