You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@polygene.apache.org by ni...@apache.org on 2015/04/24 08:36:47 UTC

[34/50] [abbrv] zest-qi4j git commit: Fix Java 8 DocLint errors across the whole SDK

Fix Java 8 DocLint errors across the whole SDK


Project: http://git-wip-us.apache.org/repos/asf/zest-qi4j/repo
Commit: http://git-wip-us.apache.org/repos/asf/zest-qi4j/commit/3c882b82
Tree: http://git-wip-us.apache.org/repos/asf/zest-qi4j/tree/3c882b82
Diff: http://git-wip-us.apache.org/repos/asf/zest-qi4j/diff/3c882b82

Branch: refs/heads/master
Commit: 3c882b82a940139cd59149649a414a0d70308462
Parents: 177322a
Author: Paul Merlin <pa...@nosphere.org>
Authored: Sat Jan 24 12:18:40 2015 +0100
Committer: Paul Merlin <pa...@nosphere.org>
Committed: Sat Jan 24 12:19:11 2015 +0100

----------------------------------------------------------------------
 .../runtime/entity/EntityPropertyInstance.java     |  2 +-
 .../qi4j/runtime/injection/DependencyModel.java    | 12 ++++--------
 .../injection/InjectionProviderFactory.java        |  6 ++++--
 .../rest/server/DomainEventSourceResource.java     |  2 +-
 .../application/replay/ApplicationEventPlayer.java |  7 +++----
 .../application/source/ApplicationEventSource.java | 11 ++++++-----
 .../source/helper/ApplicationEventParameters.java  |  1 -
 .../domain/replay/DomainEventPlayer.java           |  6 +++---
 .../eventsourcing/domain/source/EventSource.java   |  1 +
 .../domain/source/helper/EventParameters.java      |  1 -
 .../domain/source/helper/EventRouter.java          |  2 +-
 .../domain/source/helper/UnitOfWorkRouter.java     |  2 +-
 .../java/org/qi4j/lang/groovy/GroovyMixin.java     |  2 +-
 .../org/qi4j/lang/javascript/JavaScriptMixin.java  |  2 +-
 .../main/java/org/qi4j/lang/jruby/JRubyMixin.java  |  2 +-
 .../spring/bootstrap/Qi4jApplicationBootstrap.java | 17 ++++++++---------
 .../library/spring/importer/SpringImporter.java    |  2 +-
 .../qi4j/library/struts2/Qi4jPropertyAccessor.java |  2 +-
 .../wicket/form/DateTextFieldWithPicker.java       |  2 +-
 .../interaction/handling/ProcessHandlingEvent.java |  2 +-
 .../wicket/form/DateTextFieldWithPicker.java       |  2 +-
 21 files changed, 41 insertions(+), 45 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/zest-qi4j/blob/3c882b82/core/runtime/src/main/java/org/qi4j/runtime/entity/EntityPropertyInstance.java
----------------------------------------------------------------------
diff --git a/core/runtime/src/main/java/org/qi4j/runtime/entity/EntityPropertyInstance.java b/core/runtime/src/main/java/org/qi4j/runtime/entity/EntityPropertyInstance.java
index 46dc01b..0bc6583 100644
--- a/core/runtime/src/main/java/org/qi4j/runtime/entity/EntityPropertyInstance.java
+++ b/core/runtime/src/main/java/org/qi4j/runtime/entity/EntityPropertyInstance.java
@@ -30,7 +30,7 @@ public class EntityPropertyInstance<T>
      * Construct an instance of {@code PropertyInstance} with the specified arguments.
      *
      * @param aPropertyInfo The property info. This argument must not be {@code null}.
-     * @param entityState
+     * @param entityState EntityState
      */
     @SuppressWarnings( "unchecked" )
     public EntityPropertyInstance( PropertyInfo aPropertyInfo, EntityState entityState )

http://git-wip-us.apache.org/repos/asf/zest-qi4j/blob/3c882b82/core/runtime/src/main/java/org/qi4j/runtime/injection/DependencyModel.java
----------------------------------------------------------------------
diff --git a/core/runtime/src/main/java/org/qi4j/runtime/injection/DependencyModel.java b/core/runtime/src/main/java/org/qi4j/runtime/injection/DependencyModel.java
index 10eca0d..bfc5317 100644
--- a/core/runtime/src/main/java/org/qi4j/runtime/injection/DependencyModel.java
+++ b/core/runtime/src/main/java/org/qi4j/runtime/injection/DependencyModel.java
@@ -213,18 +213,14 @@ public final class DependencyModel
      * <p>
      * If the dependency uses generics this is the raw type,
      * and otherwise it is the type of the field.
