From 06e9b9b05ff1b7708fd0acbb4b276ff839da931d Mon Sep 17 00:00:00 2001
From: William Blevins <wblevins@gmail.com>
Date: Sat, 9 Aug 2014 13:37:09 -0400
Subject: Updated Issue 2395 documentation per request.

---
 doc/user/factories.xml | 23 ++++++++++-------------
 1 file changed, 10 insertions(+), 13 deletions(-)

diff --git a/doc/user/factories.xml b/doc/user/factories.xml
index 815efe3..c8480db 100644
--- a/doc/user/factories.xml
+++ b/doc/user/factories.xml
@@ -177,25 +177,22 @@ touch $*
     </scons_output>
 
     <para>
-    The &Copy; factory supports symbolic link copying behavior
-    which is controlled by a third optional argument.
+    The &Copy; factory has a third optional argument which controls
+    how symlinks are copied.
     </para>
     
     <para>
-    Symbolic links shallow copied as new symbolic links:
     </para>
 
-    <para>
-    <literal>Command("LinkIn", "LinkOut1", Copy("$TARGET", "$SOURCE"[, True]))</literal>
-    </para>
+    <scons_example name="factories_SymlinkCopy">
+      <file name ="SymlinkCopy" printme="1">
+# Symbolic link shallow copied as a new symbolic link:
+Command("LinkIn", "LinkOut", Copy("$TARGET", "$SOURCE"[, True]))
 
-    <para>
-    Symbolic link deep copied as file target file or directory:
-    </para>
-    
-    <para>
-    <literal>Command("LinkIn", "FileOut", Copy("$TARGET", "$SOURCE", False))</literal>
-    </para>
+# Symbolic link target copied as a file or directory:
+Command("LinkIn", "FileOrDirectoryOut", Copy("$TARGET", "$SOURCE", False))
+      </file>
+    </scons_example>
 
   </section>
 
-- 
cgit v0.12