Re: [Exim] exim port (freebsd) documentation issue

Sheldon Hearn wrote:

> On (2003/09/24 13:00), Mark Foster wrote:
>
>>When I installed exim from the ports tree, it says to read
>>/usr/local/share/doc/exim/POST-INSTALL-NOTES which I did.

great, someone how actually *reads* the documentation!

>>One of the instructions given is to modify /etc/mail/mailer.conf as per
>>the man page, but in fact the man page does not give exim examples, only
>>postfix and sendmail!

I read:
*) Adjust mailer.conf(5) as appropriate.

> Um... It never occurred to me that anyone would read the mailer.conf(5)
> manpage and not know how to apply it to an Exim installation! :-)
>
> For what it's worth, from FreeBSD 4.9-RELEASE onward, if you install the
> Exim package at operating system install time, the installer will do the
> mailer.conf magic for you.

Or later with sysinstall(8)
Configure -> Networking -> Mail -> Exim

>>But that still leaves the documentation wanting. I think either fix
>>(update) mailer.conf or POST-INSTALL-NOTES.
>
> It's inappropraite for mailer.conf(5) to provide examples for every MTA.
> Most users are able to read the page, get the idea and apply it. I'm
> confident you'd hit a brick wall trying to get that change committed to
> the FreeBSD base system.
>
> My opinion is that the combination of POST-INSTALL-NOTES and
> mailer.conf(5) is sufficient, and that you're just expecting too much
> handed to you on a plate.
>
> However, I'll keep my eyes open. If it turns out that other people find
> this confusing, I may spell it out in the POST-INSTALL-NOTES. :-)

How about a switch-to-exim.sh script? /usr/local/share/examples/exim/2exim.sh
... what would be an appropriate name?

-> we want to make the transition to exim as easy as possible, won't we?