docs tweak/rebuild

modules.html

@@ -743,7 +743,16 @@ access to the remote resource.</p>
 <td>yes</td>
 <td>&nbsp;</td>
 <td>absolute path of where to download the file to.  If dest is a directory,
-the basename of the file on the remote server will be used.</td>
+the basename of the file on the remote server will be used.  If a
+directory, thirsty=yes must also be set.</td>
+</tr>
+<tr><td>thirsty</td>
+<td>no</td>
+<td>&#8216;no&#8217;</td>
+<td>(new in 0.7) if yes, will download the file every time and replace the
+file if the contents change.  if no, the file will only be downloaded
+if the destination does not exist.  Generally should be &#8216;yes&#8217; only for
+small local files.  prior to 0.6, acts if &#8216;yes&#8217; by default.</td>
 </tr>
 <tr><td>OTHERS</td>
 <td>no</td>
@@ -753,12 +762,7 @@ the basename of the file on the remote server will be used.</td>
 </tbody>
 </table>
 <p>Example action from Ansible <a class="reference internal" href="playbooks.html"><em>Playbooks</em></a>:</p>
-<div class="highlight-python"><pre>- name: Grab a bunch of jQuery stuff
+<div class="highlight-python"><pre>- action: get_url url=http://example.com/path/file.conf dest=/etc/foo.conf mode=0444</pre>
-   action: get_url url=http://code.jquery.com/$item  dest=${jquery_directory} mode=0444
-   with_items:
-   - jquery.min.js
-   - mobile/latest/jquery.mobile.min.js
-   - ui/jquery-ui-git.css</pre>
 </div>
 </div>
 <div class="section" id="git">

playbooks2.html

@@ -627,7 +627,6 @@ a good idea:</p>
   serial: 5
 
   tasks:
-
   - name: take out of load balancer pool
     action: command /usr/bin/take_out_of_pool $inventory_hostname
     delegate_to: 127.0.0.1
@@ -639,6 +638,19 @@ a good idea:</p>
     action: command /usr/bin/add_back_to_pool $inventory_hostname
     delegate_to: 127.0.0.1</pre>
 </div>
+<p>Here is the same playbook as above, but using the shorthand syntax,
+&#8216;local_action&#8217;, for delegating to 127.0.0.1:</p>
+<div class="highlight-python"><pre>---
+# ...
+  tasks:
+  - name: take out of load balancer pool
+    local_action: command /usr/bin/take_out_of_pool $inventory_hostname
+
+# ...
+
+  - name: add back to load balancer pool
+    local_action: command /usr/bin/add_back_to_pool $inventory_hostname</pre>
+</div>
 </div>
 <div class="section" id="style-points">
 <h2>Style Points<a class="headerlink" href="#style-points" title="Permalink to this headline">¶</a></h2>

rst/modules/get_url.rst

@@ -12,16 +12,18 @@ access to the remote resource.
 | url                | yes      |         | http, https, or ftp URL                                                    |
 +--------------------+----------+---------+----------------------------------------------------------------------------+
 | dest               | yes      |         | absolute path of where to download the file to.  If dest is a directory,   |
-|                    |          |         | the basename of the file on the remote server will be used.                |
+|                    |          |         | the basename of the file on the remote server will be used.  If a          |
+|                    |          |         | directory, thirsty=yes must also be set.                                   |
++--------------------+----------+---------+----------------------------------------------------------------------------+
+| thirsty            | no       | 'no'    | (new in 0.7) if yes, will download the file every time and replace the     |
+|                    |          |         | file if the contents change.  if no, the file will only be downloaded      |
+|                    |          |         | if the destination does not exist.  Generally should be 'yes' only for     |
+|                    |          |         | small local files.  prior to 0.6, acts if 'yes' by default.                |
 +--------------------+----------+---------+----------------------------------------------------------------------------+
 | OTHERS             | no       |         | all arguments accepted by the file module also work here                   |
 +--------------------+----------+---------+----------------------------------------------------------------------------+
 
 Example action from Ansible :doc:`playbooks`::
 
-    - name: Grab a bunch of jQuery stuff
+    - action: get_url url=http://example.com/path/file.conf dest=/etc/foo.conf mode=0444
-       action: get_url url=http://code.jquery.com/$item  dest=${jquery_directory} mode=0444
+
-       with_items:
-       - jquery.min.js
-       - mobile/latest/jquery.mobile.min.js
-       - ui/jquery-ui-git.css