From 754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Sun, 7 Apr 2024 13:41:34 -0500 Subject: new repository --- devdocs/gnu_make/rules.html | 76 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 76 insertions(+) create mode 100644 devdocs/gnu_make/rules.html (limited to 'devdocs/gnu_make/rules.html') diff --git a/devdocs/gnu_make/rules.html b/devdocs/gnu_make/rules.html new file mode 100644 index 00000000..cf9e075f --- /dev/null +++ b/devdocs/gnu_make/rules.html @@ -0,0 +1,76 @@ +

Writing Rules

A rule appears in the makefile and says when and how to remake certain files, called the rule’s targets (most often only one per rule). It lists the other files that are the prerequisites of the target, and the recipe to use to create or update the target.

The order of rules is not significant, except for determining the default goal: the target for make to consider, if you do not otherwise specify one. The default goal is the first target of the first rule in the first makefile. There are two exceptions: a target starting with a period is not a default unless it also contains one or more slashes, ‘/’; and, a target that defines a pattern rule has no effect on the default goal. (See Defining and Redefining Pattern Rules.)

Therefore, we usually write the makefile so that the first rule is the one for compiling the entire program or all the programs described by the makefile (often with a target called ‘all’). See Arguments to Specify the Goals.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
• Rule Example + An example explained.
• Rule Syntax + General syntax explained.
• Prerequisite Types + There are two types of prerequisites.
• Wildcards + Using wildcard characters such as ‘*’.
• Directory Search + Searching other directories for source files.
• Phony Targets + Using a target that is not a real file’s name.
• Force Targets + You can use a target without a recipe or prerequisites to mark other targets as phony.
• Empty Targets + When only the date matters and the files are empty.
• Special Targets + Targets with special built-in meanings.
• Multiple Targets + When to make use of several targets in a rule.
• Multiple Rules + How to use several rules with the same target.
• Static Pattern + Static pattern rules apply to multiple targets and can vary the prerequisites according to the target name.
• Double-Colon + How to use a special kind of rule to allow several independent rules for one target.
• Automatic Prerequisites + How to automatically generate rules giving prerequisites from source files themselves.
+

+ Copyright © 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022 Free Software Foundation, Inc.
Licensed under the GNU Free Documentation License.
+ https://www.gnu.org/software/make/manual/html_node/Rules.html +

+
-- cgit v1.2.3