Bug 192511 - Removing all occurances of 'processmail' from the documentation now…

docs/sgml/faq.sgml

@@ -778,14 +778,16 @@
 	</question>
 	<answer>
 	  <para>
-	    If you are using an alternate Mail Transport Agent (MTA other than
-	    sendmail), make sure the options given in the "processmail" and other
-      scripts for all
-	    instances of "sendmail" are correct for your MTA.
+	    If you are using an alternate <glossterm linkend="gloss-mta">MTA</glossterm>,
+            make sure the options given in <filename>Bugzilla/BugMail.pm</filename>
+            and any other place where <application>sendmail</application> is called from
+	    are correct for your MTA. You should also ensure that the
+            <option>sendmailnow</option> param is set to <literal>on</literal>.
 	  </para>
 	  <para>
-	    If you are using Sendmail, try enabling "sendmailnow" in editparams.cgi.
-            If you are using Postfix, you will also need to enable <quote>sendmailnow</quote>.
+	    If you are using <application>sendmail</application>, try enabling
+            <option>sendmailnow</option> in <filename>editparams.cgi</filename>.
+            <!-- TODO provide more info about this, possibly a link to admin -->
 	  </para>
 	</answer>
       </qandaentry>

docs/sgml/glossary.sgml

@@ -227,6 +227,21 @@
   <glossdiv id="gloss-m">
     <title>M</title>
 
+    <glossentry id="gloss-mta">
+      <glossterm>Message Transport Agent</glossterm>
+      <acronym>MTA</acronym>
+
+      <glossdef>
+        <para>A Message Transport Agent is used to control the flow of email
+        on a system. Many unix based systems use
+        <ulink url="http://www.sendmail.org">sendmail</ulink> which is what
+        Bugzilla expects to find by default at <filename>/usr/sbin/sendmail</filename>.
+        Many other MTA's will work, but they all require that the
+        <option>sendmailnow</option> param be set to <literal>on</literal>.
+        </para>
+      </glossdef>
+    </glossentry>
+
     <glossentry>
       <glossterm>mysqld</glossterm>
 

docs/sgml/installation.sgml

@@ -597,7 +597,7 @@
       
       <para> 
         <programlisting>
-perl -pi -e 's@#\!/usr/bonsaitools/bin/perl@#\!/usr/bin/perl@' *cgi *pl Bug.pm processmail syncshadowdb
+perl -pi -e 's@#\!/usr/bonsaitools/bin/perl@#\!/usr/bin/perl@' *cgi *pl Bug.pm syncshadowdb
         </programlisting>
 
         Change <filename>/usr/bin/perl</filename> to match the location
@@ -1424,19 +1424,14 @@ my $webservergid = '8'
           the <function>system</function> call.  For example, you'll need to
           change:
           </para>
-<!-- We'll need a different example when there's no more processmail -->
           <programlisting>
-system("./processmail", $id, $exporter);
+system("$webdotbase","-Tpng","-o","$pngfilename","$filename");
           </programlisting>
           <para>with</para>
           <programlisting>
-system("C:\\perl\\bin\\perl", "processmail", $id, $exporter);
+system("C:\\perl\\bin\\perl", "$webdotbase","-Tpng","-o","$pngfilename","$filename");
           </programlisting>
 
-          <para>Notice that the <computeroutput>./</computeroutput> is also
-          removed.
-          </para>
-
           <tip>
             <para>The <command>grep</command> command is very helpful in finding
             these <function>system</function> calls, assuming you have the
@@ -1444,6 +1439,16 @@ system("C:\\perl\\bin\\perl", "processmail", $id, $exporter);
             </para>
           </tip>
 
+          <note>
+            <para>It appears that the only <function>system</function> call
+            remaining in the Bugzilla codebase is in
+            <filename>showdependencygraph.cgi</filename>. Not changing this
+            file will only cause dependency graphs to not function if the
+            <option>webdotbase</option> paramater points to a local
+            installation of <ulink url="http://www.graphviz.org">GraphViz</ulink>.
+            </para>
+          </note>
+
         </section>
 
       </section>
