Heinous merge from HEAD. Seems to basically work. Be on guard however.

git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/BRANCHES/WCM-DEV2/root@4137 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261

source/java/org/alfresco/service/cmr/repository/CopyService.java

@@ -39,6 +39,10 @@ public interface CopyService
      * If the new node resides in a different workspace the new node will
      * have the same id.  
      * <p>
+     * <b>NOTE:</b> It is up to the client code to set the name of the newly created node.
+     *              Use the {@link NodeService node service} and catch the
+     *              {@link DuplicateChildNodeNameException}
+     * <p>
      * If the new node resides in the same workspace then
      * the new node will have the Copy aspect applied to it which will 
      * reference the original node.     

source/java/org/alfresco/service/cmr/repository/NodeRef.java

@@ -36,6 +36,15 @@ public final class NodeRef implements EntityRef, Serializable
     private final StoreRef storeRef;
     private final String id;
 
+    /**
+     * @see #NodeRef(StoreRef, String)
+     * @see StoreRef#StoreRef(String, String)
+     */
+    public NodeRef(String protocol, String identifier, String id)
+    {
+        this(new StoreRef(protocol, identifier), id);
+    }
+    
     /**
      * Construct a Node Reference from a Store Reference and Node Id
      *