Changes between Version 3 and Version 4 of kmk Quick Reference

Timestamp:

Apr 18, 2009, 2:08:24 PM (16 years ago)

Author:

bird

Comment:

Added recipes.

kmk Quick Reference

@@ -1 +1 @@
 {{{
 #!rst
+
 
 kmk Quick Reference
@@ -976 +977 @@
 
 
+Recipes
+-------
+
+    A typical recipe takes one of the two following forms::
+
+        targets : normal-prerequisites | order-only-prerequisites
+                command
+                ...
+
+        targets : normal-prerequisites | order-only-prerequisites ; command
+                command
+                ...
+
+    Specifying more than one file in the ``targets`` lists is the same as
+    repeating the recipe for each of the files.
+
+    Use ``+`` and ``+|`` in the list of ``targets`` to tell ``kmk`` that the
+    recipe has more than one output. [1]_ The files after a ``+`` will
+    always be remade, while the files after a ``+|`` don't have to be remade.
+    The latter is frequently employed to update files which prerequisites
+    change wihtout the output files necessarily changing. See also
+    ``kmk_cp --changed``.
+
+
+Double colon recipes
+
+    Double colon recipes are written with ``::`` instead of ``:`` and are
+    handled differently from ordinary recipes if the target appears in more
+    than one recipe. First, all the recipes must be of the double colon type.
+    Second, the recipes are executed individually and may be omitted depending
+    on the state of their prerequisites. Double colon recipes without any
+    prerequisites will always be executed.
+
+
+Pattern rules
+
+    A couple of examples::
+
+        %.o : %.c
+                gcc -o $@ $<
+        %.tab.c %.tab.h : %.y
+                bison -d $<
+
+    The latter has two outputs.
+
+
 -----
 
@@ -983 +1030 @@
 -----
 
-:Status: $Id: QuickReference-kmk.txt 2172 2008-12-31 00:03:02Z bird $
+:Status: $Id: QuickReference-kmk.txt 2340 2009-04-18 12:05:47Z bird $
 :Copyright: Copyright (C) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995,
             1996, 1997, 1998, 1999, 2000, 2002, 2003, 2004, 2005, 2006,
             2007 Free Software Foundation, Inc.
 
-            Copyright (C) 2008 Knut St. Osmundsen
+            Copyright (c) 2008-2009 knut st. osmundsen
 
 }}}