diff options
author | jocuri%softhome.net <> | 2008-04-04 13:47:44 +0200 |
---|---|---|
committer | jocuri%softhome.net <> | 2008-04-04 13:47:44 +0200 |
commit | fdbf1ce78ef54b10efbd53c888da43f1ea734fb7 (patch) | |
tree | a59d13fa43a6b89aa384c5631d295e67f4066afd | |
parent | 5133b60517af93661cef31a7e38c977e69d9058b (diff) | |
download | bugzilla-fdbf1ce78ef54b10efbd53c888da43f1ea734fb7.tar.gz bugzilla-fdbf1ce78ef54b10efbd53c888da43f1ea734fb7.tar.xz |
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.
-rw-r--r-- | docs/en/xml/administration.xml | 55 | ||||
-rw-r--r-- | docs/en/xml/installation.xml | 126 |
2 files changed, 110 insertions, 71 deletions
diff --git a/docs/en/xml/administration.xml b/docs/en/xml/administration.xml index 104403013..cf7d707c4 100644 --- a/docs/en/xml/administration.xml +++ b/docs/en/xml/administration.xml @@ -82,6 +82,22 @@ <varlistentry> <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 </term> <listitem> @@ -154,25 +170,6 @@ <varlistentry> <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 </term> <listitem> @@ -294,6 +291,22 @@ </listitem> </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> </section> @@ -1295,7 +1308,9 @@ 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 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> <warning> <para>If specifying a domain in the regexp, make sure you end diff --git a/docs/en/xml/installation.xml b/docs/en/xml/installation.xml index 94ceb9d59..7d24a6291 100644 --- a/docs/en/xml/installation.xml +++ b/docs/en/xml/installation.xml @@ -1,5 +1,5 @@ <!-- <!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"> <title>Installing Bugzilla</title> @@ -1638,67 +1638,91 @@ C:\perl> <command>ppm install <module name></command> <section id="os-macosx"> <title><productname>Mac OS X</productname></title> - <para>Apple did not include the GD library with Mac OS X. Bugzilla - needs this for bug graphs.</para> + <para>Making Bugzilla work on Mac OS X requires the following + adjustments.</para> - <para>You can install it using a program called - Fink, which is similar in nature to the CPAN installer, but installs - common GNU utilities. Fink is available from - <ulink url="http://sourceforge.net/projects/fink/"/>.</para> + <section id="macosx-sendmail"> + <title>Sendmail</title> - <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>In Mac OS X 10.3 and later, + <ulink url="http://www.postfix.org/">Postfix</ulink> + 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 - enter to install all of the dependencies and then watch it work. You will - then be able to use <glossterm linkend="gloss-cpan">CPAN</glossterm> to - install the GD Perl module. - </para> + <para>As of version 2.20, Bugzilla will be able to find the fake + sendmail executable without any assistance. However, you will have + to turn on the sendmailnow parameter before you do anything that would + result in email being sent. For more information, see the description + of the sendmailnow parameter in <xref linkend="parameters"/>.</para> - <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>. + </section> + + <section id="macosx-libraries"> + <title>Libraries & Perl Modules on Mac OS X</title> + + <para>Apple did not include the GD library with Mac OS X. Bugzilla + needs this for bug graphs.</para> + + <para>You can install it using a program called + Fink, which is similar in nature to the CPAN installer, but installs + 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, + you'll want to use it to install the <filename>gd2</filename> package. </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> + <para>It will prompt you for a number of dependencies, type 'y' and hit + enter to install all of the dependencies and then watch it work. You will + then be able to use <glossterm linkend="gloss-cpan">CPAN</glossterm> to + install the GD Perl module. + </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 Makefile.PL EXPATLIBPATH=/sw/lib EXPATINCPATH=/sw/include # make; make test; make install <co id="macosx-make"/> # exit <co id="macosx-exit"/> - </screen> - <calloutlist> - <callout arearefs="macosx-look macosx-exit"> - <para>The look command will download the module and spawn a - new shell with the extracted files as the current working directory. - The exit command will return you to your original shell. - </para> - </callout> - <callout arearefs="macosx-make"> - <para>You should watch the output from these make commands, - especially <quote>make test</quote> as errors may prevent XML::Parser - from functioning correctly with Bugzilla. - </para> - </callout> - </calloutlist> + </screen> + <calloutlist> + <callout arearefs="macosx-look macosx-exit"> + <para>The look command will download the module and spawn a + new shell with the extracted files as the current working directory. + The exit command will return you to your original shell. + </para> + </callout> + <callout arearefs="macosx-make"> + <para>You should watch the output from these make commands, + especially <quote>make test</quote> as errors may prevent + XML::Parser from functioning correctly with Bugzilla. + </para> + </callout> + </calloutlist> + </section> </section> <section id="os-mandrake"> |