Add some comments for variables and targets.

5 files changed, 352 insertions, 6 deletions

diff --git a/share/mk/bsd.dep.mk b/share/mk/bsd.dep.mk
index 9cdc00f..5bf3c3b 100644
--- a/share/mk/bsd.dep.mk
+++ b/share/mk/bsd.dep.mk
@@ -1,4 +1,32 @@
-#	$Id: bsd.dep.mk,v 1.5 1996/03/31 20:04:08 wosch Exp $
+#	$Id: bsd.dep.mk,v 1.3 1996/04/01 18:58:28 wosch Exp $
+#
+# The include file <bsd.dep.mk> handles Makefile dependencies.
+#
+#
+# +++ variables +++
+#
+# DEPENDFILE	dependencies file [.depend]
+#
+# MKDEP		Options for ${MKDEPCMD} [not set]
+#
+# MKDEPCMD	Makefile dependency list program [mkdep]
+# 
+# SRCS          List of source files (c, c++, assembler)
+#
+#
+# +++ targets +++
+#
+#	cleandepend:
+#		Remove depend and tags file
+#
+#	depend:
+#		Make the dependencies for the source files, and store
+#		them in the file ${DEPENDFILE}.
+#
+#	tags:
+#		Create a tags file for the source files.
+#
+
 
 MKDEPCMD?=	mkdep
 DEPENDFILE?=	.depend
diff --git a/share/mk/bsd.kmod.mk b/share/mk/bsd.kmod.mk
index 3934c58..00c72ac 100644
--- a/share/mk/bsd.kmod.mk
+++ b/share/mk/bsd.kmod.mk
@@ -1,5 +1,84 @@
 #	From: @(#)bsd.prog.mk	5.26 (Berkeley) 6/25/91
-#	$Id: bsd.kmod.mk,v 1.19 1996/04/03 12:08:52 phk Exp $
+#	$Id: bsd.kmod.mk,v 1.20 1996/04/29 15:37:30 wosch Exp $
+#
+# The include file <bsd.kmod.mk> handles installing Loadable Kernel Modules.
+# <bsd.kmod.mk> includes the file named "../Makefile.inc" if it exists,
+# as well as the include file <bsd.obj.mk>, <bsd.dep.mk>, and
+# may be <bsd.man.mk>
+#
+#
+# +++ variables +++
+#
+# CLEANFILES	Additional files to remove for the clean and cleandir targets.
+#
+# DISTRIBUTION  Name of distribution. [bin]
+#
+# EXPORT_SYMS	???
+#
+# KERN		Main Kernel source directory. [${.CURDIR}/../../sys/kern]
+#
+# KMOD          The name of the loadable kernel module to build.
+#
+# KMODDIR	Base path for loadable kernel modules
+#		(see lkm(4)). [/lkm]
+#
+# KMODOWN	LKM owner. [${BINOWN}]
+#
+# KMODGRP	LKM group. [${BINGRP}]
+#
+# KMODMODE	LKM mode. [${BINMODE}]
+#
+# LINKS		The list of LKM links; should be full pathnames, the
+#               linked-to file coming first, followed by the linked
+#               file.  The files are hard-linked.  For example, to link
+#               /lkm/master and /lkm/meister, use:
+#
+#			LINKS=  /lkm/master /lkm/meister
+#
+# LN_FLAGS	Flags for ln(1) (see variable LINKS)
+#
+# NOMAN		LKM does not have a manual page if set.
+#
+# PROG          The name of the loadable kernel module to build. 
+#		If not supplied, ${KMOD} is used.
+#
+# PSEUDO_LKM	???
+#
+# SRCS          List of source files 
+#
+# SUBDIR        A list of subdirectories that should be built as well.
+#               Each of the targets will execute the same target in the
+#               subdirectories.
+#
+# DESTDIR, DISTDIR are set by other Makefiles (e.g. bsd.own.mk)
+#
+#
+# +++ targets +++
+#
+#       distribute:
+#               This is a variant of install, which will
+#               put the stuff into the right "distribution".
+#
+# 	install:
+#               install the program and its manual pages; if the Makefile
+#               does not itself define the target install, the targets
+#               beforeinstall and afterinstall may also be used to cause
+#               actions immediately before and after the install target
+#		is executed.
+#
+# 	load:	
+#		Load LKM.
+#
+# 	tags:
+#		Create a tags file for the source files.
+#
+# 	unload:
+#		Unload LKM.
+#
+# bsd.obj.mk: clean, cleandir and obj
+# bsd.dep.mk: depend
+# bsd.man.mk: maninstall
+#
 
 .if exists(${.CURDIR}/../Makefile.inc)
 .include "${.CURDIR}/../Makefile.inc"
