Merge #5903 from rhaido/ansible

Update files documentation for usage of force=True and hardlinks

library/files/file

@@ -123,8 +123,7 @@ options:
     default: "no"
     choices: [ "yes", "no" ]
     description:
-      - 'force the creation of the symlinks in two cases: the source file does 
+      - 'force the creation of the symlinks when the destination exists and is a file (so, we need to unlink the
-        not exist (but will appear later); the destination exists and is a file (so, we need to unlink the
         "path" file and create symlink to the "src" file in place of it).'
 notes:
     - See also M(copy), M(template), M(assemble)
@@ -135,6 +134,10 @@ author: Michael DeHaan
 EXAMPLES = '''
 - file: path=/etc/foo.conf owner=foo group=foo mode=0644
 - file: src=/file/to/link/to dest=/path/to/symlink owner=foo group=foo state=link
+- file: path=/tmp/{{ item.path }} dest={{ item.dest }} state=link
+  with_items:
+    - { path: 'x', dest: 'y' }
+    - { path: 'z', dest: 'k' }
 '''
 
 def main():