From 754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 Mon Sep 17 00:00:00 2001
From: Craig Jennings <c@cjennings.net>
Date: Sun, 7 Apr 2024 13:41:34 -0500
Subject: new repository

---
 devdocs/gnu_make/makefile-contents.html | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)
 create mode 100644 devdocs/gnu_make/makefile-contents.html

(limited to 'devdocs/gnu_make/makefile-contents.html')

diff --git a/devdocs/gnu_make/makefile-contents.html b/devdocs/gnu_make/makefile-contents.html
new file mode 100644
index 00000000..422e3212
--- /dev/null
+++ b/devdocs/gnu_make/makefile-contents.html
@@ -0,0 +1,20 @@
+  <h1 class="section">What Makefiles Contain</h1> <p>Makefiles contain five kinds of things: <em>explicit rules</em>, <em>implicit rules</em>, <em>variable definitions</em>, <em>directives</em>, and <em>comments</em>. Rules, variables, and directives are described at length in later chapters. </p> <ul> <li>   An <em>explicit rule</em> says when and how to remake one or more files, called the rule’s <em>targets</em>. It lists the other files that the targets depend on, called the <em>prerequisites</em> of the target, and may also give a recipe to use to create or update the targets. See <a href="rules">Writing Rules</a>. </li>
+<li>   An <em>implicit rule</em> says when and how to remake a class of files based on their names. It describes how a target may depend on a file with a name similar to the target and gives a recipe to create or update such a target. See <a href="implicit-rules">Using Implicit Rules</a>. </li>
+<li>  A <em>variable definition</em> is a line that specifies a text string value for a variable that can be substituted into the text later. The simple makefile example shows a variable definition for <code>objects</code> as a list of all object files (see <a href="variables-simplify">Variables Make Makefiles Simpler</a>). </li>
+<li>  A <em>directive</em> is an instruction for <code>make</code> to do something special while reading the makefile. These include: <ul> <li> Reading another makefile (see <a href="include">Including Other Makefiles</a>). </li>
+<li> Deciding (based on the values of variables) whether to use or ignore a part of the makefile (see <a href="conditionals">Conditional Parts of Makefiles</a>). </li>
+<li> Defining a variable from a verbatim string containing multiple lines (see <a href="multi_002dline">Defining Multi-Line Variables</a>). </li>
+</ul> </li>
+<li>   ‘<samp>#</samp>’ in a line of a makefile starts a <em>comment</em>. It and the rest of the line are ignored, except that a trailing backslash not escaped by another backslash will continue the comment across multiple lines. A line containing just a comment (with perhaps spaces before it) is effectively blank, and is ignored. If you want a literal <code>#</code>, escape it with a backslash (e.g., <code>\#</code>). Comments may appear on any line in the makefile, although they are treated specially in certain situations. <p>You cannot use comments within variable references or function calls: any instance of <code>#</code> will be treated literally (rather than as the start of a comment) inside a variable reference or function call. </p> <p>Comments within a recipe are passed to the shell, just as with any other recipe text. The shell decides how to interpret it: whether or not this is a comment is up to the shell. </p> <p>Within a <code>define</code> directive, comments are not ignored during the definition of the variable, but rather kept intact in the value of the variable. When the variable is expanded they will either be treated as <code>make</code> comments or as recipe text, depending on the context in which the variable is evaluated. </p>
+</li>
+</ul> <table class="menu" border="0" cellspacing="0"> <tr>
+<td align="left" valign="top">• <a href="splitting-lines" accesskey="1">Splitting Lines</a>
+</td>
+<td> </td>
+<td align="left" valign="top">Splitting long lines in makefiles </td>
+</tr> </table><div class="_attribution">
+  <p class="_attribution-p">
+    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. <br>Licensed under the GNU Free Documentation License.<br>
+    <a href="https://www.gnu.org/software/make/manual/html_node/Makefile-Contents.html" class="_attribution-link">https://www.gnu.org/software/make/manual/html_node/Makefile-Contents.html</a>
+  </p>
+</div>
-- 
cgit v1.2.3