summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/sgml/faq.sgml14
-rw-r--r--docs/sgml/glossary.sgml15
-rw-r--r--docs/sgml/installation.sgml24
-rw-r--r--docs/xml/faq.xml14
-rw-r--r--docs/xml/glossary.xml15
-rw-r--r--docs/xml/installation.xml24
6 files changed, 74 insertions, 32 deletions
diff --git a/docs/sgml/faq.sgml b/docs/sgml/faq.sgml
index 27e714e1b..df80794cd 100644
--- a/docs/sgml/faq.sgml
+++ b/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>
diff --git a/docs/sgml/glossary.sgml b/docs/sgml/glossary.sgml
index f3be34466..191b3fb39 100644
--- a/docs/sgml/glossary.sgml
+++ b/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>
diff --git a/docs/sgml/installation.sgml b/docs/sgml/installation.sgml
index b25a2bcab..f7607d2e3 100644
--- a/docs/sgml/installation.sgml
+++ b/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
diff --git a/docs/xml/faq.xml b/docs/xml/faq.xml
index 27e714e1b..df80794cd 100644
--- a/docs/xml/faq.xml
+++ b/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>
diff --git a/docs/xml/glossary.xml b/docs/xml/glossary.xml
index f3be34466..191b3fb39 100644
--- a/docs/xml/glossary.xml
+++ b/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>
diff --git a/docs/xml/installation.xml b/docs/xml/installation.xml
index b25a2bcab..f7607d2e3 100644
--- a/docs/xml/installation.xml
+++ b/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