@@ -1613,7 +1618,7 @@ AllowOverride Limit
           <para><filename>$BUGZILLA_HOME/.htaccess</filename>
           <programlisting><![CDATA[
 # don't allow people to retrieve non-cgi executable files or our private data
-<FilesMatch ^(.*\.pl|.*localconfig.*|processmail|runtests.sh)$>
+<FilesMatch ^(.*\.pl|.*localconfig.*|runtests.sh)$>
   deny from all
 </FilesMatch>
 <FilesMatch ^(localconfig.js|localconfig.rdf)$>
@@ -1721,7 +1726,6 @@ deny from all
 ns_register_filter preauth GET /bugzilla/localconfig filter_deny
 ns_register_filter preauth GET /bugzilla/*.pl filter_deny
 ns_register_filter preauth GET /bugzilla/localconfig filter_deny
-ns_register_filter preauth GET /bugzilla/processmail filter_deny
 ns_register_filter preauth GET /bugzilla/syncshadowdb filter_deny
 ns_register_filter preauth GET /bugzilla/runtests.sh filter_deny
 

docs/xml/faq.xml

@@ -778,14 +778,16 @@
 	</question>
 	<answer>
 	  <para>
-	    If you are using an alternate Mail Transport Agent (MTA other than
-	    sendmail), make sure the options given in the "processmail" and other
-      scripts for all
-	    instances of "sendmail" are correct for your MTA.
+	    If you are using an alternate <glossterm linkend="gloss-mta">MTA</glossterm>,
+            make sure the options given in <filename>Bugzilla/BugMail.pm</filename>
+            and any other place where <application>sendmail</application> is called from
+	    are correct for your MTA. You should also ensure that the
+            <option>sendmailnow</option> param is set to <literal>on</literal>.
 	  </para>
 	  <para>
-	    If you are using Sendmail, try enabling "sendmailnow" in editparams.cgi.
-            If you are using Postfix, you will also need to enable <quote>sendmailnow</quote>.
+	    If you are using <application>sendmail</application>, try enabling
+            <option>sendmailnow</option> in <filename>editparams.cgi</filename>.
+            <!-- TODO provide more info about this, possibly a link to admin -->
 	  </para>
 	</answer>
       </qandaentry>

docs/xml/glossary.xml

@@ -227,6 +227,21 @@
   <glossdiv id="gloss-m">
     <title>M</title>
 
+    <glossentry id="gloss-mta">
+      <glossterm>Message Transport Agent</glossterm>
+      <acronym>MTA</acronym>
+
+      <glossdef>
+        <para>A Message Transport Agent is used to control the flow of email
+        on a system. Many unix based systems use
+        <ulink url="http://www.sendmail.org">sendmail</ulink> which is what
+        Bugzilla expects to find by default at <filename>/usr/sbin/sendmail</filename>.
+        Many other MTA's will work, but they all require that the
+        <option>sendmailnow</option> param be set to <literal>on</literal>.
+        </para>
+      </glossdef>
+    </glossentry>
+
     <glossentry>
       <glossterm>mysqld</glossterm>
 

docs/xml/installation.xml

@@ -597,7 +597,7 @@
       
       <para> 
         <programlisting>
-perl -pi -e 's@#\!/usr/bonsaitools/bin/perl@#\!/usr/bin/perl@' *cgi *pl Bug.pm processmail syncshadowdb
+perl -pi -e 's@#\!/usr/bonsaitools/bin/perl@#\!/usr/bin/perl@' *cgi *pl Bug.pm syncshadowdb
         </programlisting>
 
         Change <filename>/usr/bin/perl</filename> to match the location
@@ -1424,19 +1424,14 @@ my $webservergid = '8'
           the <function>system</function> call.  For example, you'll need to
           change:
           </para>
-<!-- We'll need a different example when there's no more processmail -->
           <programlisting>
-system("./processmail", $id, $exporter);
+system("$webdotbase","-Tpng","-o","$pngfilename","$filename");
           </programlisting>
           <para>with</para>
           <programlisting>
-system("C:\\perl\\bin\\perl", "processmail", $id, $exporter);
+system("C:\\perl\\bin\\perl", "$webdotbase","-Tpng","-o","$pngfilename","$filename");
           </programlisting>
 
-          <para>Notice that the <computeroutput>./</computeroutput> is also
-          removed.
-          </para>
-
           <tip>
             <para>The <command>grep</command> command is very helpful in finding
             these <function>system</function> calls, assuming you have the
@@ -1444,6 +1439,16 @@ system("C:\\perl\\bin\\perl", "processmail", $id, $exporter);
             </para>
           </tip>
 
+          <note>
+            <para>It appears that the only <function>system</function> call
+            remaining in the Bugzilla codebase is in
+            <filename>showdependencygraph.cgi</filename>. Not changing this
+            file will only cause dependency graphs to not function if the
+            <option>webdotbase</option> paramater points to a local
+            installation of <ulink url="http://www.graphviz.org">GraphViz</ulink>.
+            </para>
+          </note>
+
         </section>
 
       </section>
@@ -1613,7 +1618,7 @@ AllowOverride Limit
           <para><filename>$BUGZILLA_HOME/.htaccess</filename>
           <programlisting><![CDATA[
 # don't allow people to retrieve non-cgi executable files or our private data
-<FilesMatch ^(.*\.pl|.*localconfig.*|processmail|runtests.sh)$>
+<FilesMatch ^(.*\.pl|.*localconfig.*|runtests.sh)$>
   deny from all
 </FilesMatch>
 <FilesMatch ^(localconfig.js|localconfig.rdf)$>
@@ -1721,7 +1726,6 @@ deny from all
 ns_register_filter preauth GET /bugzilla/localconfig filter_deny
 ns_register_filter preauth GET /bugzilla/*.pl filter_deny
 ns_register_filter preauth GET /bugzilla/localconfig filter_deny
-ns_register_filter preauth GET /bugzilla/processmail filter_deny
 ns_register_filter preauth GET /bugzilla/syncshadowdb filter_deny
 ns_register_filter preauth GET /bugzilla/runtests.sh filter_deny