bsdowl 2.2.2-1 / usr / share / mk / bps.files.mk

# Cookie: SYNOPSIS TARGET VARIABLE EN DOCUMENTATION
### bps.files.mk -- Service générique d'installation

# Auteur: Michael Grünewald
# Date: Ven 10 fév 2006 10:40:49 GMT

# BSD Owl Scripts (https://bitbucket.org/michipili/bsdowl)
# This file is part of BSD Owl Scripts
#
# Copyright © 2005–2014 Michael Grünewald
#
# This file must be used under the terms of the CeCILL-B.
# This source file is licensed as described in the file COPYING, which
# you should have received as part of this distribution. The terms
# are also available at
# http://www.cecill.info/licences/Licence_CeCILL-B_V1-en.txt


### SYNOPSIS

# TYPE1+= file1.type1
# TYPE1+= file2.type1
# TYPE2 = file.type
#
# TYPE1MODE.file1.type1 = 444
# TYPE1NAME.file2.type1 = fancyname
#
# FILESGROUPS =	TYPE1 TYPE2
# TYPE1OWN = owner
# TYPE1GRP = group
# TYPE1DIR = ${X11PREFIX}/directory		# Will respect ${DESTDIR}
# TYPE1MODE = 400
#
# .include "bps.init.mk"
# .include "bps.files.mk"
# .include "bps.usertarget.mk"


### DESCRIPTION

# Le module `bps.files.mk' propose une procédure générique
# d'installation pour les modules clients.
#
# Le module `bps.files.mk' définit une notion de groupe d'objets,
# chaque groupe d'objet correspond à un ensemble de paramètres pour
# l'installation, soit l'emplacement, le propriétaire les droits
# d'accès et le nom; et à une liste d'objets. Pour chaque objet membre
# d'un groupe, des paramètres individuels peuvent êtres définis
# (cf. PARAMÈTRES INDIVIDUELS infra).
#
# Le module `bps.files.mk' définit encore des cibles/procédures
# `buildfiles' `installdirs' et `installfiles' à moins que celles-ci
# ne soient déjà définies par le client. Ceci permet au client
# d'utiliser des mécanismes spécifiques pour réaliser ces tâches
# lorsque les actions proposées par le module `bps.files.mk' se
# révèlent inappropriées.
#
# Le module `bps.files.mk' complète le graphe des dépendances en
# affirmant que `buildfiles' est un prérequis pour `all' et
# `installfiles'. Le module tient également compte des
# cibles/procédures preinstall et postinstall lorsqu'elles existent.

# Nota: ce fichier est dérivé de bsd.files.mk, distribué avec le
#  système FreeBSD.


#
# Description des variables
#

# FILESGROUPS
#
#  Énumération des groupes de fichiers réclamant la prise en charge de
#  leur installation par le module `bps.files.mk'.


#
# Paramètres individuels
#

# Les paramètres de la procédure d'installation du fichier '${file}'
# appartenant au groupe '${group}' sont décrites ici.

# ${group}DIR.${file:T}
#
#  Le dossier d'installation pour ${file}, relativement à
#  ${DESTDIR}. Si ce dossier n'existe sa création est réclamée par la
#  cible 'installdirs'.
#
#  La valeur implicite pour cette variable est ${group}DIR.

# ${group}NAME.${file:T}
#
#  Le nom d'installation pour ${file}, si celui-ci est différent de
#  celui de ${file}.
#
#  La valeur implicite pour cette variable est ${group}NAME. Remarquons
#  que si ${group}NAME est définie, alors tous les fichiers membres du
#  groupe ${group} sont installés au même emplacement; on ne
#  positionne donc la variable ${group}NAME que lorsque ce groupe ne
#  peut compter qu'un seul membre.

# ${group}OWN.${file:T}
#
#  Le propriétaire de ${file:T}.
#
#  La valeur implicite pour cette variable est ${group}OWN.

# ${group}GRP.${file:T}
#
#  Le groupe propriétaire de ${file:T}.
#
#  La valeur implicite pour cette variable est ${group}GRP.

# ${group}MODE.${file:T}
#
#  Le mode d'accès de ${file:T}. Voir chmod(2).
#
#  La valeur implicite pour cette variable est ${group}MODE.


#
# Définir de nouveaux groupes
#

