From 09fda1f5a360003211cdedd72dfddfaf735c7921 Mon Sep 17 00:00:00 2001
From: rillig <rillig@pkgsrc.org>
Date: Sat, 29 Sep 2007 13:49:21 +0000
Subject: Added documentation about manpage handling in pkgsrc. This still
 needs much work.

---
 mk/help/man.help | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 mk/help/man.help

diff --git a/mk/help/man.help b/mk/help/man.help
new file mode 100644
index 00000000000..664b06d3332
--- /dev/null
+++ b/mk/help/man.help
@@ -0,0 +1,36 @@
+# $NetBSD: man.help,v 1.1 2007/09/29 13:49:21 rillig Exp $
+#
+# The installation of manual pages (manpages) can be handled very flexibly
+# with pkgsrc, and is therefore quite complex.
+#
+# XXX:	Why do we need this complexity?
+#
+# TODO:	Document all the pkgsrc magic that concerns manpages.
+#
+# TODO:	Change pkgsrc so that this documentation is correct.
+#
+# TODO:	How should manpages be specified in the PLIST?
+#
+# TODO:	What happens if a package installs more or fewer than the requested
+#	manpages?
+#
+# User-settable variables:
+#
+# PKGMANDIR
+#	(See mk/defaults/mk.conf)
+#
+# MANINSTALL
+#	A list of installation types for manpages. Can contain one or more
+#	of the following:
+#
+#	* catinstall: Preformatted manpages are installed in
+#	  ${PREFIX}/${PKGMANDIR}/cat*.
+#
+#	* maninstall: Unformatted manpages are installed in
+#	  ${PREFIX}/${PKGMANDIR}/man*.
+#
+#	If this list is empty, no manpages are installed at all.
+#
+# See also:
+#	IMAKE_MANINSTALL
+#
-- 
cgit v1.2.3