Author: limpbizkit
Date: Fri Dec 26 18:54:59 2008
New Revision: 742
Modified:
trunk/extensions/assistedinject/src/com/google/inject/assistedinject/AssistedInject.java
trunk/extensions/commands/src/com/google/inject/commands/intercepting/InterceptingInjectorBuilder.java
trunk/extensions/multibindings/src/com/google/inject/multibindings/MapBinder.java
trunk/extensions/throwingproviders/src/com/google/inject/throwingproviders/ThrowingProviderBinder.java
trunk/src/com/google/inject/Binder.java
trunk/src/com/google/inject/Guice.java
trunk/src/com/google/inject/Module.java
trunk/src/com/google/inject/Provider.java
trunk/src/com/google/inject/binder/PrivateBinder.java
trunk/src/com/google/inject/spi/Elements.java
Log:
Mikeward's Javadoc fixes. Mike read through all of our Javadoc (thank you!)
and found a few typos and simplifications
Modified:
trunk/extensions/assistedinject/src/com/google/inject/assistedinject/AssistedInject.java
==============================================================================
---
trunk/extensions/assistedinject/src/com/google/inject/assistedinject/AssistedInject.java
(original)
+++
trunk/extensions/assistedinject/src/com/google/inject/assistedinject/AssistedInject.java
Fri Dec 26 18:54:59 2008
@@ -22,8 +22,8 @@
import java.lang.annotation.Target;
/**
- * <p>Constructors annotated with {...@code @AssistedInject} indicate that
will can be instantiated by
- * the {...@link FactoryProvider}. Each constructor must exactly one
corresponding factory method
+ * <p>Constructors annotated with {...@code @AssistedInject} indicate that
they can be instantiated by
+ * the {...@link FactoryProvider}. Each constructor must exactly match one
corresponding factory method
* within the factory interface.
*
* <p>Constructor parameters must be either supplied by the factory
interface and marked with
@@ -40,4 +40,4 @@
@Target({CONSTRUCTOR})
@Retention(RUNTIME)
@Deprecated
-public @interface AssistedInject {}
\ No newline at end of file
+public @interface AssistedInject {}
Modified:
trunk/extensions/commands/src/com/google/inject/commands/intercepting/InterceptingInjectorBuilder.java
==============================================================================
---
trunk/extensions/commands/src/com/google/inject/commands/intercepting/InterceptingInjectorBuilder.java
(original)
+++
trunk/extensions/commands/src/com/google/inject/commands/intercepting/InterceptingInjectorBuilder.java
Fri Dec 26 18:54:59 2008
@@ -30,6 +30,7 @@
import com.google.inject.Module;
import com.google.inject.ProvidedBy;
import com.google.inject.Provider;
+import com.google.inject.Provides;
import com.google.inject.TypeLiteral;
import com.google.inject.binder.ScopedBindingBuilder;
import com.google.inject.internal.UniqueAnnotations;
@@ -59,8 +60,8 @@
* <pre class="code">bind(MyServiceClass.class);</pre>
*
* <p>All intercepted bindings must be bound explicitly. Interception
cannot
- * be applied to implicit bindings, or bindings that depend on
- * {...@literal @}...@link ProvidedBy}, {...@literal @}...@link ImplementedBy}
+ * be applied to implicit bindings, or bproindings that depend on
+ * {...@literal @}...@link ProvidedBy}, {...@literal @}...@link
ImplementedBy},
{...@literal @}...@link Provides}
* annotations.
*
* <p><strong>Implementation note:</strong> To intercept provision, an
Modified:
trunk/extensions/multibindings/src/com/google/inject/multibindings/MapBinder.java
==============================================================================
---
trunk/extensions/multibindings/src/com/google/inject/multibindings/MapBinder.java
(original)
+++
trunk/extensions/multibindings/src/com/google/inject/multibindings/MapBinder.java
Fri Dec 26 18:54:59 2008
@@ -74,9 +74,9 @@
*
* <p>Values are resolved at map injection time. If a value is bound to a
* provider, that provider's get method will be called each time the map is
- * injected (unless the binding is also scoped).
+ * injected (unless the binding is also scoped, or a map of providers is
injected).
*
- * <p>Annotations are be used to create different maps of the same
key/value
+ * <p>Annotations are used to create different maps of the same key/value
* type. Each distinct annotation gets its own independent map.
*
* <p><strong>Keys must be distinct.</strong> If the same key is bound
more than
Modified:
trunk/extensions/throwingproviders/src/com/google/inject/throwingproviders/ThrowingProviderBinder.java
==============================================================================
---
trunk/extensions/throwingproviders/src/com/google/inject/throwingproviders/ThrowingProviderBinder.java
(original)
+++
trunk/extensions/throwingproviders/src/com/google/inject/throwingproviders/ThrowingProviderBinder.java
Fri Dec 26 18:54:59 2008
@@ -35,7 +35,7 @@
import java.lang.reflect.TypeVariable;
/**
- * <p>Builds a binding for an {...@link ThrowingProvider} using a fluent API:
+ * <p>Builds a binding for a {...@link ThrowingProvider} using a fluent API:
* <pre><code>ThrowingProviderBinder.create(binder())
* .bind(RemoteProvider.class, Customer.class)
* .to(RemoteCustomerProvider.class)
Modified: trunk/src/com/google/inject/Binder.java
==============================================================================
--- trunk/src/com/google/inject/Binder.java (original)
+++ trunk/src/com/google/inject/Binder.java Fri Dec 26 18:54:59 2008
@@ -38,10 +38,10 @@
* Guice uses an <i>embedded domain-specific language</i>, or EDSL, to
help you
* create bindings simply and readably. This approach is great for overall
* usability, but it does come with a small cost: <b>it is difficult to
- * learn how to use the Binding EDSL in the usual way -- by reading
- * method-level javadocs</b>. Instead, you should consult this series of
+ * learn how to use the Binding EDSL by reading
+ * method-level javadocs</b>. Instead, you should consult the series of
* examples below. To save space, these examples omit the opening
- * {...@code binder.}, just as you will if your module extends
+ * {...@code binder}, just as you will if your module extends
* {...@link AbstractModule}.
*
* <pre>
@@ -132,7 +132,7 @@
* In this example, your module itself, <i>not Guice</i>, takes
responsibility
* for obtaining a {...@code ServiceImpl} instance, then asks Guice to always
use
* this single instance to fulfill all {...@code Service} injection
requests. When
- * the {...@link Injector} is first created, it will automatically perform
field
+ * the {...@link Injector} is created, it will automatically perform field
* and method injection for this instance, but any injectable constructor
on
* {...@code ServiceImpl} is simply ignored. Note that using this approach
results
* in "eager loading" behavior that you can't control.
Modified: trunk/src/com/google/inject/Guice.java
==============================================================================
--- trunk/src/com/google/inject/Guice.java (original)
+++ trunk/src/com/google/inject/Guice.java Fri Dec 26 18:54:59 2008
@@ -63,7 +63,7 @@
* Creates an injector for the given set of modules.
*
* @throws CreationException if one or more errors occur during Injector
- * construction
+ * creation
*/
public static Injector createInjector(Iterable<? extends Module>
modules) {
return createInjector(Stage.DEVELOPMENT, modules);
@@ -74,7 +74,7 @@
* stage.
*
* @throws CreationException if one or more errors occur during Injector
- * construction
+ * creation
*/
public static Injector createInjector(Stage stage, Module... modules) {
return createInjector(stage, Arrays.asList(modules));
Modified: trunk/src/com/google/inject/Module.java
==============================================================================
--- trunk/src/com/google/inject/Module.java (original)
+++ trunk/src/com/google/inject/Module.java Fri Dec 26 18:54:59 2008
@@ -33,7 +33,7 @@
public interface Module {
/**
- * Contributes bindings and other configurations for this module to a
{...@code Binder}.
+ * Contributes bindings and other configurations for this module to
{...@code binder}.
*
* <p><strong>Do not invoke this method directly</strong> to install
submodules. Instead use
* {...@link Binder#install(Module)}, which ensures that {...@link Provides
provider methods} are
Modified: trunk/src/com/google/inject/Provider.java
==============================================================================
--- trunk/src/com/google/inject/Provider.java (original)
+++ trunk/src/com/google/inject/Provider.java Fri Dec 26 18:54:59 2008
@@ -38,7 +38,7 @@
* for a given key, via the {...@link Injector#getProvider} methods.
* </ul>
*
- * @param <T> the type of object this provider provides
+ * @param <T> the type of object this provides
*
* @author [email protected] (Bob Lee)
*/
Modified: trunk/src/com/google/inject/binder/PrivateBinder.java
==============================================================================
--- trunk/src/com/google/inject/binder/PrivateBinder.java (original)
+++ trunk/src/com/google/inject/binder/PrivateBinder.java Fri Dec 26
18:54:59 2008
@@ -30,7 +30,7 @@
public interface PrivateBinder extends Binder {
/** Makes the binding for {...@code key} available to the enclosing
environment */
- void expose(Key<?> type);
+ void expose(Key<?> key);
/**
* Makes a binding for {...@code type} available to the enclosing
environment. Use {...@link
Modified: trunk/src/com/google/inject/spi/Elements.java
==============================================================================
--- trunk/src/com/google/inject/spi/Elements.java (original)
+++ trunk/src/com/google/inject/spi/Elements.java Fri Dec 26 18:54:59 2008
@@ -278,8 +278,8 @@
return new RecordingBinder(this, privateEnvironment);
}
- public void expose(Key<?> type) {
- exposeInternal(type);
+ public void expose(Key<?> key) {
+ exposeInternal(key);
}
public AnnotatedElementBuilder expose(Class<?> type) {
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"google-guice-dev" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to
[email protected]
For more options, visit this group at
http://groups.google.com/group/google-guice-dev?hl=en
-~----------~----~----~----~------~----~------~--~---
