Merge branch 'br/pubsub-schemes-refactor' into 'master'

Pub/Sub unsubscribe() on listener

Full support for multiple listeners on the same subscription

See merge request !27

src/de/tudarmstadt/maki/simonstrator/api/component/pubsub/PubSubComponent.java

@@ -63,8 +63,10 @@ public interface PubSubComponent extends OverlayComponent {
 	 * Unsubscribe
 	 * 
 	 * @param sub
+	 * @param listener
+	 *            if null, all listeners are removed
 	 */
-	public void unsubscribe(Subscription sub);
+	public void unsubscribe(Subscription sub, PubSubListener listener);
 
 	/*
 	 * application - has to define semantics (i.e., topics, attributes, and

src/de/tudarmstadt/maki/simonstrator/api/component/transition/AtomicTransition.java

@@ -25,7 +25,10 @@ package de.tudarmstadt.maki.simonstrator.api.component.transition;
  * state between two mechanisms. This is only required if the
  * {@link TransferState} annotation is not sufficient in your use case.
  * 
- * This object is not supposed to maintain state between method invocations.
+ * This object is not supposed to maintain state between method invocations (new
+ * instances are created for each transition). It is OK to store state from
+ * transferState to transitionFinished to trigger certain actions on the
+ * initialized target component.
  * 
  * @author Bjoern Richerzhagen, Alexander Froemmgen
  *