comments tweaked

NeoSuit/src/main/resources/patterns_johl/ParallelMethod_NoReturnNoArgs.xml

 <?xml version="1.0" encoding="UTF-8"?>
 <pattern>
-	<name>Parallel Methods</name>
+	<name>Parallel Method (returns nothing)</name>
 	<description>No return value, no arguments</description>
 	<cp>		
 		<query>

NeoSuit/src/main/resources/patterns_johl/ParallelMethod_ReturnNoArgs.xml

 <?xml version="1.0" encoding="UTF-8"?>
 <pattern>
-	<name>Parallel Methods (Value)</name>
-	<description>No return value, no arguments</description>
+	<name>Parallel Method (returns something)</name>
+	<description>Return value, no arguments</description>
 	<cp>		
 		<query>
 <![CDATA[
@@ -22,7 +22,7 @@
     <!-- declare task class type -->
     <query src="subpatterns/declare_task.xml"/>
 
-    <!-- mark pervious node (before method call), to create fork join pool -->
+    <!-- mark previous node (before method call), to create fork join pool -->
     <query>
     <![CDATA[
       MATCH ()-[c:CONTROL_FLOW]->(mc1) where ID(mc1)={mc1ID}
@@ -31,7 +31,7 @@
     </query>
     <query src="subpatterns/create_forkjoinpool_java7.xml"/>
 
-    <!-- mark pervious node (before method call), to create task instance -->
+    <!-- mark previous node (before method call), to create task -->
     <query>
     <![CDATA[   
       MATCH ()-[c:CONTROL_FLOW]->(mc1) where ID(mc1)={mc1ID}
@@ -40,6 +40,7 @@
     </query>
     <query src="subpatterns/create_task.xml"/>
 
+    <!-- mark previous node (before method call), to submit task -->
     <query>
     <![CDATA[   
       MATCH ()-[c:CONTROL_FLOW]->(mc1) where ID(mc1)={mc1ID}
@@ -48,6 +49,10 @@
     </query>
     <query src="subpatterns/submit_task.xml"/>    
 
+    <!-- Re-wire control flow, so mc2 is executed immediatley after the previous task submission.
+         Use DATA_FLOW to find CONTROL_FLOW edge right before the result of mc1 is used.
+         Mark the edge, so we can replace it by joining the task.
+         -->
     <query>
     <![CDATA[   
       MATCH (mc1) where ID(mc1)={mc1ID}
@@ -69,8 +74,10 @@
     ]]>
     </query>
 
+    <!-- insert actual join code -->
     <query src="subpatterns/join_task.xml"/>    
 
+    <!-- cleanup all the tags we created to communicate between different subqueries -->
     <query>  
     <![CDATA[ 
       OPTIONAL MATCH ()-[createPool]->() where createPool.createForkJoinPool=true REMOVE createPool.createForkJoinPool
@@ -95,6 +102,7 @@
     ]]>
     </query>  
 
+    <!-- return display -->
     <query>
     <![CDATA[
       MATCH (class)