From 5a3a06afd218c1f913a843c63dc58ad6e40c6535 Mon Sep 17 00:00:00 2001
From: Fredrik Medley <fredrik.medley@gmail.com>
Date: Tue, 2 Jun 2015 16:30:57 +0200
Subject: Describe how to make a phony rule always up to date

A phony rule with no input is always out of date. Describe how to make a
rule always up to date.

Signed-off-by: Fredrik Medley <fredrik.medley@gmail.com>
---
 doc/manual.asciidoc | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/doc/manual.asciidoc b/doc/manual.asciidoc
index d7ec932..df4199a 100644
--- a/doc/manual.asciidoc
+++ b/doc/manual.asciidoc
@@ -445,6 +445,14 @@ without any dependencies, the target will be considered out of date if
 it does not exist.  Without a phony build statement, Ninja will report
 an error if the file does not exist and is required by the build.
 
+To create a rule that never rebuilds, use a build rule without any input:
+----------------
+rule touch
+  command = touch $out
+build file_that_always_exists.dummy: touch
+build dummy_target_to_follow_a_pattern: phony file_that_always_exists.dummy
+----------------
+
 
 Default target statements
 ~~~~~~~~~~~~~~~~~~~~~~~~~
-- 
cgit v0.12

