From 29977a1d10071b45e4fcb38e88f99462e3738aa2 Mon Sep 17 00:00:00 2001
From: Benoit Maggi
Date: Tue, 10 Jun 2014 15:26:27 +0200
Subject: Bug 290261 - [Usability] Papyrus shall provide a copy/paste/cut
 feature  - add copy/paste user documentation

Change-Id: Ib9086d1b0bb74f0d07e1f388573686debd00c211
Signed-off-by: Benoit Maggi <benoit.maggi@cea.fr>
---
 .../org.eclipse.papyrus.doc.feature/feature.xml    | 140 +++++++++++----------
 .../org.eclipse.papyrus.copypaste.ui.doc/.project  |  22 ++++
 .../.settings/org.eclipse.core.resources.prefs     |   3 +
 .../META-INF/MANIFEST.MF                           |   8 ++
 .../about.html                                     |  28 +++++
 .../build.properties                               |   6 +
 .../plugin.properties                              |  16 +++
 .../plugin.xml                                     |  15 +++
 .../org.eclipse.papyrus.copypaste.ui.doc/pom.xml   |  14 +++
 .../resource/copypaste-main-toc.xml                |   7 ++
 .../resource/copypaste-toc.xml                     |  30 +++++
 .../resource/copypaste.html                        |   9 ++
 .../resource/copypaste.mediawiki                   | 106 ++++++++++++++++
 .../resource/images/ConstraintExample.png          | Bin 0 -> 8326 bytes
 .../resource/images/DiagramMenus.png               | Bin 0 -> 21943 bytes
 .../resource/images/ModelExplorerMenus.png         | Bin 0 -> 16150 bytes
 .../resource/images/PastePreferences.png           | Bin 0 -> 10794 bytes
 .../resource/images/RenameExample.png              | Bin 0 -> 3797 bytes
 .../resource/images/StereotypeStrategy.png         | Bin 0 -> 3799 bytes
 releng/top-pom-main.xml                            |   1 +
 20 files changed, 338 insertions(+), 67 deletions(-)
 create mode 100644 plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/.project
 create mode 100644 plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/.settings/org.eclipse.core.resources.prefs
 create mode 100644 plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/META-INF/MANIFEST.MF
 create mode 100644 plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/about.html
 create mode 100644 plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/build.properties
 create mode 100644 plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/plugin.properties
 create mode 100644 plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/plugin.xml
 create mode 100644 plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/pom.xml
 create mode 100644 plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/copypaste-main-toc.xml
 create mode 100644 plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/copypaste-toc.xml
 create mode 100644 plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/copypaste.html
 create mode 100644 plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/copypaste.mediawiki
 create mode 100644 plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/images/ConstraintExample.png
 create mode 100644 plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/images/DiagramMenus.png
 create mode 100644 plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/images/ModelExplorerMenus.png
 create mode 100644 plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/images/PastePreferences.png
 create mode 100644 plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/images/RenameExample.png
 create mode 100644 plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/images/StereotypeStrategy.png

diff --git a/features/papyrus-main-features/org.eclipse.papyrus.doc.feature/feature.xml b/features/papyrus-main-features/org.eclipse.papyrus.doc.feature/feature.xml
index 4c45abbca28..cc1ec626ec3 100644
--- a/features/papyrus-main-features/org.eclipse.papyrus.doc.feature/feature.xml
+++ b/features/papyrus-main-features/org.eclipse.papyrus.doc.feature/feature.xml
@@ -1,72 +1,78 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<feature
-      id="org.eclipse.papyrus.doc.feature"
-      label="Papyrus Documentation Feature"
-      version="1.0.0.qualifier"
-      provider-name="Eclipse Modeling Project">
-
-   <copyright url="http://www.eclipse.org/legal/epl-v10.html">
+<?xml version="1.0" encoding="UTF-8"?>
+<feature
+      id="org.eclipse.papyrus.doc.feature"
+      label="Papyrus Documentation Feature"
+      version="1.0.0.qualifier"
+      provider-name="Eclipse Modeling Project">
+
+   <copyright url="http://www.eclipse.org/legal/epl-v10.html">
       Copyright (c) 2013 CEA LIST
 All rights reserved.   This program and the accompanying materials
 are made available under the terms of the Eclipse Public License
 v1.0
 which accompanies this distribution, and is available at
