Context: remove obsolete warnings from javadoc

Now, when there are @eventhandler annotated methods, the EventService is
treated as a dependency. So it is no longer necessary to explicitly list
EventService.class before other services when constructing a Context
with an explicit list of service interfaces.

Author: ctrueden

src/main/java/org/scijava/Context.java

@@ -119,9 +119,7 @@ public Context(final boolean empty) {
 	 * @param serviceClasses A list of types that implement the {@link Service}
 	 *          interface (e.g., {@code DisplayService.class}). Compatible
 	 *          services will be loaded in the order given,
-	 *          <em>regardless of their relative priorities</em>. In particular,
-	 *          take care to specify the {@link EventService} first if you need
-	 *          proper event handling for the other services.
+	 *          <em>regardless of their relative priorities</em>.
 	 * @see #Context(Collection, PluginIndex, boolean)
 	 * @throws ClassCastException If any of the given arguments do not implement
 	 *           the {@link Service} interface.
@@ -137,9 +135,7 @@ public Context(@SuppressWarnings("rawtypes") final Class... serviceClasses) {
 	 * @param serviceClasses A collection of types that implement the
 	 *          {@link Service} interface (e.g., {@code DisplayService.class}).
 	 *          Compatible services will be loaded according to the order of the
-	 *          collection, <em>regardless of their relative priorities</em>. In
-	 *          particular, take care to specify the {@link EventService} first if
-	 *          you need proper event handling for the other services.
+	 *          collection, <em>regardless of their relative priorities</em>.
 	 * @see #Context(Collection, PluginIndex, boolean)
 	 */
 	public Context(final Collection<Class<? extends Service>> serviceClasses) {
@@ -153,9 +149,7 @@ public Context(final Collection<Class<? extends Service>> serviceClasses) {
 	 * @param serviceClasses A collection of types that implement the
 	 *          {@link Service} interface (e.g., {@code DisplayService.class}).
 	 *          Compatible services will be loaded according to the order of the
-	 *          collection, <em>regardless of their relative priorities</em>. In
-	 *          particular, take care to specify the {@link EventService} first if
-	 *          you need proper event handling for the other services.
+	 *          collection, <em>regardless of their relative priorities</em>.
 	 * @param strict Whether context creation will fail fast when there is
 	 *          an error instantiating a required service.
 	 * @see #Context(Collection, PluginIndex, boolean)
@@ -194,9 +188,7 @@ public Context(final PluginIndex pluginIndex) {
 	 * @param serviceClasses A collection of types that implement the
 	 *          {@link Service} interface (e.g., {@code DisplayService.class}).
 	 *          Compatible services will be loaded according to the order of the
-	 *          collection, <em>regardless of their relative priorities</em>. In
-	 *          particular, take care to specify the {@link EventService} first if
-	 *          you need proper event handling for the other services.
+	 *          collection, <em>regardless of their relative priorities</em>.
 	 * @param pluginIndex The plugin index to use when discovering and indexing
 	 *          plugins. If you wish to completely control how services are
 	 *          discovered (i.e., use your own
@@ -229,9 +221,7 @@ public Context(final Collection<Class<? extends Service>> serviceClasses,
 	 * @param serviceClasses A collection of types that implement the
 	 *          {@link Service} interface (e.g., {@code DisplayService.class}).
 	 *          Compatible services will be loaded according to the order of the
-	 *          collection, <em>regardless of their relative priorities</em>. In
-	 *          particular, take care to specify the {@link EventService} first if
-	 *          you need proper event handling for the other services.
+	 *          collection, <em>regardless of their relative priorities</em>.
 	 * @param pluginIndex The plugin index to use when discovering and indexing
 	 *          plugins. If you wish to completely control how services are
 	 *          discovered (i.e., use your own

src/main/java/org/scijava/event/DefaultEventService.java

@@ -64,11 +64,6 @@ public class DefaultEventService extends AbstractService implements
 	/**
 	 * The default event service's priority.
 	 * <p>
-	 * It is paramount that the event service be created and initialized before
-	 * other services. Any service created before the event service may not have
-	 * its event handling methods registered correctly.
-	 * </p>
-	 * <p>
 	 * Alternative event service implementations that wish to prioritize
 	 * themselves above this one can still ensure preferential usage via
 	 * {@code priority = DefaultEventService.PRIORITY + 1} or similar.