>Number:         30175
>Category:       misc
>Synopsis:       (pf)spamd manpages inaccurate and erroneous
>Confidential:   no
>Severity:       serious
>Priority:       high
>Responsible:    misc-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Mon May 09 11:41:00 +0000 2005
>Originator:     Peter Postma
>Release:        NetBSD 3.99.3
>Organization:
>Environment:
System: NetBSD mercury.pointless.nl 3.99.3 NetBSD 3.99.3 (mercury) #0: Wed May 4 11:25:46 CEST 2005 peter@mercury.pointless.nl:/usr/obj/sys/arch/sparc64/compile/mercury sparc64
Architecture: sparc64
Machine: sparc64
>Description:
	After the renaming of spamd -> pfspamd (and all related programs),
	the manpages now contain erroneous information. One example:

	The pfspamdb(8) says "spamdb" everywhere while the program is now
	called "pfspamdb". There are references to the old spamd programs.
	There's a reference to /var/db/spamd which is now /var/db/pfspamd.
	The history section doesn't tell me that the programs were renamed
	and for what reason.

	Another odd thing:
	etcupdate(8) wants to install /etc/spamd.conf but I can't find
	the manpage for spamd.conf.
>How-To-Repeat:
	Read the manpages for spamd, etc.
>Fix:
	There are a few options:

	1) Remove spamd from base and put it into pkgsrc.
	2) Audit all manpages and fix the breakage.
	3) Rename pfspamd back to spamd :-)

	Personally I would go for 1) and here's why:
	spamd was imported with the excuse: "it's part of pf", but
	in fact it is not. spamd was developed a while after pf was made
	and the only relation it has with pf is that it redirect smtp
	connections (IPF can do that too) and it can use tables for
	white/grey- listing. So if they (OpenBSD) make a webserver or
	whatever program that can use advantage of pf, should we import
	that too? I think we should selective about which software would be
	useful to have in the base system and which would be not.
	A spam deferral daemon that no-one uses in the base system while
	there exists a similar heavily used app in pkgsrc (spamassassin)
	is IMHO _not_ useful.

	If we look at FreeBSD and DragonFly BSD, then we can find pf
	in the base system but not spamd. Now have a guess why they
	didn't imported spamd...
	Many people have asked to move it to pkgsrc since the import, so
	can we please do this? I don't think anyone uses (pf)spamd because
	no-one complained after the rename and we didn't shipped a release
	with it yet. There's currently an (old) version of spamd in
	pkgsrc-wip and I am willing to prepare it for pkgsrc if we decide
	to remove spamd from the base system.