-http://www.eclipse.org/legal/epl-v10.html
-   </copyright>
-
-   <license url="%licenseURL">
-      %license
-   </license>
-
-   <plugin
-         id="org.eclipse.papyrus.infra.gmfdiag.css.doc"
-         download-size="0"
-         install-size="0"
-         version="0.0.0"/>
-
-   <plugin
-         id="org.eclipse.papyrus.uml.search.ui.doc"
-         download-size="0"
-         install-size="0"
-         version="0.0.0"
-         unpack="false"/>
-
-   <plugin
-         id="org.eclipse.papyrus.cdo.ui.doc"
-         download-size="0"
-         install-size="0"
-         version="0.0.0"
-         unpack="false"/>
-
-   <plugin
-         id="org.eclipse.papyrus.uml.diagram.common.doc"
-         download-size="0"
-         install-size="0"
-         version="0.0.0"/>
-
-   <plugin
-         id="org.eclipse.papyrus.uml.diagram.profile.doc"
-         download-size="0"
-         install-size="0"
-         version="0.0.0"/>
-
-   <plugin
-         id="org.eclipse.papyrus.dsml.validation.doc"
-         download-size="0"
-         install-size="0"
-         version="0.0.0"
-         unpack="false"/>
-
-   <plugin
-         id="org.eclipse.papyrus.uml.doc"
-         download-size="0"
-         install-size="0"
-         version="0.0.0"/>
-
-   <plugin
-         id="org.eclipse.papyrus.views.properties.doc"
-         download-size="0"
-         install-size="0"
-         version="0.0.0"/>
-
-</feature>
+http://www.eclipse.org/legal/epl-v10.html
+   </copyright>
+
+   <license url="%licenseURL">
+      %license
+   </license>
+
+   <plugin
+         id="org.eclipse.papyrus.infra.gmfdiag.css.doc"
+         download-size="0"
+         install-size="0"
+         version="0.0.0"/>
+
+   <plugin
+         id="org.eclipse.papyrus.uml.search.ui.doc"
+         download-size="0"
+         install-size="0"
+         version="0.0.0"
+         unpack="false"/>
+
+   <plugin
+         id="org.eclipse.papyrus.cdo.ui.doc"
+         download-size="0"
+         install-size="0"
+         version="0.0.0"
+         unpack="false"/>
+
+   <plugin
+         id="org.eclipse.papyrus.uml.diagram.common.doc"
+         download-size="0"
+         install-size="0"
+         version="0.0.0"/>
+
+   <plugin
+         id="org.eclipse.papyrus.uml.diagram.profile.doc"
+         download-size="0"
+         install-size="0"
+         version="0.0.0"/>
+
+   <plugin
+         id="org.eclipse.papyrus.dsml.validation.doc"
+         download-size="0"
+         install-size="0"
+         version="0.0.0"
+         unpack="false"/>
+
+   <plugin
+         id="org.eclipse.papyrus.uml.doc"
+         download-size="0"
+         install-size="0"
+         version="0.0.0"/>
+
+   <plugin
+         id="org.eclipse.papyrus.views.properties.doc"
+         download-size="0"
+         install-size="0"
+         version="0.0.0"/>
+
+   <plugin
+         id="org.eclipse.papyrus.copypaste.ui.doc"
+         download-size="0"
+         install-size="0"
+         version="0.0.0"/>
+
+</feature>
diff --git a/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/.project b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/.project
new file mode 100644
index 00000000000..9bccafb869e
--- /dev/null
+++ b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/.project
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>org.eclipse.papyrus.copypaste.ui.doc</name>
+	<comment></comment>
+	<projects>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>org.eclipse.pde.ManifestBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>org.eclipse.pde.SchemaBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>org.eclipse.pde.PluginNature</nature>
+	</natures>
+</projectDescription>
diff --git a/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/.settings/org.eclipse.core.resources.prefs b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/.settings/org.eclipse.core.resources.prefs
new file mode 100644
index 00000000000..e778789326a
--- /dev/null
+++ b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/.settings/org.eclipse.core.resources.prefs
@@ -0,0 +1,3 @@
+eclipse.preferences.version=1
+encoding//resource/copypaste-toc.xml=utf-8
+encoding//resource/copypaste.html=utf-8
diff --git a/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/META-INF/MANIFEST.MF b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/META-INF/MANIFEST.MF
new file mode 100644
index 00000000000..d96f4060e09
--- /dev/null
+++ b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/META-INF/MANIFEST.MF
@@ -0,0 +1,8 @@
+Manifest-Version: 1.0
+Require-Bundle: org.eclipse.help
+Bundle-ManifestVersion: 2
+Bundle-Name: %pluginName
+Bundle-SymbolicName: org.eclipse.papyrus.copypaste.ui.doc;singleton:=true
+Bundle-Version: 1.0.0.qualifier
+Bundle-Vendor: %providerName
+Bundle-Localization: plugin
diff --git a/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/about.html b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/about.html
new file mode 100644
index 00000000000..35ab843b7db
--- /dev/null
+++ b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/about.html
@@ -0,0 +1,28 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"/>
+<title>About</title>
+</head>
+<body lang="EN-US">
+<h2>About This Content</h2>
+ 
+<p>May, 2014</p>	
+<h3>License</h3>
+
+<p>The Eclipse Foundation makes available all content in this plug-in (&quot;Content&quot;).  Unless otherwise 
+indicated below, the Content is provided to you under the terms and conditions of the
+Eclipse Public License Version 1.0 (&quot;EPL&quot;).  A copy of the EPL is available 
+at <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a>.
+For purposes of the EPL, &quot;Program&quot; will mean the Content.</p>
+
+<p>If you did not receive this Content directly from the Eclipse Foundation, the Content is 
+being redistributed by another party (&quot;Redistributor&quot;) and different terms and conditions may
+apply to your use of any object code in the Content.  Check the Redistributor's license that was 
+provided with the Content.  If no such license exists, contact the Redistributor.  Unless otherwise
+indicated below, the terms and conditions of the EPL still apply to any source code in the Content
+and such source code may be obtained at <a href="http://www.eclipse.org">http://www.eclipse.org</a>.</p>
+
+</body>
+</html>
\ No newline at end of file
diff --git a/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/build.properties b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/build.properties
new file mode 100644
index 00000000000..1b591767ffe
--- /dev/null
+++ b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/build.properties
@@ -0,0 +1,6 @@
+bin.includes = META-INF/,\
+               about.html,\
+               resource/,\
+               plugin.xml,\
+               plugin.properties
+src.includes = about.html
diff --git a/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/plugin.properties b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/plugin.properties
new file mode 100644
index 00000000000..0b30868a038
--- /dev/null
+++ b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/plugin.properties
@@ -0,0 +1,16 @@
+##########################################################################################
+# Copyright (c) 2014 CEA LIST.
+# 
+#     
+# All rights reserved. This program and the accompanying materials
+# are made available under the terms of the Eclipse Public License v1.0
+# which accompanies this distribution, and is available at
+# http://www.eclipse.org/legal/epl-v10.html
+#
+# Contributors:
+#  Benoit Maggi (CEA LIST) benoit.maggi@cea.fr - Initial API and implementation
+#
+########################################################################################
+
+pluginName = Papyrus Copy/Paste Documentation 
+providerName = Eclipse Modeling Project
diff --git a/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/plugin.xml b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/plugin.xml
new file mode 100644
index 00000000000..c10abae3cb0
--- /dev/null
+++ b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/plugin.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<?eclipse version="3.4"?>
+<plugin>
+   <extension
+         point="org.eclipse.help.toc">
+      <toc
+            file="resource/copypaste-toc.xml"
+            primary="false">
+      </toc>
+      <toc
+            file="resource/copypaste-main-toc.xml"
+            primary="false">
+      </toc>      
+   </extension>
+</plugin>
diff --git a/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/pom.xml b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/pom.xml
new file mode 100644
index 00000000000..96628b292c1
--- /dev/null
+++ b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/pom.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project>
+	<modelVersion>4.0.0</modelVersion>
+	<parent>
+		<artifactId>org.eclipse.papyrus</artifactId>
+		<groupId>org.eclipse.papyrus</groupId>
+		<version>1.0.0-SNAPSHOT</version>
+		<relativePath>../../../releng/top-pom-main.xml</relativePath>
+	</parent>
+	<artifactId>org.eclipse.papyrus.copypaste.ui.doc</artifactId>
+	<groupId>org.eclipse.papyrus</groupId>
+	<version>1.0.0-SNAPSHOT</version>
+	<packaging>eclipse-plugin</packaging>
+</project>
\ No newline at end of file
diff --git a/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/copypaste-main-toc.xml b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/copypaste-main-toc.xml
new file mode 100644
index 00000000000..57e9753760f
--- /dev/null
+++ b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/copypaste-main-toc.xml
@@ -0,0 +1,7 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<toc label="Copy/Paste" link_to="../org.eclipse.papyrus.infra.doc/toc.xml#PapyrusDocUser">
+   <topic href="resource/copypaste.html" label="Using Copy/paste">
+      <link toc="resource/copypaste-toc.xml"/>
+      <anchor id="copypaste"/>
+   </topic>	
+</toc>
diff --git a/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/copypaste-toc.xml b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/copypaste-toc.xml
new file mode 100644
index 00000000000..b6d645869cb
--- /dev/null
+++ b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/copypaste-toc.xml
@@ -0,0 +1,30 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<toc topic="resource/copypaste.html" label="copypaste">
+	<topic href="resource/copypaste.html" label="Copying/Cutting/Pasting in Papyrus">
+		<topic href="resource/copypaste.html#Introduction" label="Introduction"></topic>
+		<topic href="resource/copypaste.html#User_Interface" label="User Interface">
+			<topic href="resource/copypaste.html#Model_Explorer_Menu" label="Model Explorer Menu"></topic>
+			<topic href="resource/copypaste.html#Model_Explorer_KeyBinding" label="Model Explorer KeyBinding"></topic>
+			<topic href="resource/copypaste.html#Diagram_Menu" label="Diagram Menu"></topic>
+			<topic href="resource/copypaste.html#Diagram_KeyBinding" label="Diagram KeyBinding"></topic>
+			<topic href="resource/copypaste.html#Preferences" label="Preferences"></topic>
+		</topic>
+		<topic href="resource/copypaste.html#List_of_Paste_strategies" label="List of Paste strategies">
+			<topic href="resource/copypaste.html#Common_Strategies" label="Common Strategies">
+				<topic href="resource/copypaste.html#Default_Paste_Strategy" label="Default Paste Strategy"></topic>
+				<topic href="resource/copypaste.html#SterotypeStrategy" label="SterotypeStrategy">
+					<topic href="resource/copypaste.html#Preferences_2" label="Preferences"></topic>
+				</topic>
+				<topic href="resource/copypaste.html#Rename_Strategy" label="Rename Strategy"></topic>
+				<topic href="resource/copypaste.html#Diagram_in_model_Explorer_Strategy" label="Diagram in model Explorer Strategy"></topic>
+				<topic href="resource/copypaste.html#Table_in_model_Explorer_Strategy" label="Table in model Explorer Strategy"></topic>
+			</topic>
+			<topic href="resource/copypaste.html#Uml_Strategies" label="Uml Strategies">
+				<topic href="resource/copypaste.html#Constraint_Paste_Strategy" label="Constraint Paste Strategy"></topic>
+			</topic>
+			<topic href="resource/copypaste.html#Sysml_Strategies" label="Sysml Strategies">
+				<topic href="resource/copypaste.html#Part_Paste_Strategy" label="Part Paste Strategy"></topic>
+			</topic>
+		</topic>
+	</topic>
+</toc>
\ No newline at end of file
diff --git a/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/copypaste.html b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/copypaste.html
new file mode 100644
index 00000000000..1f087e149d9
--- /dev/null
+++ b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/copypaste.html
@@ -0,0 +1,9 @@
+<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"/></head><body><h1 id="Copying.2FCutting.2FPasting_in_Papyrus">Copying/Cutting/Pasting in Papyrus</h1><h2 id="Introduction">Introduction</h2><pre>Papyrus's policy is to ensure consistency between models and diagrams, so by default the cut/copy/paste functionalities act both on diagram and model elements.
+The Copy/Cut/Paste functionalities are available between models and diagrams but not between eclipse instances.  
+The Cut/Paste functionalities are disable on root and read only elements.
+</pre><h2 id="User_Interface">User Interface</h2><h3 id="Model_Explorer_Menu">Model Explorer Menu</h3><p>Right click on a model explorer element</p><p><img border="0" src="images/ModelExplorerMenus.png"/></p><h3 id="Model_Explorer_KeyBinding">Model Explorer KeyBinding</h3><ul><li>Type M1+C for Papyrus copy</li><li>Type M1+X for Papyrus cut</li><li>Type M1+V for Papyrus paste</li></ul><pre>M1 is the COMMAND key on MacOS X, and the CTRL key on most other platforms.
+M2 is the SHIFT key.
+</pre><h3 id="Diagram_Menu">Diagram Menu</h3><p>On a Diagram element <b>Right Click&gt;EDIT</b> </p><p><img border="0" src="images/DiagramMenus.png"/></p><h3 id="Diagram_KeyBinding">Diagram KeyBinding</h3><ul><li>Type M1+C for Papyrus copy</li><li>Type M1+X for Papyrus cut</li><li>Type M1+V for Papyrus paste</li></ul><ul><li>Type M1+M2+C for Graphical copy</li><li>Type M1+M2+X for Graphical cut</li><li>Type M1+M2+V for Graphical paste</li></ul><h3 id="Preferences">Preferences</h3><pre>Papyrus copy/paste/cut preferences is accessible on <b>Window&gt;Preferences&gt;Papyrus&gt;Paste</b>
+The preference page lists all the available strategies and the checkbox to select whether the references should be kept.
+</pre><p><img border="0" src="images/PastePreferences.png"/></p><h2 id="List_of_Paste_strategies">List of Paste strategies</h2><h3 id="Common_Strategies">Common Strategies</h3><h4 id="Default_Paste_Strategy">Default Paste Strategy</h4><p>The strategy paste all copied elements in the selected place.
+It is required for all other strategies.</p><h4 id="SterotypeStrategy">SterotypeStrategy</h4><p>The strategy reapply profiles and stereotypes on the newly copied elements.</p><h5 id="Preferences_2">Preferences</h5><ul><li>Always apply missing profiles: missing profiles will be applied to the root of the target model</li><li>Never apply missing profiles: stereotypes referencing missing profiles will not be paste</li></ul><p><img border="0" src="images/StereotypeStrategy.png"/></p><h4 id="Rename_Strategy">Rename Strategy</h4><ul><li>Only the duplications of the <b>roots elements</b> will be renamed</li><li>An element is renamed only if there is already an element with the <b>same name</b> on the paste selection</li><li>The element will be renamed in CopyOf_%NameOfTheElement%_%id%. The id will be incremented for each <i>same</i> copy/paste. Example: a Class1 will become CopyOf_Class1_1 then CopyOf_Class1_2…</li></ul><p><img border="0" src="images/RenameExample.png"/></p><h4 id="Diagram_in_model_Explorer_Strategy">Diagram in model Explorer Strategy</h4><p>The strategy allows copy/paste for diagrams in model explorer. </p><h4 id="Table_in_model_Explorer_Strategy">Table in model Explorer Strategy</h4><p>The strategy allows copy/paste for tables in model explorer. </p><h3 id="Uml_Strategies">Uml Strategies</h3><p>The following strategies will only apply on uml models</p><h4 id="Constraint_Paste_Strategy">Constraint Paste Strategy</h4><p>This strategy works only on uml class diagrams. It draws the constraint "context" link after a paste. </p><p><img border="0" src="images/ConstraintExample.png"/></p><h3 id="Sysml_Strategies">Sysml Strategies</h3><p>The following strategies will only apply on sysml models</p><h4 id="Part_Paste_Strategy">Part Paste Strategy</h4><p>This strategy duplicates the linked association for each property pasted. </p></body></html>
\ No newline at end of file
diff --git a/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/copypaste.mediawiki b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/copypaste.mediawiki
new file mode 100644
index 00000000000..410a11bf974
--- /dev/null
+++ b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/copypaste.mediawiki
@@ -0,0 +1,106 @@
+<!--
+ Copyright (c) 2014 CEA LIST.
+ All rights reserved. This program and the accompanying materials
+ are made available under the terms of the Eclipse Public License v1.0
+ which accompanies this distribution, and is available at
+ http://www.eclipse.org/legal/epl-v10.html
+
+ Contributors:
+  Benoit Maggi (CEA LIST) benoit.maggi@cea.fr - Initial Documentation
+-->
+
+=Copying/Cutting/Pasting in Papyrus=
+==Introduction==
+
+Papyrus's policy is to ensure consistency between models and diagrams, so by default the cut/copy/paste functionalities act both on diagram and model elements.
+The Copy/Cut/Paste functionalities are available between models and diagrams but not between eclipse instances.  
+The Cut/Paste functionalities are disable on root and read only elements.
+
+==User Interface== 
+===Model Explorer Menu===
+Right click on a model explorer element
+
+[[Image:images/ModelExplorerMenus.png]]
+
+===Model Explorer KeyBinding===
+*Type M1+C for Papyrus copy
+*Type M1+X for Papyrus cut
+*Type M1+V for Papyrus paste
+
+ M1 is the COMMAND key on MacOS X, and the CTRL key on most other platforms.
+ M2 is the SHIFT key.
+
+===Diagram Menu===
+On a Diagram element '''Right Click>EDIT''' 
+
+[[Image:images/DiagramMenus.png]]
+
+===Diagram KeyBinding===
+*Type M1+C for Papyrus copy
+*Type M1+X for Papyrus cut
+*Type M1+V for Papyrus paste
+
+*Type M1+M2+C for Graphical copy
+*Type M1+M2+X for Graphical cut
+*Type M1+M2+V for Graphical paste
+
+===Preferences===
+
+Papyrus copy/paste/cut preferences is accessible on '''Window>Preferences>Papyrus>Paste'''
+The preference page lists all the available strategies and the checkbox to select whether the references should be kept.
+
+[[Image:images/PastePreferences.png]]
+
+<!--== Copy with external files ==
+This paragraph will list all '''available''' interaction with external files.
+
+=== Copy in Diagram Paste in External Files ===
+The copied Diagram elements will be paste as an Image.
+-->
+
+== List of Paste strategies ==
+
+=== Common Strategies ===
+
+==== Default Paste Strategy  ====
+The strategy paste all copied elements in the selected place.
+It is required for all other strategies.
+
+==== SterotypeStrategy ====
+The strategy reapply profiles and stereotypes on the newly copied elements.
+
+===== Preferences =====
+* Always apply missing profiles: missing profiles will be applied to the root of the target model
+* Never apply missing profiles: stereotypes referencing missing profiles will not be paste
+<!-- * Featured :  Ask user : a popup will list all the missing profiles and ask the user which one to import -->
+
+[[Image:images/StereotypeStrategy.png]]
+
+==== Rename Strategy ====
+
+* Only the duplications of the '''roots elements''' will be renamed
+* An element is renamed only if there is already an element with the '''same name''' on the paste selection
+* The element will be renamed in CopyOf_%NameOfTheElement%_%id%. The id will be incremented for each ''same'' copy/paste. Example: a Class1 will become CopyOf_Class1_1 then CopyOf_Class1_2…
+<!-- Featured : It will have two preferences, one for the prefix “copy_of” and one checkbox to disable the increment. -->
+
+[[Image:images/RenameExample.png]]
+
+==== Diagram in model Explorer Strategy ====
+The strategy allows copy/paste for diagrams in model explorer. 
+
+==== Table in model Explorer Strategy ====
+The strategy allows copy/paste for tables in model explorer. 
+
+=== Uml Strategies ===
+The following strategies will only apply on uml models
+
+==== Constraint Paste Strategy ====
+This strategy works only on uml class diagrams. It draws the constraint "context" link after a paste. 
+
+[[Image:images/ConstraintExample.png]]
+
+=== Sysml Strategies ===
+The following strategies will only apply on sysml models
+==== Part Paste Strategy ====
+This strategy duplicates the linked association for each property pasted. 
+
diff --git a/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/images/ConstraintExample.png b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/images/ConstraintExample.png
new file mode 100644
index 00000000000..f2997d4e5da
Binary files /dev/null and b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/images/ConstraintExample.png differ
diff --git a/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/images/DiagramMenus.png b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/images/DiagramMenus.png
new file mode 100644
index 00000000000..69cf7d4ce8e
Binary files /dev/null and b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/images/DiagramMenus.png differ
diff --git a/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/images/ModelExplorerMenus.png b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/images/ModelExplorerMenus.png
new file mode 100644
index 00000000000..dffc6d0ac77
Binary files /dev/null and b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/images/ModelExplorerMenus.png differ
diff --git a/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/images/PastePreferences.png b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/images/PastePreferences.png
new file mode 100644
index 00000000000..285346fd307
Binary files /dev/null and b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/images/PastePreferences.png differ
diff --git a/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/images/RenameExample.png b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/images/RenameExample.png
new file mode 100644
index 00000000000..d7efc3db090
Binary files /dev/null and b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/images/RenameExample.png differ
diff --git a/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/images/StereotypeStrategy.png b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/images/StereotypeStrategy.png
new file mode 100644
index 00000000000..d3a8ba7f95d
Binary files /dev/null and b/plugins/doc/org.eclipse.papyrus.copypaste.ui.doc/resource/images/StereotypeStrategy.png differ
diff --git a/releng/top-pom-main.xml b/releng/top-pom-main.xml
index bdccb62405b..399b226989f 100755
--- a/releng/top-pom-main.xml
+++ b/releng/top-pom-main.xml
@@ -294,6 +294,7 @@
 		<module>../plugins/views/org.eclipse.papyrus.views.search</module>
 		<module>../plugins/views/validation/org.eclipse.papyrus.views.validation</module>
 		<module>../plugins/xwt/org.eclipse.papyrus.xwt</module>
+		<module>../plugins/doc/org.eclipse.papyrus.copypaste.ui.doc</module>
 		<module>main</module>
 	</modules>
 	<properties>
-- 
cgit v1.2.3