diff --git a/share/mk/bsd.man.mk b/share/mk/bsd.man.mk
index 6f1f392..ed4583b 100644
--- a/share/mk/bsd.man.mk
+++ b/share/mk/bsd.man.mk
@@ -1,4 +1,49 @@
-#	$Id: bsd.man.mk,v 1.10 1996/04/09 23:10:19 wosch Exp $
+#	$Id: bsd.man.mk,v 1.11 1996/05/25 21:50:54 wosch Exp $
+#
+# The include file <bsd.man.mk> handles installing manual pages and 
+# their links. <bsd.man.mk> includes the file named "../Makefile.inc" 
+# if it exists.
+#
+#
+# +++ variables +++
+#
+# DESTDIR	Change the tree where the man pages gets installed. [not set]
+#
+# MANDIR	Base path for manual installation. [${SHAREDIR}/man/man]
+#
+# MANOWN	Manual owner. [${SHAREOWN}]
+#
+# MANGRP	Manual group. [${SHAREGRP}]
+#
+# MANMODE	Manual mode. [${NOBINMODE}]
+#
+# MANSUBDIR	Subdirectory under the manual page section, i.e. "/i386"
+#		or "/tahoe" for machine specific manual pages.
+#
+# MAN${sect}	The manual pages to be installed. For sections see
+#		variable ${SECTIONS}
+#
+# _MANPAGES	List of all man pages to be installed.
+#		(``_MANPAGES=$MAN1 $MAN2 ... $MANn'')
+#
+# MCOMPRESS	Program to compress man pages. Output is to
+#		stdout. [gzip -c]
+#
+# MLINKS	List of manual page links (using a suffix). The
+#		linked-to file must come first, the linked file 
+#		second, and there may be multiple pairs. The files 
+#		are hard-linked.
+#
+# NOMANCOMPRESS	If you do not want unformatted manual pages to be 
+#		compressed when they are installed. [not set]
+#
+#
+# +++ targets +++
+#
+#	maninstall:
+#		Install the manual pages and their links.
+#
+
 
 .if exists(${.CURDIR}/../Makefile.inc)
 .include "${.CURDIR}/../Makefile.inc"
diff --git a/share/mk/bsd.own.mk b/share/mk/bsd.own.mk
index 2d5184e..a33b876 100644
--- a/share/mk/bsd.own.mk
+++ b/share/mk/bsd.own.mk
@@ -1,7 +1,122 @@
-#	$Id: bsd.own.mk,v 1.4 1996/03/24 00:31:56 wosch Exp $
-
+#	$Id: bsd.own.mk,v 1.5 1996/03/31 23:15:17 wosch Exp $
+#
+# The include file <bsd.own.mk> set common variables for owner,
+# group, mode, and directories. Defaults are in brackets.
+#
+#
+# +++ variables +++
+#
+# where the system object and source trees are kept; can be configurable
+# by the user in case they want them in ~/foosrc and ~/fooobj, for example
 # where the system object and source trees are kept; can be configurable
 # by the user in case they want them in ~/foosrc and ~/fooobj, for example
+# BSDOBJDIR	The real path to the system 'obj' tree, so that 'make obj'
+#		will work correctly. [/usr/obj]
+#
+# BSDSRCDIR	The real path to the system sources, so that 'make obj'
+#		will work correctly. [/usr/src]
+#
+# DESTDIR	Change the tree where the file gets installed. [not set]
+#
+# DISTDIR	Change the tree where the file for a distribution
+# 		gets installed (see /usr/src/release/Makefile). [not set]
+#
+#
+# COPY		The flag passed to the install program to cause the binary
+#		to be copied rather than moved.  This is to be used when
+#		building our own install script so that the entire system
+#		can either be installed with copies, or with moves using
+#		a single knob. [-c]
+#
+# STRIP		The flag passed to the install program to cause the binary
+#		to be stripped.  This is to be used when building your
+#		own install script so that the entire system can be made
+#		stripped/not-stripped using a single knob. [-s]
+#
+#
+#
+# BINOWN	Binary owner. [bin]
+#
+# BINGRP	Binary group. [bin]
+#
+# BINMODE	Binary mode. [555]
+#
+# NOBINMODE	Mode for non-executable files. [444]
+#
+#
+# LIBDIR	Base path for libraries. [/usr/lib]
+#
+# LINTLIBDIR	Base path for lint libraries. [/usr/libdata/lint]
+#
+# SHLIBDIR	Base path for shared libraries. [${LIBDIR}]
+#
+# LIBOWN	Library mode. [${BINOWN}]
+#
+# LIBGRP	Library group. [${BINGRP}]
+#
+# LIBMODE	Library mode. [${NOBINMODE}]
+#
+#
+# KMODDIR	Base path for loadable kernel modules
+#		(see lkm(4)). [/lkm]
+#
+# KMODOWN	LKM owner. [${BINOWN}]
+#
+# KMODGRP	LKM group. [${BINGRP}]
+#
+# KMODMODE	LKM mode. [${BINMODE}]
+#
+#
+# SHAREDIR	Base path for architecture-independent ascii
+#		text files. [/usr/share]
+#
+# SHAREOWN	ASCII text file owner. [bin]
+#
+# SHAREGRP	ASCII text file group. [bin]
+#
+# SHAREMODE	ASCII text file mode. [${NOBINMODE}]
+#
+#
+# DOCDIR	Base path for system documentation (e.g. PSD, USD,
+#		handbook, FAQ etc.). [${SHAREDIR}/doc]
+#
+# DOCOWN	Documentation owner. [${SHAREOWN}]
+#
+# DOCGRP	Documentation group. [${SHAREGRP}]
+#
+# DOCMODE	Documentation mode. [${NOBINMODE}]
+#
+#
+# INFODIR	Base path for GNU's hypertext system
+#		called Info (see info(1)). [${SHAREDIR}/info]
+#
+# INFOOWN	Info owner. [${SHAREOWN}]
+#
+# INFOGRP	Info group. [${SHAREGRP}]
+#
+# INFOMODE	Info mode. [${NOBINMODE}]
+#
+#
+# MANDIR	Base path for manual installation. [${SHAREDIR}/man/man]
+#
+# MANOWN	Manual owner. [${SHAREOWN}]
+#
+# MANGRP	Manual group. [${SHAREGRP}]
+#
+# MANMODE	Manual mode. [${NOBINMODE}]
+#
+#
+# NLSDIR	Base path for National Language Support files
+#		installation (see mklocale(1)). [${SHAREDIR}/nls]
+#
+# NLSGRP	National Language Support files group. [${SHAREOWN}]
+#
+# NLSOWN	National Language Support files owner. [${SHAREGRP}]
+#
+# NLSMODE	National Language Support files mode. [${NONBINMODE}]
+#
+
+
 BSDSRCDIR?=	/usr/src
 BSDOBJDIR?=	/usr/obj
 
