diff --git a/etc/mailer.conf b/etc/mailer.conf
index 069e2056e00f..8174db81821d 100644
--- a/etc/mailer.conf
+++ b/etc/mailer.conf
@@ -1,12 +1,17 @@
-#	$NetBSD: mailer.conf,v 1.11 2005/02/16 14:47:46 jwise Exp $
+#	$NetBSD: mailer.conf,v 1.12 2005/02/19 17:25:16 perry Exp $
 #
-# Execute the "real" Sendmail program
+# This file configures /usr/sbin/mailwrapper, which selects the MTA
+# (Mail Transport Agent) that is is invoked when programs like
+# /usr/sbin/sendmail are executed.
+# 
+# See mailwrapper(8) and mailer.conf(5) for an explanation of how this works.
+# See also rc.conf(5) and afterboot(8) for more details on setting up an MTA.
 #
-# Note that sendmail will start by default if this path is not changed.
-# If you want to use another mailer (postfix, exim, qmail, etc), it is
-# vital that the following lines be commented out.  See rc.conf(5),
-# mailer.conf(5), and afterboot(8) for more details.
 #
+# The following configuration is correct for Sendmail
+# If you want to use another mailer (postfix, exim, qmail, etc),
+# replace these lines with appropriate substitutes.
+
 sendmail	/usr/libexec/sendmail/sendmail
 send-mail	/usr/libexec/sendmail/sendmail
 mailq		/usr/libexec/sendmail/sendmail
@@ -14,8 +19,7 @@ newaliases	/usr/libexec/sendmail/sendmail
 hoststat	/usr/libexec/sendmail/sendmail
 purgestat	/usr/libexec/sendmail/sendmail
 
-#
-# Run Sendmail compatible Postfix commands
+# The following (commented out) configuration is correct for Postfix.
 #
 # Notes for running postfix:
 #  - postfix configuration requires either