From 3f74dd65926aa1ae44a95d5e06c3aea07ca0f133 Mon Sep 17 00:00:00 2001
From: Mike Grozak <mike.grozak@gmail.com>
Date: Fri, 7 Feb 2014 14:29:20 +0100
Subject: [PATCH] Updated the force parameter description; added one example
 how to create the symlinks pointing to non-absolute paths

---
 files/file | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/files/file b/files/file
index 7f789242df2..ac766839f16 100644
--- a/files/file
+++ b/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 
-        not exist (but will appear later); the destination exists and is a file (so, we need to unlink the
+      - 'force the creation of the symlinks when 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():