Bug 156434

Summary:	net-mail/mailman installation documentation - precisions
Product:	Gentoo Linux	Reporter:	Sylvain Demers <demerss>
Component:	[OLD] Unspecified	Assignee:	Hanno Böck <hanno>
Status:	VERIFIED FIXED
Severity:	trivial
Priority:	Low
Version:	unspecified
Hardware:	All
OS:	Linux
Whiteboard:
Package list:		Runtime testing required:	---
Attachments:	diff for the README.gentoo file

Description Sylvain Demers 2006-11-27 11:37:40 UTC

The extra Gentoo documentation for Mailman could use a little precision. Should take about 2 minutes to change! :)

/usr/share/doc/mailman-2.1.9_rc1/README.gentoo.gz

Right at the top, there are instructions to "add -D MAILMAN to the /etc/conf.d/apache2 file". At first I thought I was supposed to add "-D MAILMAN" all by itself on a single line at the end of the file. The documentation should say something like "add the -D MAILMAN flag to the APACHE2_OPTS variable".

Second, right before the instructions on changing the /etc/mail/aliases, there should be a note for Postfix users to read the last section of the document. I followed the instructions and ended up modifying the file only to find out that I should not have done that. I had already read the installation instructions on Mailman's website before, but I had forgotten that exception when I was actually installing Mailman.

Comment 1 Sylvain Demers 2006-11-27 12:32:47 UTC

Created attachment 102862 [details, diff]
diff for the README.gentoo file

Here's my take on how it could be phrased.

Comment 2 Sven Vermeulen 2007-07-12 17:21:42 UTC

Also, the dodoc README.gentoo by default creates a .bz2 file, not a .gz file (yes, nitpicking).

Comment 3 Hanno Böck gentoo-dev

2007-11-26 02:15:17 UTC

done