# Définir de nouveaux groupes est très simple, comme le montre le
# petit exemple suivant.
#
# Pour créer un groupe SCRIPT, on reporte les déclarations suivantes
# dans un fichier de directives:
#
#   FILESGROUPS+= SCRIPT
#   SCRIPTDIR?= ${BINDIR}
#   SCRIPTOWN?= ${BINOWN}
#   SCRIPTGRP?= ${BINGRP}
#   SCRIPTMODE?= ${BINMODE}
#
# On peut bien entendu initialiser à sa guise les paramètres
# d'installation pour le groupe SCRIPT, le choix fait ici donne
# cependant un exemple réaliste.


### IMPLÉMENTATION

.if !target(__<bps.files.mk>__)
__<bps.files.mk>__:

.if !target(__<bps.init.mk>__)
.error Module bps.files.mk require bps.init.mk for proper processing.
.endif

FILESGROUPS+= FILES BIN DOC SHARE LIB

.include "bps.own.mk"

.if !target(buildfiles)
.for group in ${FILESGROUPS}
buildfiles: buildfiles-${group:L}
.PHONY: buildfiles-${group:L}
buildfiles-${group:L}: ${${group}}
.endfor
.endif

do-build: buildfiles
do-install: installdirs
do-install: installfiles

## PROCÉDURE D'INSTALLATION

# La procédure d'installation est située avant le calcul des variables
# ${_${group}_INSTALL.${file:T}} pour déterminer correctement la liste
# des répertoires devant être crées, à partir des variables GROUPDIR
# et GROUPDIR.specialisation.

.if !target(installfiles)
installfiles:
.PHONY: installfiles
.for group in ${FILESGROUPS}
.if defined(${group}) && !empty(${group})
installfiles: installfiles-${group:L}
.PHONY: installfiles-${group:L}
installfiles-${group:L}:
.for file in ${${group}}
installfiles-${group:L}: installfiles-${group:L}-${file:T}
installfiles-${group:L}-${file:T}: ${file}
	${_${group}_INSTALL.${file:T}}
.PHONY: installfiles-${group:L}-${file:T}
.endfor #file in ${${group}}
.endif #defined(${group})&&!empty(${group})
.endfor #group in ${FILESGROUPS}
.endif #!target(installfiles)

.if !target(installdirs)
installdirs:
.for group in ${FILESGROUPS}
.if defined(${group}) && !empty(${group})
	${INSTALL_DIR} ${DESTDIR}${${group}DIR}
.for item in ${${group}}
.if defined(${group}DIR.${item:T})&&!empty(${group}DIR.${item:T})
	${INSTALL_DIR} ${DESTDIR}${${group}DIR.${item:T}}
.endif
.endfor
.endif #defined(${group})&&!empty(${group})
.endfor #group in ${FILESGROUPS}
.endif #!target(installdirs)

installfiles: buildfiles


## CALCUL DES PARAMÈTRES D'INSTALLATION

.for group in ${FILESGROUPS}
.if defined(${group}) && !empty(${group})
${group}OWN?=	${SHAREOWN}
${group}GRP?=	${SHAREGRP}
${group}MODE?=	${SHAREMODE}
${group}DIR?=	${SHAREDIR}
# Nota: le module bsd.files.mk propose BINDIR comme répertoire
#  implicite pour l'installation.
.for file in ${${group}}
.for record in DIR OWN GRP MODE
${group}${record}.${file:T}?=${${group}${record}}
.endfor
.if defined(${group}NAME)
${group}NAME.${file:T}?=${${group}NAME}
.endif
.if !defined(_${group}_INSTALL.${file:T})
_${group}_INSTALL.${file:T}=${INSTALL}\
-o ${${group}OWN.${file:T}}\
-g ${${group}GRP.${file:T}}\
-m ${${group}MODE.${file:T}}\
${.ALLSRC}
.if defined(${group}NAME.${file:T})
_${group}_INSTALL.${file:T}+=\
${DESTDIR}${${group}DIR.${file:T}}/${${group}NAME.${file:T}}
.else
_${group}_INSTALL.${file:T}+=\
${DESTDIR}${${group}DIR.${file:T}}
.endif
.endif
.endfor #file in ${${group}}
.endif #defined(${group})&&!empty(${group})
.endfor #group in ${FILESGROUPS}

.endif #!target(__<bps.files.mk>__)

### End of file `bps.files.mk'