-     * </p>
      * <p>
      * Examples:
-     * </p>
-     * {@code @Service MyService service} -> MyService
-     * </p>
      * <p>
-     * {@code @Entity Iterable<Foo> fooList} -> Iterable
-     * </p>
+     * {@code @Service MyService service} -&gt; MyService
      * <p>
-     * {@code @Entity Query<Foo> fooQuery} -> Query
-     * </p>
+     * {@code @Entity Iterable<Foo> fooList} -&gt; Iterable
+     * <p>
+     * {@code @Entity Query<Foo> fooQuery} -&gt; Query
      *
      * @return raw injection type.
      */

http://git-wip-us.apache.org/repos/asf/zest-qi4j/blob/3c882b82/core/runtime/src/main/java/org/qi4j/runtime/injection/InjectionProviderFactory.java
----------------------------------------------------------------------
diff --git a/core/runtime/src/main/java/org/qi4j/runtime/injection/InjectionProviderFactory.java b/core/runtime/src/main/java/org/qi4j/runtime/injection/InjectionProviderFactory.java
index 0fb9ffd..a594397 100644
--- a/core/runtime/src/main/java/org/qi4j/runtime/injection/InjectionProviderFactory.java
+++ b/core/runtime/src/main/java/org/qi4j/runtime/injection/InjectionProviderFactory.java
@@ -27,8 +27,10 @@ public interface InjectionProviderFactory
      * can be found, return null. If the dependency is optional the dependency will
      * then be explicitly set to null.
      *
-     * @param resolution
-     * @param dependencyModel
+     * @param resolution Injection resolution
+     * @param dependencyModel Dependency model
+     * @return InjectionProvider
+     * @throws InvalidInjectionException if the injection is invalid
      */
     InjectionProvider newInjectionProvider( Resolution resolution, DependencyModel dependencyModel )
         throws InvalidInjectionException;

http://git-wip-us.apache.org/repos/asf/zest-qi4j/blob/3c882b82/libraries/eventsourcing-rest/src/main/java/org/qi4j/library/eventsourcing/domain/rest/server/DomainEventSourceResource.java
----------------------------------------------------------------------
diff --git a/libraries/eventsourcing-rest/src/main/java/org/qi4j/library/eventsourcing/domain/rest/server/DomainEventSourceResource.java b/libraries/eventsourcing-rest/src/main/java/org/qi4j/library/eventsourcing/domain/rest/server/DomainEventSourceResource.java
index 4c59747..dc63336 100644
--- a/libraries/eventsourcing-rest/src/main/java/org/qi4j/library/eventsourcing/domain/rest/server/DomainEventSourceResource.java
+++ b/libraries/eventsourcing-rest/src/main/java/org/qi4j/library/eventsourcing/domain/rest/server/DomainEventSourceResource.java
@@ -53,7 +53,7 @@ import static org.qi4j.functional.Iterables.iterable;
  * / = current set of most recent events (event range: count-pagesize to count)
  * /n,m = events from index n to index m. These are archive pages.
  * /n = working set page, where n is the first event index to be presented
- * </code></pre>>
+ * </code></pre>
  */
 public class DomainEventSourceResource
         extends Restlet

http://git-wip-us.apache.org/repos/asf/zest-qi4j/blob/3c882b82/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/application/replay/ApplicationEventPlayer.java
----------------------------------------------------------------------
diff --git a/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/application/replay/ApplicationEventPlayer.java b/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/application/replay/ApplicationEventPlayer.java
index e0e66d7..075988c 100644
--- a/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/application/replay/ApplicationEventPlayer.java
+++ b/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/application/replay/ApplicationEventPlayer.java
@@ -28,10 +28,9 @@ public interface ApplicationEventPlayer
      * be the original object, but could also be a service that wants
      * to be invoked to handle the event.
      *
