From f7384a54a0d60838d10130f70790b4a16584c746 Mon Sep 17 00:00:00 2001
From: William Blevins <wblevins@gmail.com>
Date: Sun, 20 Jul 2014 15:16:12 -0400
Subject: Issue 2395: Added user guide details for Copy symbolic link support.

---
 doc/user/factories.xml | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/doc/user/factories.xml b/doc/user/factories.xml
index 08f20e6..815efe3 100644
--- a/doc/user/factories.xml
+++ b/doc/user/factories.xml
@@ -176,6 +176,27 @@ touch $*
       <scons_output_command>scons -Q</scons_output_command>
     </scons_output>
 
+    <para>
+    The &Copy; factory supports symbolic link copying behavior
+    which is controlled by a third optional argument.
+    </para>
+    
+    <para>
+    Symbolic links shallow copied as new symbolic links:
+    </para>
+
+    <para>
+    <literal>Command("LinkIn", "LinkOut1", Copy("$TARGET", "$SOURCE"[, True]))</literal>
+    </para>
+
+    <para>
+    Symbolic link deep copied as file target file or directory:
+    </para>
+    
+    <para>
+    <literal>Command("LinkIn", "FileOut", Copy("$TARGET", "$SOURCE", False))</literal>
+    </para>
+
   </section>
 
   <section>
-- 
cgit v0.12