From 3fb5c7751988d6e8e0193dba36828bb0eb0d7a41 Mon Sep 17 00:00:00 2001 From: Hugo Herbelin Date: Wed, 18 Nov 2020 12:17:14 +0100 Subject: Update doc/sphinx/practical-tools/utilities.rst Co-authored-by: Enrico Tassi --- doc/sphinx/practical-tools/utilities.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) (limited to 'doc/sphinx') diff --git a/doc/sphinx/practical-tools/utilities.rst b/doc/sphinx/practical-tools/utilities.rst index 748701ac75..5d36ec3cf9 100644 --- a/doc/sphinx/practical-tools/utilities.rst +++ b/doc/sphinx/practical-tools/utilities.rst @@ -133,10 +133,13 @@ The recommended approach is to invoke ``CoqMakefile`` from a standard @true The advantage of a wrapper, compared to directly calling the generated -``Makefile`` or to including it with an include directive, is that it +``Makefile``, is that it provides a target independent of the version of Coq to regenerate a ``Makefile`` specific to the current version of Coq. Additionally, the master ``Makefile`` can be extended with targets not specific to Coq. +Including the generated makefile with an include directive is +discouraged, since the contents of this file, including variable names and +status of rules, may change in the future. An optional file ``CoqMakefile.local`` can be provided by the user in order to extend ``CoqMakefile``. In particular one can declare custom actions to be -- cgit v1.2.3