-     * @param applicationEvent
-     * @param object
-     * @throws ApplicationEventReplayException
-     *
+     * @param applicationEvent Application event
+     * @param object target
+     * @throws ApplicationEventReplayException if unable to play event
      */
     public void playEvent( ApplicationEvent applicationEvent, Object object )
             throws ApplicationEventReplayException;

http://git-wip-us.apache.org/repos/asf/zest-qi4j/blob/3c882b82/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/application/source/ApplicationEventSource.java
----------------------------------------------------------------------
diff --git a/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/application/source/ApplicationEventSource.java b/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/application/source/ApplicationEventSource.java
index bb47de2..0019e00 100644
--- a/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/application/source/ApplicationEventSource.java
+++ b/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/application/source/ApplicationEventSource.java
@@ -29,11 +29,12 @@ public interface ApplicationEventSource
      * Get list of event transactions after the given timestamp.
      * <p>
      * If they are on the exact same timestamp, they will not be included.
-     * </p>
      * <p>
      * The method uses the visitor pattern, so a visitor is sent in which is given each transaction, one at a time.
-     * </p>
+     *
      * @param afterTimestamp timestamp of transactions
+     * @param maxTransactions maximum transactions
+     * @return list of event transactions
      */
     Input<TransactionApplicationEvents, IOException> transactionsAfter( long afterTimestamp, long maxTransactions );
 
@@ -41,14 +42,14 @@ public interface ApplicationEventSource
      * Get list of event transactions before the given timestamp.
      * <p>
      * If they are on the exact same timestamp, they will not be included.
-     * </p>
      * <p>
      * The method uses the visitor pattern, so a visitor is sent in which is given each transaction, one at a time.
-     * </p>
      * <p>
      * The transactions are sent to the visitor with the latest transaction first, i.e. walking backwards in the stream.
-     * </p>
+     *
      * @param beforeTimestamp timestamp of transactions
+     * @param maxTransactions maximum transactions
+     * @return list of event transactions
      */
     Input<TransactionApplicationEvents, IOException> transactionsBefore( long beforeTimestamp, long maxTransactions );
 }

http://git-wip-us.apache.org/repos/asf/zest-qi4j/blob/3c882b82/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/application/source/helper/ApplicationEventParameters.java
----------------------------------------------------------------------
diff --git a/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/application/source/helper/ApplicationEventParameters.java b/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/application/source/helper/ApplicationEventParameters.java
index 5faf3e9..50e2e36 100644
--- a/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/application/source/helper/ApplicationEventParameters.java
+++ b/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/application/source/helper/ApplicationEventParameters.java
@@ -51,7 +51,6 @@ public class ApplicationEventParameters
      * @param event event with parameters
      * @param idx   index of parameter
      * @return the parameter with the given index or null
