document the new -t set mode of makemap, and add a paragraph describing

the use of makemap to generate a primary domains map

1 files changed, 19 insertions, 2 deletions

diff --git a/usr.sbin/smtpd/makemap.8 b/usr.sbin/smtpd/makemap.8
index 6ed73145779..e5257e1e4e2 100644
--- a/usr.sbin/smtpd/makemap.8
+++ b/usr.sbin/smtpd/makemap.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: makemap.8,v 1.11 2009/10/19 21:19:13 gilles Exp $
+.\"	$OpenBSD: makemap.8,v 1.12 2009/11/03 23:10:31 gilles Exp $
 .\"
 .\" Copyright (c) 2009 Jacek Masiulaniec <jacekm@openbsd.org>
 .\" Copyright (c) 2008-2009 Gilles Chechade <gilles@openbsd.org>
@@ -15,7 +15,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: October 19 2009 $
+.Dd $Mdocdate: November 3 2009 $
 .Dt MAKEMAP 8
 .Os
 .Sh NAME
@@ -69,10 +69,27 @@ The available output types are:
 The mapped value is a comma-separated list of mail destinations.
 This format can be used for building user aliases and
 virtual domains files.
+.It Cm set
+There is no mapped value, a map of this type will only allow for
+the lookup of keys. This format can be used for building primary
+domains maps.
 .El
 .Pp
 .El
 .Ex -std makemap
+.Sh PRIMARY DOMAINS
+Primary domains can be kept in maps.
+To create a primary domain map, add each primary domain on a
+single line by itself.
+.Pp
+In addition to adding an entry to the primary domain map,
+one must add a filter rule that accepts mail for the domain
+map, for example:
+.Bd -literal -offset indent
+map "primary" { source db "/etc/mail/primary.db" }
+
+accept for domain map "primary" deliver to mbox
+.Ed
 .Sh VIRTUAL DOMAINS
 Virtual domains are kept in maps.
 To create single virtual address, add