Skip to content

bugzilla
bugzilla
Commit fdbf1ce7 authored by jocuri%softhome.net's avatar jocuri%softhome.net
Browse files
Options

Documentation patch for bug 213262: add instructions on how to get sendmail to…

Documentation patch for bug 213262: add instructions on how to get sendmail to work with Bugzilla on Mac OS X; patch by A. Karl Kornel <karl@kornel.name>, r=colin.ogilvie, r=justdave.
parent 5133b605
Hide whitespace changes
Inline Side-by-side
Showing with 110 additions and 71 deletions
docs/en/xml/administration.xml
View file @ fdbf1ce7
...@@ -82,6 +82,22 @@ ...@@ -82,6 +82,22 @@
<varlistentry> <varlistentry>
<term> <term>
maildeliverymethod
</term>
<listitem>
<para>
This is used to specify how email is sent, or if it is sent at
all. There are several options included for different MTAs,
along with two additional options that disable email sending.
"testfile" does not send mail, but instead saves it in
<filename>data/mailer.testfile</filename> for later review.
"none" disables email sending entirely.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
shadowdb shadowdb
</term> </term>
<listitem> <listitem>
...@@ -154,25 +170,6 @@ ...@@ -154,25 +170,6 @@
<varlistentry> <varlistentry>
<term> <term>
passwordmail
</term>
<listitem>
<para>
Every time a user creates an account, the text of this parameter
(with substitutions) is sent to the new user along with their
password message.
</para>
<para>
Add any text you wish to the "passwordmail" parameter box. For
instance, many people choose to use this box to give a quick
training blurb about how to use Bugzilla at your site.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
movebugs movebugs
</term> </term>
<listitem> <listitem>
...@@ -294,6 +291,22 @@ ...@@ -294,6 +291,22 @@
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry>
<term>
sendmailnow
</term>
<listitem>
<para>
When Bugzilla is using Sendmail older than 8.12, turning this option
off will improve performance by not waiting for Sendmail to actually
send mail. If Sendmail 8.12 or later is being used, there is
nothing to gain by turning this off. If another MTA is being used,
such as Postfix, then this option *must* be turned on (even if you
are using the fake sendmail executable that Postfix provides).
</para>
</listitem>
</varlistentry>
</variablelist> </variablelist>
</section> </section>
...@@ -1295,7 +1308,9 @@ ...@@ -1295,7 +1308,9 @@
resulted in a user acquiring permanent membership in a group. resulted in a user acquiring permanent membership in a group.
To remove a user from a group the user was in due to a regular To remove a user from a group the user was in due to a regular
expression in version 2.16 or earlier, the user must be explicitly expression in version 2.16 or earlier, the user must be explicitly
removed from the group.</para> removed from the group. This can easily be done by pressing
buttons named 'Remove Memberships' or 'Remove Memberships
included in regular expression' under the table.</para>
</note> </note>
<warning> <warning>
<para>If specifying a domain in the regexp, make sure you end <para>If specifying a domain in the regexp, make sure you end
......
docs/en/xml/installation.xml
View file @ fdbf1ce7
<!-- <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"> --> <!-- <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"> -->
<!-- $Id: installation.xml,v 1.113 2008/04/04 06:47:43 jocuri%softhome.net Exp $ --> <!-- $Id: installation.xml,v 1.114 2008/04/04 06:47:44 jocuri%softhome.net Exp $ -->
<chapter id="installing-bugzilla"> <chapter id="installing-bugzilla">
<title>Installing Bugzilla</title> <title>Installing Bugzilla</title>
...@@ -1638,67 +1638,91 @@ C:\perl&gt; <command>ppm install &lt;module name&gt;</command> ...@@ -1638,67 +1638,91 @@ C:\perl&gt; <command>ppm install &lt;module name&gt;</command>
<section id="os-macosx"> <section id="os-macosx">
<title><productname>Mac OS X</productname></title> <title><productname>Mac OS X</productname></title>
<para>Apple did not include the GD library with Mac OS X. Bugzilla <para>Making Bugzilla work on Mac OS X requires the following
needs this for bug graphs.</para> adjustments.</para>
<para>You can install it using a program called <section id="macosx-sendmail">
Fink, which is similar in nature to the CPAN installer, but installs <title>Sendmail</title>
common GNU utilities. Fink is available from
<ulink url="http://sourceforge.net/projects/fink/"/>.</para>
<para>Follow the instructions for setting up Fink. Once it's installed, <para>In Mac OS X 10.3 and later,
you'll want to use it to install the <filename>gd2</filename> package. <ulink url="http://www.postfix.org/">Postfix</ulink>
</para> is used as the built-in email server. Postfix provides an executable
that mimics sendmail enough to fool Bugzilla, as long as Bugzilla can
find it.</para>
<para>It will prompt you for a number of dependencies, type 'y' and hit <para>As of version 2.20, Bugzilla will be able to find the fake
enter to install all of the dependencies and then watch it work. You will sendmail executable without any assistance. However, you will have
then be able to use <glossterm linkend="gloss-cpan">CPAN</glossterm> to to turn on the sendmailnow parameter before you do anything that would
install the GD Perl module. result in email being sent. For more information, see the description
</para> of the sendmailnow parameter in <xref linkend="parameters"/>.</para>
<note> </section>
<para>To prevent creating conflicts with the software that Apple
installs by default, Fink creates its own directory tree at <section id="macosx-libraries">
<filename class="directory">/sw</filename> where it installs most of <title>Libraries &amp; Perl Modules on Mac OS X</title>
the software that it installs. This means your libraries and headers
will be at <filename class="directory">/sw/lib</filename> and <para>Apple did not include the GD library with Mac OS X. Bugzilla
<filename class="directory">/sw/include</filename> instead of needs this for bug graphs.</para>
<filename class="directory">/usr/lib</filename> and
<filename class="directory">/usr/include</filename>. When the <para>You can install it using a program called
Perl module config script asks where your <filename>libgd</filename> Fink, which is similar in nature to the CPAN installer, but installs
is, be sure to tell it common GNU utilities. Fink is available from
<filename class="directory">/sw/lib</filename>. <ulink url="http://sourceforge.net/projects/fink/"/>.</para>
<para>Follow the instructions for setting up Fink. Once it's installed,
you'll want to use it to install the <filename>gd2</filename> package.
</para> </para>
</note>
<para>Also available via Fink is <filename>expat</filename>. After using <para>It will prompt you for a number of dependencies, type 'y' and hit
fink to install the expat package you will be able to install enter to install all of the dependencies and then watch it work. You will
XML::Parser using CPAN. There is one caveat. Unlike recent versions of then be able to use <glossterm linkend="gloss-cpan">CPAN</glossterm> to
the GD module, XML::Parser doesn't prompt for the location of the install the GD Perl module.
required libraries. When using CPAN, you will need to use the following </para>
command sequence:
</para>
<screen> <note>
<para>To prevent creating conflicts with the software that Apple
installs by default, Fink creates its own directory tree at
<filename class="directory">/sw</filename> where it installs most of
the software that it installs. This means your libraries and headers
will be at <filename class="directory">/sw/lib</filename> and
<filename class="directory">/sw/include</filename> instead of
<filename class="directory">/usr/lib</filename> and
<filename class="directory">/usr/include</filename>. When the
Perl module config script asks where your <filename>libgd</filename>
is, be sure to tell it
<filename class="directory">/sw/lib</filename>.
</para>
</note>
<para>Also available via Fink is <filename>expat</filename>. After using
fink to install the expat package you will be able to install
XML::Parser using CPAN. There is one caveat. Unlike recent versions of
the GD module, XML::Parser doesn't prompt for the location of the
required libraries. When using CPAN, you will need to use the following
command sequence:
</para>
<screen>
# perl -MCPAN -e'look XML::Parser' <co id="macosx-look"/> # perl -MCPAN -e'look XML::Parser' <co id="macosx-look"/>
# perl Makefile.PL EXPATLIBPATH=/sw/lib EXPATINCPATH=/sw/include # perl Makefile.PL EXPATLIBPATH=/sw/lib EXPATINCPATH=/sw/include
# make; make test; make install <co id="macosx-make"/> # make; make test; make install <co id="macosx-make"/>
# exit <co id="macosx-exit"/> # exit <co id="macosx-exit"/>
</screen> </screen>
<calloutlist> <calloutlist>
<callout arearefs="macosx-look macosx-exit"> <callout arearefs="macosx-look macosx-exit">
<para>The look command will download the module and spawn a <para>The look command will download the module and spawn a
new shell with the extracted files as the current working directory. new shell with the extracted files as the current working directory.
The exit command will return you to your original shell. The exit command will return you to your original shell.
</para> </para>
</callout> </callout>
<callout arearefs="macosx-make"> <callout arearefs="macosx-make">
<para>You should watch the output from these make commands, <para>You should watch the output from these make commands,
especially <quote>make test</quote> as errors may prevent XML::Parser especially <quote>make test</quote> as errors may prevent
from functioning correctly with Bugzilla. XML::Parser from functioning correctly with Bugzilla.
</para> </para>
</callout> </callout>
</calloutlist> </calloutlist>
</section>
</section> </section>
<section id="os-mandrake"> <section id="os-mandrake">
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment