Bug 371407 -
ContextInjectionFactory.invoke(Object,Class,IEclipseContext) should
state in JavaDoc that it fails if no method found
diff --git a/bundles/org.eclipse.e4.core.contexts/src/org/eclipse/e4/core/contexts/ContextInjectionFactory.java b/bundles/org.eclipse.e4.core.contexts/src/org/eclipse/e4/core/contexts/ContextInjectionFactory.java
index e29ab7f..3b06e0c 100644
--- a/bundles/org.eclipse.e4.core.contexts/src/org/eclipse/e4/core/contexts/ContextInjectionFactory.java
+++ b/bundles/org.eclipse.e4.core.contexts/src/org/eclipse/e4/core/contexts/ContextInjectionFactory.java
@@ -74,7 +74,10 @@
 
 	/**
 	 * Call a method, injecting the parameters from the context.
-	 * 
+	 * <p>
+	 * If no matching method is found on the class, an InjectionException will be 
+	 * thrown.
+	 * </p>
 	 * @param object The object to perform injection on
 	 * @param qualifier the annotation tagging method to be called
 	 * @param context The context to obtain injected values from
@@ -88,7 +91,9 @@
 
 	/**
 	 * Call a method, injecting the parameters from the context.
-	 * 
+	 * <p>
+	 * If no matching method is found on the class, the defaultValue will be returned.
+	 * </p>
 	 * @param object The object to perform injection on
 	 * @param qualifier the annotation tagging method to be called
 	 * @param context The context to obtain injected values from
@@ -109,6 +114,9 @@
 	 * If values for the same key present in both the context and the local context, the values from
 	 * the local context are injected.
 	 * </p> 
+	 * <p>
+	 * If no matching method is found on the class, the defaultValue will be returned.
+	 * </p>
 	 * @param object The object to perform injection on
 	 * @param qualifier the annotation tagging method to be called
 	 * @param context The context to obtain injected values from
diff --git a/bundles/org.eclipse.e4.core.di/src/org/eclipse/e4/core/di/IInjector.java b/bundles/org.eclipse.e4.core.di/src/org/eclipse/e4/core/di/IInjector.java
index 97fe036..b4d08d1 100644
--- a/bundles/org.eclipse.e4.core.di/src/org/eclipse/e4/core/di/IInjector.java
+++ b/bundles/org.eclipse.e4.core.di/src/org/eclipse/e4/core/di/IInjector.java
@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2010 IBM Corporation and others.
+ * Copyright (c) 2010, 2012 IBM Corporation and others.
  * 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
@@ -75,6 +75,10 @@
 
 	/**
 	 * Call the annotated method on an object, injecting the parameters from the supplier.
+	 * <p>
+	 * If no matching method is found on the class, an InjectionException will be 
+	 * thrown.
+	 * </p>
 	 * @param object the object on which the method should be called
 	 * @param qualifier the annotation tagging method to be called
 	 * @param objectSupplier primary object supplier
@@ -85,6 +89,9 @@
 
 	/**
 	 * Call the annotated method on an object, injecting the parameters from the supplier.
+	 * <p>
+	 * If no matching method is found on the class, the defaultValue will be returned.
+	 * </p>
 	 * @param object the object on which the method should be called
 	 * @param qualifier the annotation tagging method to be called
 	 * @param defaultValue a value to be returned if the method cannot be called, might be <code>null</code>
@@ -96,6 +103,9 @@
 
 	/**
 	 * Call the annotated method on an object, injecting the parameters from the suppliers.
+	 * <p>
+	 * If no matching method is found on the class, the defaultValue will be returned.
+	 * </p>
 	 * @param object the object on which the method should be called
 	 * @param qualifier the annotation tagging method to be called
 	 * @param defaultValue a value to be returned if the method cannot be called, might be <code>null</code>