From 2cc726f84b9a3b7c1c5a963b5adf840ba38754fe Mon Sep 17 00:00:00 2001
From: Björn Persson <bjorn@rombobjörn.se>
Date: Fri, 18 Oct 2013 17:16:32 +0200
Subject: Wrote a pattern rule for making directories.

---
 manual.en.html | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

(limited to 'manual.en.html')

diff --git a/manual.en.html b/manual.en.html
index fbeb65c..e54dda0 100755
--- a/manual.en.html
+++ b/manual.en.html
@@ -520,6 +520,19 @@ root of the source tree. Here's an example:</p>
 
 <pre class="example gpr">for Source_Dirs use ($Srcdir &amp; "/tools");</pre>
 
+<h3 id="rules">Writing Make Rules</h3>
+
+<h4 id="making_directories">Making Directories</h4>
+
+<p>There is no need to write rules to make directories. Comfignat has a pattern
+rule that matches all pathnames that end with a slash, and creates the
+directory and its ancestors. Just specify the directory as an order-only
+prerequisite and be sure to append a slash. This rule ensures that the
+directory <var>data</var> exists before the file <var>db</var> is written:</p>
+
+<pre class="example make">${stage_statedir}/example/data/db: | ${stage_statedir}/example/data/
+	echo stuff > $@</pre>
+
 <h3 id="targets">Make Targets</h3>
 
 <p>These phony targets are defined in <var>comfignat.mk</var>:</p>
@@ -627,6 +640,8 @@ working in subdirectories use the right build and staging directories.</p></li>
 <li><p>The ability to save environment variables in the persistent
 configuration was added.</p></li>
 
+<li><p>The pattern rule for making directories was added.</p></li>
+
 <li><p>The Make targets <var>all</var>, <var>base</var> and
 <var>show_configuration</var> were added.</p></li>
 </ul>
-- 
cgit v1.2.3