Added inline documentation

SimonScholz · SimonScholz · commit 82a0b4aa8edf · 2014-11-14T17:02:39.000+01:00
Change-Id: I7ba2a4f622a73f4bd3561fba50b68b58b42b1238
Signed-off-by: Simon Scholz &lt;simon.scholz@vogella.com&gt;
diff --git a/com.vogella.rcp.jface.translation/src/wizardtranslation/handlers/RestorePerspectiveHandler.java b/com.vogella.rcp.jface.translation/src/wizardtranslation/handlers/RestorePerspectiveHandler.java
@@ -13,19 +13,27 @@ public class RestorePerspectiveHandler {
 	@Execute
 	public void execute(EModelService modelService, MWindow window,
 			EPartService partService) {
+
+		// get active perpective and find stored snippet of this perspective
 		MPerspective activePerspective = modelService
 				.getActivePerspective(window);
 		MUIElement findSnippet = modelService.findSnippet(window,
 				activePerspective.getElementId());
+
+		// remove existing active perspective
 		MElementContainer<MUIElement> parent = activePerspective.getParent();
 		modelService.removePerspectiveModel(activePerspective, window);
+
+		// add stored perspective snippet and switch to it
 		parent.getChildren().add(findSnippet);
 		partService.switchPerspective((MPerspective) findSnippet);
 	}
 	
 	
 	@CanExecute
 	public boolean canExecute(EModelService modelService, MWindow window) {
+
+		// check whether a snippet for the active perspective exists
 		MPerspective activePerspective = modelService
 				.getActivePerspective(window);
 		return modelService.findSnippet(window,
diff --git a/com.vogella.rcp.jface.translation/src/wizardtranslation/handlers/SavePerspectiveHandler.java b/com.vogella.rcp.jface.translation/src/wizardtranslation/handlers/SavePerspectiveHandler.java
@@ -8,6 +8,8 @@
 public class SavePerspectiveHandler {
 	@Execute
 	public void execute(EModelService modelService, MWindow window) {
+
+		// clone the currently active perspective
 		MPerspective activePerspective = modelService
 				.getActivePerspective(window);
 		modelService.cloneElement(activePerspective, window);
diff --git a/com.vogella.rcp.jface.translation/src/wizardtranslation/handlers/SwitchPerspectiveHandler.java b/com.vogella.rcp.jface.translation/src/wizardtranslation/handlers/SwitchPerspectiveHandler.java
@@ -20,6 +20,8 @@ public void execute(EModelService modelService, EPartService partService,
 		List<MPerspective> perspectives = modelService.findElements(window,
 				null, MPerspective.class, null);
 
+		// as we only have two perspectives simply switch to the non active
+		// perspective.
 		for (MPerspective perspective : perspectives) {
 			if (!perspective.equals(activePerspective)) {
 				partService.switchPerspective(perspective);