diff --git a/sys/conf/kmod.mk b/sys/conf/kmod.mk
index 3934c58..00c72ac 100644
--- a/sys/conf/kmod.mk
+++ b/sys/conf/kmod.mk
@@ -1,5 +1,84 @@
 #	From: @(#)bsd.prog.mk	5.26 (Berkeley) 6/25/91
-#	$Id: bsd.kmod.mk,v 1.19 1996/04/03 12:08:52 phk Exp $
+#	$Id: bsd.kmod.mk,v 1.20 1996/04/29 15:37:30 wosch Exp $
+#
+# The include file <bsd.kmod.mk> handles installing Loadable Kernel Modules.
+# <bsd.kmod.mk> includes the file named "../Makefile.inc" if it exists,
+# as well as the include file <bsd.obj.mk>, <bsd.dep.mk>, and
+# may be <bsd.man.mk>
+#
+#
+# +++ variables +++
+#
+# CLEANFILES	Additional files to remove for the clean and cleandir targets.
+#
+# DISTRIBUTION  Name of distribution. [bin]
+#
+# EXPORT_SYMS	???
+#
+# KERN		Main Kernel source directory. [${.CURDIR}/../../sys/kern]
+#
+# KMOD          The name of the loadable kernel module to build.
+#
+# KMODDIR	Base path for loadable kernel modules
+#		(see lkm(4)). [/lkm]
+#
+# KMODOWN	LKM owner. [${BINOWN}]
+#
+# KMODGRP	LKM group. [${BINGRP}]
+#
+# KMODMODE	LKM mode. [${BINMODE}]
+#
+# LINKS		The list of LKM links; should be full pathnames, the
+#               linked-to file coming first, followed by the linked
+#               file.  The files are hard-linked.  For example, to link
+#               /lkm/master and /lkm/meister, use:
+#
+#			LINKS=  /lkm/master /lkm/meister
+#
+# LN_FLAGS	Flags for ln(1) (see variable LINKS)
+#
+# NOMAN		LKM does not have a manual page if set.
+#
+# PROG          The name of the loadable kernel module to build. 
+#		If not supplied, ${KMOD} is used.
+#
+# PSEUDO_LKM	???
+#
+# SRCS          List of source files 
+#
+# SUBDIR        A list of subdirectories that should be built as well.
+#               Each of the targets will execute the same target in the
+#               subdirectories.
+#
+# DESTDIR, DISTDIR are set by other Makefiles (e.g. bsd.own.mk)
+#
+#
+# +++ targets +++
+#
+#       distribute:
+#               This is a variant of install, which will
+#               put the stuff into the right "distribution".
+#
+# 	install:
+#               install the program and its manual pages; if the Makefile
+#               does not itself define the target install, the targets
+#               beforeinstall and afterinstall may also be used to cause
+#               actions immediately before and after the install target
+#		is executed.
+#
+# 	load:	
+#		Load LKM.
+#
+# 	tags:
+#		Create a tags file for the source files.
+#
+# 	unload:
+#		Unload LKM.
+#
+# bsd.obj.mk: clean, cleandir and obj
+# bsd.dep.mk: depend
+# bsd.man.mk: maninstall
+#
 
 .if exists(${.CURDIR}/../Makefile.inc)
 .include "${.CURDIR}/../Makefile.inc"