Merge pull request #222 from romeotheriault/copy-module-backup-option-docs

add backup option to the copy modules docs

rst/modules/assemble.rst

@@ -20,6 +20,9 @@ sorting order.  Puppet calls this idea "fragments".
 +--------------------+----------+---------+----------------------------------------------------------------------------+
 | dest               | yes      |         | A file to create using the concatenation of all of the source files        |
 +--------------------+----------+---------+----------------------------------------------------------------------------+
+| backup             | no       | no      | Create a backup file including the timestamp information so you can        |
+|                    |          |         | get the original file back if you somehow clobbered it incorrectly.        |
++--------------------+----------+---------+----------------------------------------------------------------------------+
 | OTHERS             |          |         | All arguments that the file module takes may also be used                  |
 +--------------------+----------+---------+----------------------------------------------------------------------------+
 

rst/modules/copy.rst

@@ -15,9 +15,16 @@ module.
 +--------------------+----------+---------+----------------------------------------------------------------------------+
 | dest               | yes      |         | Remote absolute path where the file should end up                          |
 +--------------------+----------+---------+----------------------------------------------------------------------------+
+| backup             | no       | no      | Create a backup file including the timestamp information so you can        |
+|                    |          |         | get the original file back if you somehow clobbered it incorrectly.        |
++--------------------+----------+---------+----------------------------------------------------------------------------+
 | OTHERS             |          |         | All arguments the file module takes are also supported                     |
 +--------------------+----------+---------+----------------------------------------------------------------------------+
 
 Example action from Ansible :doc:`playbooks`::
 
     copy src=/srv/myfiles/foo.conf dest=/etc/foo.conf owner=foo group=foo mode=0644
+
+Copy a new ntp.conf file into place, backing up the original if it differs from the copied version::
+
+    copy src=/srv/myfiles/ntp.conf dest=/etc/ntp.conf owner=root group=root mode=644 backup=yes

rst/modules/lineinfile.rst

@@ -30,6 +30,9 @@ For other cases, see the copy or template modules.
 |                    |          |         | inserting the line at the beginning of the file, and EOF for inserting the |
 |                    |          |         | line at the end of the file.                                               |
 +--------------------+----------+---------+----------------------------------------------------------------------------+
+| backup             | no       | no      | Create a backup file including the timestamp information so you can        |
+|                    |          |         | get the original file back if you somehow clobbered it incorrectly.        |
++--------------------+----------+---------+----------------------------------------------------------------------------+
 
 Example action from Ansible :doc:`playbooks`::
 

rst/modules/template.rst

@@ -18,6 +18,9 @@ documentation on the template formatting can be found in the
 +--------------------+----------+---------+----------------------------------------------------------------------------+
 | dest               | yes      |         | Location to render the template on the remote server                       |
 +--------------------+----------+---------+----------------------------------------------------------------------------+
+| backup             | no       | no      | Create a backup file including the timestamp information so you can        |
+|                    |          |         | get the original file back if you somehow clobbered it incorrectly.        |
++--------------------+----------+---------+----------------------------------------------------------------------------+
 | OTHERS             |          |         | This module also supports all of the arguments to the file module          |
 +--------------------+----------+---------+----------------------------------------------------------------------------+