[project @ 2002-11-17 16:13:34 by cjwatson]

Improve exim setup instructions with suggestions from me and Chad Miller
(#78688).

diff --git a/debian/README.mail b/debian/README.mail
index 4ae47cd8ae03dd55ada17031f9c7331fbb779769..80cf6a2f9a232b31863bc7d3f1e0f8b2b796ac8d 100644 (file)
--- a/debian/README.mail
+++ b/debian/README.mail
@@ -32,17 +32,43 @@ debbugs:
   local_parts = submit:bugs:maintonly:quiet:forwarded:done:close:request:submitter:control:^\\d+
 
  2) If the domain is a virtual host on a machine that needs it, there are
-    many ways of handling it.  I think the neatest was:
+    many ways of handling it.  I think the neatest was to use the above
+    transport and director, except to add the following line to the
+    director's options:
 
-debbugs:
-  driver = aliasfile
   domains = <domain name>
-  file = /usr/lib/debbugs/receive
-  user = <some user>
-  group = <some group>
-  current_directory = /var/lib/debbugs/spool
+
+    Alternatively, Chad Miller <cmiller@surfsouth.com> suggests:
+
+    The method I discovered involved adding at the top of the routers section:
+
+debbugs_router:
+  driver = domainlist
+  transport = debbugs_transport
+  route_list = "bugs.foo.bar;bugs.baz.quux"
+
+    where bugs.foo.bar and bugs.baz.quux are mail-domains for which I want to
+    receive bug requests only.
+    Next, add anywhere in the transports section:
+
+debbugs_transport:
+  driver = pipe
+  command = /usr/lib/debbugs/receive
+  user = <some non-root user>
+  group = <some non-root group>
+  current_directory = /etc/debbugs
   home_directory = /var/lib/debbugs/spool
 
+    (current_directory may need to be /var/lib/debbugs/spool, depending on
+    your setup.)
+
+    Next, the mail domains MUST NOT be in the "local_domains" list!
+    Instead, we MUST put them in the "relay_domains" list.
+
+    Essentially, this tells exim that we agree ("relay_domains") to relay
+    mail for those zones ("debbugs_router") and "send" the mail using a pipe
+    ("debbugs_transport").
+
 Qmail
 -----
 From Tommi Virtanen (tv@debian.org), amended by Daniel Ruoso

diff --git a/debian/changelog b/debian/changelog
index edbce786f2164dcc8ebc9503f53fe70babefe752..a86c1ff3c8b980e792865f8ef2a4bf3cbf1223bc 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -79,6 +79,8 @@ debbugs (2.4) experimental; urgency=low
     supports it. [Colin]
   * Prevent people from reading the first line of arbitrary files through
     bugreport.cgi, thanks to Max <rusmir@tula.net>. [Colin]
+  * Add working-for-me instructions for exim setup on non-dedicated sites,
+    together with Chad Miller's suggestions, closes: #78688. [Colin]
   * Fix a few typos, closes: #146745, #152751.
   * Various other things, not worth mentioning here.