From c8c7630c9523d18365953077522995995de0fc58 Mon Sep 17 00:00:00 2001 From: Ian Jackson Date: Wed, 13 Nov 2019 22:26:50 +0000 Subject: [PATCH] Documentation for regen.mk Signed-off-by: Ian Jackson --- subdirmk/regen.mk.in | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/subdirmk/regen.mk.in b/subdirmk/regen.mk.in index a6d9ad2..83952c9 100644 --- a/subdirmk/regen.mk.in +++ b/subdirmk/regen.mk.in @@ -3,6 +3,20 @@ # Copyright 2019 Ian Jackson # SPDX-License-Identifier: LGPL-2.0-or-later +# Usage: +# include subdirmk/regen.mk +# (probably in toplevel Subdir.sd.mk) +# +# Arranges that config.status is automatically rerun to update +# makefiles from templates, whenever a template *.sd.mk or *.mk.in is +# edited; and that autoconf is rerun if configure's inputs are edited. +# +# If you add includes to configure.ac, add them to CONFIGURE_ACS. +# +# Also provides a `realclean::' target at the toplevel which deletes +# the autoconf output. This may be made into a recursive target +# by mentioning &TARGETS_realclean in appropriate .sd.mk. + CONFIGURE ?= configure CONFIGURE_AC ?= $(CONFIGURE).ac CONFIG_STATUS ?= config.status -- 2.30.2