7d4a994791
of smaller doc.<foo>.mk files, reflecting the functionality they contain.
Long overdue, kudos to the submitter for the carrying out the work.
Also makes the files independent of the system include files that
normally live in /usr/share/mk, making it easier for non-FreeBSD systems
to download and build our docs (an important factor in making it easier
to share our work with other projects).
Finally, it (in theory) lets you build the docs with a r/o doc/ directory.
Changes to the submitted files:
doc.docbook.mk The HTML generation depends on ${DSLHTML}, and the
print generation depends on ${DSLPRINT}. Changing
these files will force a rebuild (which makes testing
changes a little easier).
Removed ${DOC}.doc target. It's a hangover from when
I (mistakenly) thought that Jade could generate MS Word
.doc files.
Added support for using compress(1) to build .Z files
(been on my todo list for ages).
Fixed a couple of typos.
Submitted by: Neil Blakey-Milner <nbm@mithrandr.moria.org>
108 lines
2.7 KiB
Makefile
108 lines
2.7 KiB
Makefile
#
|
|
# $Id: doc.install.mk,v 1.1 1999-09-03 17:07:18 nik Exp $
|
|
#
|
|
#
|
|
# This include file <doc.install.mk> provides variables defining the default
|
|
# ownership, location, and installation method of files generated by the
|
|
# FreeBSD Documentation Project
|
|
#
|
|
# Since users often build and install documentation without root,
|
|
# default the document ownership to them, if they're not root.
|
|
#
|
|
|
|
# ------------------------------------------------------------------------
|
|
#
|
|
# Document-specific variables:
|
|
#
|
|
# NONE
|
|
#
|
|
|
|
# ------------------------------------------------------------------------
|
|
#
|
|
# User-modifiable variables:
|
|
#
|
|
# INSTALL_DOCS The command to use to install the documentation.
|
|
# Defaults to "install -o user -g group -m 444",
|
|
# roughly.
|
|
#
|
|
# Should honour DOCOWN, DOCGRP and DOCMODE.
|
|
#
|
|
# Should accept a list of files to install
|
|
# followed by the directory to install into.
|
|
#
|
|
# INSTALL_FLAGS Flags to pass to the default INSTALL_DOCS'
|
|
# install command. Useful options are [CdDp].
|
|
# See install(1) for more information.
|
|
#
|
|
# DOCDIR Where to install the documentation. Default is
|
|
# /usr/share/doc.
|
|
#
|
|
# DOCOWN Owner of the documents when installed. Forced
|
|
# to the user installing the documentation, if the
|
|
# user is not root. (for obvious reasons)
|
|
#
|
|
# DOCGRP Group of the documents when installed. Forced
|
|
# to the primary group of the documentation, if
|
|
# the user is not root. This action can be
|
|
# overriden by setting:
|
|
#
|
|
# DOCGRP_OVERRIDE Override the use of primary group when the user
|
|
# installing is not root. Sets GOCGRP to this
|
|
# instead.
|
|
#
|
|
# DOCMODE Mode of the documents when installed. Defaults
|
|
# to 444. See chmod(1).
|
|
#
|
|
# DOCDIR Installation directory. Defaults to
|
|
# /usr/share/doc
|
|
#
|
|
# PACKAGES Directory in which to put packages. Defaults to
|
|
# the packages directory under DOC_PREFIX, if it
|
|
# exists, else the current directory.
|
|
#
|
|
|
|
# ------------------------------------------------------------------------
|
|
#
|
|
# Make files included (if NOINCLUDEMK is not set):
|
|
#
|
|
# bsd.own.mk Default permissions and locations for install.
|
|
#
|
|
|
|
# Include system defaults, unless prevented.
|
|
.if !defined(NOINCLUDEMK)
|
|
.include <bsd.own.mk>
|
|
.endif
|
|
|
|
DOCOWN?= root
|
|
DOCGRP?= wheel
|
|
|
|
DOCMODE?= 0444
|
|
|
|
DOCDIR?= /usr/share/doc
|
|
|
|
.if exists(${DOC_PREFIX}/packages)
|
|
PACKAGES?= ${DOC_PREFIX}/packages
|
|
.else
|
|
PACKAGES?= ${.CURDIR}
|
|
.endif
|
|
|
|
# hack to set DOCOWN and DOCGRP to those of the user installing, if that
|
|
# user is not root.
|
|
|
|
USERID!= id -u
|
|
USERNAME!= id -un
|
|
GROUPNAME!= id -gn
|
|
|
|
.if ${USERID} != 0
|
|
DOCOWN:= ${USERNAME}
|
|
.if defined(DOCGRP_OVERRIDE)
|
|
DOCGRP:= ${DOCGRP_OVERRIDE}
|
|
.else
|
|
DOCGRP:= ${GROUPNAME}
|
|
.endif
|
|
.endif
|
|
|
|
# installation "script"
|
|
INSTALL_DOCS?= \
|
|
${INSTALL} -c ${INSTALL_FLAGS} -o ${DOCOWN} -g ${DOCGRP} -m ${DOCMODE}
|
|
|