From c6778e796ce8af8d4c3a0631729b47fdc1e9dc47 Mon Sep 17 00:00:00 2001 From: Lorin Hochstein Date: Sun, 17 Feb 2013 12:55:47 -0500 Subject: [PATCH] Specified when PIPE_ONCE was added. Also, now shows when "Getting values from files" was added, a sphinx directive was missing a colon. --- docsite/rst/playbooks2.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docsite/rst/playbooks2.rst b/docsite/rst/playbooks2.rst index 2efbaac6e4..ec8f1ae5b2 100644 --- a/docsite/rst/playbooks2.rst +++ b/docsite/rst/playbooks2.rst @@ -567,7 +567,7 @@ Negative numbers are not supported. This works as follows:: Getting values from files ````````````````````````` -.. versionadded: 0.8 +.. versionadded:: 0.8 Sometimes you'll want to include the content of a file directly into a playbook. You can do so using a macro. This syntax will remain in future versions, though we will also will provide ways to do this via lookup plugins (see "More Loops") as well. What follows @@ -587,6 +587,8 @@ Because Ansible uses lazy evaluation, a "$PIPE" macro will be executed each time example, it will be executed separately for each host, and if it is used in a variable definition, it will be executed each time the variable is evaluated. +.. versionadded:: 1.1 + The "$PIPE_ONCE" macro is an alternative that uses a caching strategy: it is executed only once, and subsequent accesses use the cached value. One use case is for computing a timestamp that is intended to be the same across all tasks and hosts that use it::