On Tue, Oct 11, 2011 at 03:14:26AM +1030, David Walker wrote:
> Hi.
>
Hi,
> In manXX.tgz (since 4.8) and also on web-cgi, the smtpd.conf(5) man
> page references makemap(8) more than once ...
> ... with explicit instructions to use that man page as a guide when
> making db maps and/or understanding the format of plain maps.
>
> The web-cgi page obviously hyperlinks to the other page.
>
> The makemap(8) man page - again in manXX.tgz and also on web-cgi -
> contains the following ...
>
> [...]
>
> ... both of which reference Sendmail ...
> ... both of which also reference the sendmail(8) man page ...
>
Seems sensible to me, considering that:
<!> The *default* MTA for OpenBSD is Sendmail, NOT OpenSMTPD. <!>
When we switch, the *default* man pages will be updated, but until then
the *default* man pages are those of the *default* MTA which you should
be running if you can't cope with glitches caused by coexistence of man
pages and utilities instaled by the *default* MTA and the one you chose
to run ... and that is not the *default* MTA.
I hope to have hinted you that you're not running the *default* MTA.
> http://www.openbsd.org/cgi-bin/cvsweb/src/usr.sbin/smtpd/makemap.8
>
> - smtpd's db maps are incompatible with sendmail's and needs a distinct
> makemap utility, this is needed for virtual users support amongst
> other things. links to smtpd's aliases.c and only provides a
> frontent to parse map descriptions. contains code from pyr@, chl@
> and I. Should have also been imported with smtpd.
>
> Etcetera.
>
> I feel ill.
>
Please, don't read the commit logs then.
That message was not intended to be read, let alone understood, by you.
It is a comment from a developer to other developers.
I fail to understand what point you are trying to make here anyways ...
> On 10/10/2011, Gilles Chehade <[email protected]> wrote:
> > This behavior is not specific to OpenSMTPD, at least Postfix ...
>
> That came as quite a surprise.
>
> [...]
>
There is a documentation bug.
Someone ran into it, kindly asked if it was a documentation bug, which
I confirmed along with an explanation of why domain keys are required,
and a quote from Postfix's
http://www.postfix.org/virtual.5.html (see VIRTUAL ALIAS DOMAINS)
to outline that this is not an OpenSMTPD-specific thingie.
Man page will be updated to fix the bug, live with it.
> If so, what's a good course of action?
> - outline it for me, and if I can do, it I will, help me get rid of
> some of the disappointment.
>
You can *easily* get rid of the disappointment by running the *default* MTA.
> If not, what can be done about users who read the man pages and have
> issues as a result?
> - presumably at some point, Sendmail will no longer be in base, man
> pages will get rotated, this will cease to be an issue. In the interim
> ...
>
In the interim, run the *default* MTA.
> I've apparently wasted a lot of time and enthusiasm on this ...
>
I've clearly wasted too much time on this mail.
--
Gilles Chehade
http://www.poolp.org/ http://u.poolp.org/~gilles/