-     * @throws org.json.JSONException
      */
     public static String getParameter( ApplicationEvent event, int idx )
     {

http://git-wip-us.apache.org/repos/asf/zest-qi4j/blob/3c882b82/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/domain/replay/DomainEventPlayer.java
----------------------------------------------------------------------
diff --git a/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/domain/replay/DomainEventPlayer.java b/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/domain/replay/DomainEventPlayer.java
index 4347043..05a5d67 100644
--- a/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/domain/replay/DomainEventPlayer.java
+++ b/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/domain/replay/DomainEventPlayer.java
@@ -33,9 +33,9 @@ public interface DomainEventPlayer
      * be the original object, but could also be a service that wants
      * to be invoked to handle the event.
      *
-     * @param domainEventValue
-     * @param object
-     * @throws EventReplayException
+     * @param domainEventValue Domain event value
+     * @param object target
+     * @throws EventReplayException if unable to play event
      */
     public void playEvent( DomainEventValue domainEventValue, Object object )
             throws EventReplayException;

http://git-wip-us.apache.org/repos/asf/zest-qi4j/blob/3c882b82/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/domain/source/EventSource.java
----------------------------------------------------------------------
diff --git a/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/domain/source/EventSource.java b/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/domain/source/EventSource.java
index e025b3f..4bb5508 100644
--- a/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/domain/source/EventSource.java
+++ b/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/domain/source/EventSource.java
@@ -34,6 +34,7 @@ public interface EventSource
      *
      * @param offset where in the list of events to start
      * @param limit maximum number of events returned
+     * @return list of UnitOfWorkDomainEventsValue after the given offset
      */
     Input<UnitOfWorkDomainEventsValue, IOException> events( long offset, long limit );
 

http://git-wip-us.apache.org/repos/asf/zest-qi4j/blob/3c882b82/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/domain/source/helper/EventParameters.java
----------------------------------------------------------------------
diff --git a/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/domain/source/helper/EventParameters.java b/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/domain/source/helper/EventParameters.java
index 1c53d21..536e68f 100644
--- a/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/domain/source/helper/EventParameters.java
+++ b/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/domain/source/helper/EventParameters.java
@@ -52,7 +52,6 @@ public class EventParameters
      * @param eventValue eventValue with parameters
      * @param idx   index of parameter
      * @return the parameter with the given index or null
-     * @throws JSONException
      */
     public static String getParameter( DomainEventValue eventValue, int idx )
     {

http://git-wip-us.apache.org/repos/asf/zest-qi4j/blob/3c882b82/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/domain/source/helper/EventRouter.java
----------------------------------------------------------------------
diff --git a/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/domain/source/helper/EventRouter.java b/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/domain/source/helper/EventRouter.java
index 9594a8b..eb20ab4 100644
--- a/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/domain/source/helper/EventRouter.java
+++ b/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/domain/source/helper/EventRouter.java
@@ -27,7 +27,7 @@ import org.qi4j.library.eventsourcing.domain.api.DomainEventValue;
 import org.qi4j.library.eventsourcing.domain.api.UnitOfWorkDomainEventsValue;
 
 /**
- * Event handling router. Add specification->receiver routes. When an event comes in
+ * Event handling router. Add specification-&gt;receiver routes. When an event comes in
  * the router will ask each specification if it matches, and if so, delegate to the
  * receiver and return whether it successfully handled it or not. If no routes match,
  * delegate to the default receiver

http://git-wip-us.apache.org/repos/asf/zest-qi4j/blob/3c882b82/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/domain/source/helper/UnitOfWorkRouter.java
----------------------------------------------------------------------
diff --git a/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/domain/source/helper/UnitOfWorkRouter.java b/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/domain/source/helper/UnitOfWorkRouter.java
index fabbc34..0375b50 100644
--- a/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/domain/source/helper/UnitOfWorkRouter.java
+++ b/libraries/eventsourcing/src/main/java/org/qi4j/library/eventsourcing/domain/source/helper/UnitOfWorkRouter.java
@@ -26,7 +26,7 @@ import org.qi4j.io.Sender;
 import org.qi4j.library.eventsourcing.domain.api.UnitOfWorkDomainEventsValue;
 
 /**
- * UnitOfWork handling router. Add specification->receiver routes. When a UnitOfWorkEDomainEventsValue comes in
+ * UnitOfWork handling router. Add specification-&gt;receiver routes. When a UnitOfWorkEDomainEventsValue comes in
  * the router will ask each specification if it matches, and if so, delegate to the
  * receiver. If no routes match, delegate to the default receiver.
  */

http://git-wip-us.apache.org/repos/asf/zest-qi4j/blob/3c882b82/libraries/lang-groovy/src/main/java/org/qi4j/lang/groovy/GroovyMixin.java
----------------------------------------------------------------------
diff --git a/libraries/lang-groovy/src/main/java/org/qi4j/lang/groovy/GroovyMixin.java b/libraries/lang-groovy/src/main/java/org/qi4j/lang/groovy/GroovyMixin.java
index dd15683..d2d72eb 100644
--- a/libraries/lang-groovy/src/main/java/org/qi4j/lang/groovy/GroovyMixin.java
+++ b/libraries/lang-groovy/src/main/java/org/qi4j/lang/groovy/GroovyMixin.java
@@ -40,7 +40,7 @@ import org.qi4j.io.Outputs;
 /**
  * Generic mixin that implements interfaces by delegating to Groovy functions
  * using Groovy. Each method in an interface is declared by a Groovy method
- * in a file located in classpath with the name "<interface>.groovy",
+ * in a file located in classpath with the name "&lt;interface&gt;.groovy",
  * where the interface name includes the package, and has "." replaced with "/".
  * <p>
  * Example:

http://git-wip-us.apache.org/repos/asf/zest-qi4j/blob/3c882b82/libraries/lang-javascript/src/main/java/org/qi4j/lang/javascript/JavaScriptMixin.java
----------------------------------------------------------------------
diff --git a/libraries/lang-javascript/src/main/java/org/qi4j/lang/javascript/JavaScriptMixin.java b/libraries/lang-javascript/src/main/java/org/qi4j/lang/javascript/JavaScriptMixin.java
index 098aaca..5575458 100644
--- a/libraries/lang-javascript/src/main/java/org/qi4j/lang/javascript/JavaScriptMixin.java
+++ b/libraries/lang-javascript/src/main/java/org/qi4j/lang/javascript/JavaScriptMixin.java
@@ -30,7 +30,7 @@ import org.qi4j.library.scripting.ScriptReloadable;
 /**
  * Generic mixin that implements interfaces by delegating to JavaScript functions
  * using Rhino. Each method in an interface is declared as a JS function
- * in a file located in classpath with the name "<interface>.<method>.js",
+ * in a file located in classpath with the name "&lt;interface&gt;.&lt;method&gt;.js",
  * where the interface name includes the package, and has "." replaced with "/".
  * <p>
  * Example:

http://git-wip-us.apache.org/repos/asf/zest-qi4j/blob/3c882b82/libraries/lang-jruby/src/main/java/org/qi4j/lang/jruby/JRubyMixin.java
----------------------------------------------------------------------
diff --git a/libraries/lang-jruby/src/main/java/org/qi4j/lang/jruby/JRubyMixin.java b/libraries/lang-jruby/src/main/java/org/qi4j/lang/jruby/JRubyMixin.java
index c36d7f6..9d4bd01 100644
--- a/libraries/lang-jruby/src/main/java/org/qi4j/lang/jruby/JRubyMixin.java
+++ b/libraries/lang-jruby/src/main/java/org/qi4j/lang/jruby/JRubyMixin.java
@@ -39,7 +39,7 @@ import org.qi4j.library.scripting.ScriptReloadable;
 /**
  * Generic mixin that implements interfaces by delegating to Ruby functions
  * using JRuby. Each method in an interface is declared by a Ruby method
- * in a file located in classpath with the name "<interface>.rb",
+ * in a file located in classpath with the name "&lt;interface&gt;.rb",
  * where the interface name includes the package, and has "." replaced with "/".
  * <p>
  * Example:

http://git-wip-us.apache.org/repos/asf/zest-qi4j/blob/3c882b82/libraries/spring/src/main/java/org/qi4j/library/spring/bootstrap/Qi4jApplicationBootstrap.java
----------------------------------------------------------------------
diff --git a/libraries/spring/src/main/java/org/qi4j/library/spring/bootstrap/Qi4jApplicationBootstrap.java b/libraries/spring/src/main/java/org/qi4j/library/spring/bootstrap/Qi4jApplicationBootstrap.java
index 02ca11f..dccc63d 100644
--- a/libraries/spring/src/main/java/org/qi4j/library/spring/bootstrap/Qi4jApplicationBootstrap.java
+++ b/libraries/spring/src/main/java/org/qi4j/library/spring/bootstrap/Qi4jApplicationBootstrap.java
@@ -33,32 +33,31 @@ import org.springframework.context.ApplicationContextAware;
  * <li>Assemble qi4j application by implementing #assemble method.</li>
  * <li>Sets the identity of bean factory service. This identity is the spring
  * bean name.</li>
- * <li>Declare qi4j bootstrap in spring xml application context. </li>
- * 
+ * <li>Declare qi4j bootstrap in spring xml application context.
  * <pre><code>
- * &lt?xml version="1.0" encoding="UTF-8"?&gt
+ * &lt;?xml version="1.0" encoding="UTF-8"?&gt;
  *
  * &lt;beans xmlns="http://www.springframework.org/schema/beans"
  * xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  * xmlns:qi4j="http://www.qi4j.org/schema/qi4j/spring"
  * xsi:schemaLocation="
  * http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd
- * http://www.qi4j.org/schema/qi4j/spring http://www.qi4j.org/schema/qi4j/spring/spring-0.5.xsd"&gt
+ * http://www.qi4j.org/schema/qi4j/spring http://www.qi4j.org/schema/qi4j/spring/spring-0.5.xsd"&gt;
  *
- * &lt!-- class that implements Qi4jApplicationBootstrap --&gt
+ * &lt;!-- class that implements Qi4jApplicationBootstrap --&gt;
  *
- * &lt;qi4j:bootstrap class="org.qi4j.library.spring.bootstrap.Qi4jTestBootstrap"/&gt
+ * &lt;qi4j:bootstrap class="org.qi4j.library.spring.bootstrap.Qi4jTestBootstrap"/&gt;
  *
- * &lt;bean id="commentServiceHolder" class="org.qi4j.library.spring.bootstrap.CommentServiceHolder"&gt
+ * &lt;bean id="commentServiceHolder" class="org.qi4j.library.spring.bootstrap.CommentServiceHolder"&gt;
  *
- * &lt;constructor-arg ref="commentService"/&gt &lt;!-- Reference qi4j comment service --&gt
+ * &lt;constructor-arg ref="commentService"/&gt; &lt;!-- Reference qi4j comment service --&gt;
  *
  * &lt;/bean&gt;
  * </code></pre>
  * </li>
  * </ul>
  * <p>
- * <b>Importing Spring beans as services</b><br/>
+ * <b>Importing Spring beans as services</b><br>
  * </p>
  * <ol>
  * <li>Application bootstrap class must implement interface

http://git-wip-us.apache.org/repos/asf/zest-qi4j/blob/3c882b82/libraries/spring/src/main/java/org/qi4j/library/spring/importer/SpringImporter.java
----------------------------------------------------------------------
diff --git a/libraries/spring/src/main/java/org/qi4j/library/spring/importer/SpringImporter.java b/libraries/spring/src/main/java/org/qi4j/library/spring/importer/SpringImporter.java
index 2d2e7f7..46e9161 100644
--- a/libraries/spring/src/main/java/org/qi4j/library/spring/importer/SpringImporter.java
+++ b/libraries/spring/src/main/java/org/qi4j/library/spring/importer/SpringImporter.java
@@ -32,7 +32,7 @@ public class SpringImporter
      *
      * @param serviceDescriptor The service descriptor.
      * @return a service instance
-     * @throws ServiceImporterException
+     * @throws ServiceImporterException if unable to import the service
      */
     @Override
     public Object importService( ImportedServiceDescriptor serviceDescriptor ) throws ServiceImporterException

http://git-wip-us.apache.org/repos/asf/zest-qi4j/blob/3c882b82/libraries/struts2-plugin/src/main/java/org/qi4j/library/struts2/Qi4jPropertyAccessor.java
----------------------------------------------------------------------
diff --git a/libraries/struts2-plugin/src/main/java/org/qi4j/library/struts2/Qi4jPropertyAccessor.java b/libraries/struts2-plugin/src/main/java/org/qi4j/library/struts2/Qi4jPropertyAccessor.java
index 6ed8df3..673de8b 100644
--- a/libraries/struts2-plugin/src/main/java/org/qi4j/library/struts2/Qi4jPropertyAccessor.java
+++ b/libraries/struts2-plugin/src/main/java/org/qi4j/library/struts2/Qi4jPropertyAccessor.java
@@ -42,7 +42,7 @@ import static org.qi4j.library.struts2.ConstraintViolationInterceptor.CONTEXT_CO
  *
  * <p>NOTE: We can't do this as a regular converter because Qi4j composites doesn't (nor should it be) following the
  * JavaBean standard.  We might be able to only override the getProperty() method here and have regular converters for
- * Property, Association and SetAssociation but I haven't tried that yet so it may not work as expected.</>
+ * Property, Association and SetAssociation but I haven't tried that yet so it may not work as expected.</p>
  *
  * <p>TODO: Doesn't yet handle ManyAssociations, but these shouldn't be too hard to add</p>
  */

http://git-wip-us.apache.org/repos/asf/zest-qi4j/blob/3c882b82/samples/dci-cargo/dcisample_a/src/main/java/org/qi4j/sample/dcicargo/sample_a/infrastructure/wicket/form/DateTextFieldWithPicker.java
----------------------------------------------------------------------
diff --git a/samples/dci-cargo/dcisample_a/src/main/java/org/qi4j/sample/dcicargo/sample_a/infrastructure/wicket/form/DateTextFieldWithPicker.java b/samples/dci-cargo/dcisample_a/src/main/java/org/qi4j/sample/dcicargo/sample_a/infrastructure/wicket/form/DateTextFieldWithPicker.java
index fc5d172..6617619 100644
--- a/samples/dci-cargo/dcisample_a/src/main/java/org/qi4j/sample/dcicargo/sample_a/infrastructure/wicket/form/DateTextFieldWithPicker.java
+++ b/samples/dci-cargo/dcisample_a/src/main/java/org/qi4j/sample/dcicargo/sample_a/infrastructure/wicket/form/DateTextFieldWithPicker.java
@@ -165,7 +165,7 @@ public class DateTextFieldWithPicker extends DateTextField
      * href="http://developer.yahoo.com/yui/calendar/">the widget's documentation</a> for the
      * available options. If you want to override/ remove properties, you should call
      * super.configure(properties) first. If you don't call that, be aware that you will have to
-     * call {@link #localize(Map)} manually if you like localized strings to be added.
+     * call {@literal #localize(Map)} manually if you like localized strings to be added.
      *
      * @param widgetProperties the current widget properties
      */

http://git-wip-us.apache.org/repos/asf/zest-qi4j/blob/3c882b82/samples/dci-cargo/dcisample_b/src/main/java/org/qi4j/sample/dcicargo/sample_b/context/interaction/handling/ProcessHandlingEvent.java
----------------------------------------------------------------------
diff --git a/samples/dci-cargo/dcisample_b/src/main/java/org/qi4j/sample/dcicargo/sample_b/context/interaction/handling/ProcessHandlingEvent.java b/samples/dci-cargo/dcisample_b/src/main/java/org/qi4j/sample/dcicargo/sample_b/context/interaction/handling/ProcessHandlingEvent.java
index 5641a85..5348568 100644
--- a/samples/dci-cargo/dcisample_b/src/main/java/org/qi4j/sample/dcicargo/sample_b/context/interaction/handling/ProcessHandlingEvent.java
+++ b/samples/dci-cargo/dcisample_b/src/main/java/org/qi4j/sample/dcicargo/sample_b/context/interaction/handling/ProcessHandlingEvent.java
@@ -50,7 +50,7 @@ import org.slf4j.LoggerFactory;
  *
  * 1. Data Parser in {@link ParseHandlingEventData}
  * 2. Event Registrar in {@link RegisterHandlingEvent}
- * 3. Delivery Inspector in {@link com.marcgrue.dcisample_b.context.interaction.handling.inspection.InspectCargoDeliveryStatus}
+ * 3. Delivery Inspector in {@link org.qi4j.sample.dcicargo.sample_b.context.interaction.handling.inspection.InspectCargoDeliveryStatus}
  *
  * For now we simply (synchronously) invoke each subfunction use case with a method call. But
  * we could also implement this asynchronously with JMS or other similar solutions and have

http://git-wip-us.apache.org/repos/asf/zest-qi4j/blob/3c882b82/samples/dci-cargo/dcisample_b/src/main/java/org/qi4j/sample/dcicargo/sample_b/infrastructure/wicket/form/DateTextFieldWithPicker.java
----------------------------------------------------------------------
diff --git a/samples/dci-cargo/dcisample_b/src/main/java/org/qi4j/sample/dcicargo/sample_b/infrastructure/wicket/form/DateTextFieldWithPicker.java b/samples/dci-cargo/dcisample_b/src/main/java/org/qi4j/sample/dcicargo/sample_b/infrastructure/wicket/form/DateTextFieldWithPicker.java
index 26e09aa..ff6d131 100644
--- a/samples/dci-cargo/dcisample_b/src/main/java/org/qi4j/sample/dcicargo/sample_b/infrastructure/wicket/form/DateTextFieldWithPicker.java
+++ b/samples/dci-cargo/dcisample_b/src/main/java/org/qi4j/sample/dcicargo/sample_b/infrastructure/wicket/form/DateTextFieldWithPicker.java
@@ -165,7 +165,7 @@ public class DateTextFieldWithPicker extends DateTextField
      * href="http://developer.yahoo.com/yui/calendar/">the widget's documentation</a> for the
      * available options. If you want to override/ remove properties, you should call
      * super.configure(properties) first. If you don't call that, be aware that you will have to
-     * call {@link #localize(Map)} manually if you like localized strings to be added.
+     * call {@literal #localize(Map)} manually if you like localized strings to be added.
      *
      * @param widgetProperties the current widget properties
      */