You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@chemistry.apache.org by fm...@apache.org on 2016/06/03 13:01:58 UTC

svn commit: r1746713 [1/2] - in /chemistry/opencmis/trunk: ./ chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/ chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/c...

Author: fmui
Date: Fri Jun  3 13:01:57 2016
New Revision: 1746713

URL: http://svn.apache.org/viewvc?rev=1746713&view=rev
Log:
JavaDoc fixes

Modified:
    chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/SessionFactoryFinder.java
    chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/SessionParameterMap.java
    chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/ItemIterable.java
    chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/SessionFactory.java
    chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-bindings/src/main/java/org/apache/chemistry/opencmis/client/bindings/CmisBindingFactory.java
    chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-impl/src/main/java/org/apache/chemistry/opencmis/client/util/FileUtils.java
    chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/definitions/TypeDefinitionContainer.java
    chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/exceptions/CmisBaseException.java
    chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/server/CallContext.java
    chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/server/CmisService.java
    chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/server/TempStoreOutputStream.java
    chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/AclService.java
    chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/DiscoveryService.java
    chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/ExtendedRepositoryService.java
    chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/MultiFilingService.java
    chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/NavigationService.java
    chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/ObjectService.java
    chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/PolicyService.java
    chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/RelationshipService.java
    chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/RepositoryService.java
    chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/VersioningService.java
    chemistry/opencmis/trunk/chemistry-opencmis-server/chemistry-opencmis-server-bindings/src/main/java/org/apache/chemistry/opencmis/server/impl/endpoints/SimpleCmisEndpointsDocumentServlet.java
    chemistry/opencmis/trunk/chemistry-opencmis-server/chemistry-opencmis-server-support/src/main/java/org/apache/chemistry/opencmis/server/support/query/PredicateWalkerBase.java
    chemistry/opencmis/trunk/chemistry-opencmis-server/chemistry-opencmis-server-support/src/main/java/org/apache/chemistry/opencmis/server/support/query/QueryUtil.java
    chemistry/opencmis/trunk/chemistry-opencmis-server/chemistry-opencmis-server-support/src/main/java/org/apache/chemistry/opencmis/server/support/query/QueryUtilBase.java
    chemistry/opencmis/trunk/chemistry-opencmis-server/chemistry-opencmis-server-support/src/main/java/org/apache/chemistry/opencmis/server/support/wrapper/AbstractCmisServiceWrapper.java
    chemistry/opencmis/trunk/chemistry-opencmis-server/chemistry-opencmis-server-support/src/main/java/org/apache/chemistry/opencmis/server/support/wrapper/ConformanceCmisServiceWrapper.java
    chemistry/opencmis/trunk/pom.xml

Modified: chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/SessionFactoryFinder.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/SessionFactoryFinder.java?rev=1746713&r1=1746712&r2=1746713&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/SessionFactoryFinder.java (original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/SessionFactoryFinder.java Fri Jun  3 13:01:57 2016
@@ -30,7 +30,7 @@ import org.apache.chemistry.opencmis.cli
  * Finds a {@link SessionFactory} implementation and creates a factory object.
  * <p>
  * Sample code:
- * <p>
+ * </p>
  * 
  * <pre>
  * SessionFactory factory = SessionFactoryFinder.find();

Modified: chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/SessionParameterMap.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/SessionParameterMap.java?rev=1746713&r1=1746712&r2=1746713&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/SessionParameterMap.java (original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/SessionParameterMap.java Fri Jun  3 13:01:57 2016
@@ -46,7 +46,7 @@ import org.apache.chemistry.opencmis.com
  * A map with convenience methods to set session parameters.
  * <p>
  * Sample code:
- * <p>
+ * </p>
  * 
  * <pre>
  * SessionFactory factory = ...
@@ -60,6 +60,7 @@ import org.apache.chemistry.opencmis.com
  * Session session = factory.createSession(parameter);
  * </pre>
  * 
+ * 
  * @see SessionParameter
  * @see SessionFactory
  */

Modified: chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/ItemIterable.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/ItemIterable.java?rev=1746713&r1=1746712&r2=1746713&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/ItemIterable.java (original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/ItemIterable.java Fri Jun  3 13:01:57 2016
@@ -33,6 +33,7 @@ public interface ItemIterable<T> extends
      * Skips to position within CMIS collection.
      * 
      * @param position
+     *            offset where to skip to
      * 
      * @return iterable whose starting point is the specified skip to position.
      *         This iterable <em>may</em> be the same as {@code this}

Modified: chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/SessionFactory.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/SessionFactory.java?rev=1746713&r1=1746712&r2=1746713&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/SessionFactory.java (original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/SessionFactory.java Fri Jun  3 13:01:57 2016
@@ -33,13 +33,15 @@ import java.util.Map;
  * {@link org.apache.chemistry.opencmis.commons.SessionParameter} class which is
  * part of the commons package. Parameters specify connection settings (user
  * name, authentication, connection URL, binding type, etc.).
+ * </p>
  * <p>
  * The {@link Session} class which is constructed is either the {@code session}
  * base class which is the default implementation or it can be derived from that
  * implementing special behavior for the session.
+ * </p>
  * <p>
  * Sample code:
- * <p>
+ * </p>
  * 
  * <pre>
  * SessionFactory factory = ...

Modified: chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-bindings/src/main/java/org/apache/chemistry/opencmis/client/bindings/CmisBindingFactory.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-bindings/src/main/java/org/apache/chemistry/opencmis/client/bindings/CmisBindingFactory.java?rev=1746713&r1=1746712&r2=1746713&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-bindings/src/main/java/org/apache/chemistry/opencmis/client/bindings/CmisBindingFactory.java (original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-bindings/src/main/java/org/apache/chemistry/opencmis/client/bindings/CmisBindingFactory.java Fri Jun  3 13:01:57 2016
@@ -63,6 +63,8 @@ public class CmisBindingFactory {
 
     /**
      * Creates a new factory instance.
+     * 
+     * @return a new factory instance
      */
     public static CmisBindingFactory newInstance() {
         return new CmisBindingFactory();
@@ -70,6 +72,8 @@ public class CmisBindingFactory {
 
     /**
      * Returns the default session parameters.
+     * 
+     * @return the default session parameters
      */
     public Map<String, String> getDefaultSessionParameters() {
         return defaults;
@@ -77,6 +81,9 @@ public class CmisBindingFactory {
 
     /**
      * Sets the default session parameters.
+     * 
+     * @param sessionParameters
+     *            the session parameters
      */
     public void setDefaultSessionParameters(Map<String, String> sessionParameters) {
         if (sessionParameters == null) {
@@ -89,6 +96,10 @@ public class CmisBindingFactory {
     /**
      * Creates a CMIS binding instance. A binding class has to be provided in
      * the session parameters.
+     * 
+     * @param sessionParameters
+     *            the session parameters
+     * @return the binding object
      */
     public CmisBinding createCmisBinding(Map<String, String> sessionParameters) {
         return createCmisBinding(sessionParameters, null, null);
@@ -97,6 +108,10 @@ public class CmisBindingFactory {
     /**
      * Creates a CMIS binding instance. A binding class has to be provided in
      * the session parameters.
+     * 
+     * @param sessionParameters
+     *            the session parameters
+     * @return the binding object
      */
     public CmisBinding createCmisBinding(Map<String, String> sessionParameters,
             AuthenticationProvider authenticationProvider, TypeDefinitionCache typeDefCache) {
@@ -109,6 +124,10 @@ public class CmisBindingFactory {
 
     /**
      * Creates a default CMIS AtomPub binding instance.
+     * 
+     * @param sessionParameters
+     *            the session parameters
+     * @return the binding object
      */
     public CmisBinding createCmisAtomPubBinding(Map<String, String> sessionParameters) {
         return createCmisAtomPubBinding(sessionParameters, null, null);
@@ -117,6 +136,10 @@ public class CmisBindingFactory {
     /**
      * Creates a default CMIS AtomPub binding instance with a custom
      * authentication provider.
+     * 
+     * @param sessionParameters
+     *            the session parameters
+     * @return the binding object
      */
     public CmisBinding createCmisAtomPubBinding(Map<String, String> sessionParameters,
             AuthenticationProvider authenticationProvider, TypeDefinitionCache typeDefCache) {
@@ -150,6 +173,10 @@ public class CmisBindingFactory {
 
     /**
      * Creates a default CMIS Web Services binding instance.
+     * 
+     * @param sessionParameters
+     *            the session parameters
+     * @return the binding object
      */
     public CmisBinding createCmisWebServicesBinding(Map<String, String> sessionParameters) {
         return createCmisWebServicesBinding(sessionParameters, null, null);
@@ -158,6 +185,10 @@ public class CmisBindingFactory {
     /**
      * Creates a default CMIS Web Services binding instance with a custom
      * authentication provider.
+     * 
+     * @param sessionParameters
+     *            the session parameters
+     * @return the binding object
      */
     public CmisBinding createCmisWebServicesBinding(Map<String, String> sessionParameters,
             AuthenticationProvider authenticationProvider, TypeDefinitionCache typeDefCache) {
@@ -210,6 +241,10 @@ public class CmisBindingFactory {
 
     /**
      * Creates a default CMIS Browser binding instance.
+     * 
+     * @param sessionParameters
+     *            the session parameters
+     * @return the binding object
      */
     public CmisBinding createCmisBrowserBinding(Map<String, String> sessionParameters) {
         return createCmisBrowserBinding(sessionParameters, null, null);
@@ -218,6 +253,10 @@ public class CmisBindingFactory {
     /**
      * Creates a default CMIS Browser binding instance with a custom
      * authentication provider.
+     * 
+     * @param sessionParameters
+     *            the session parameters
+     * @return the binding object
      */
     public CmisBinding createCmisBrowserBinding(Map<String, String> sessionParameters,
             AuthenticationProvider authenticationProvider, TypeDefinitionCache typeDefCache) {
@@ -254,6 +293,10 @@ public class CmisBindingFactory {
 
     /**
      * Creates a default CMIS local binding instance.
+     * 
+     * @param sessionParameters
+     *            the session parameters
+     * @return the binding object
      */
     public CmisBinding createCmisLocalBinding(Map<String, String> sessionParameters) {
         return createCmisLocalBinding(sessionParameters, null);
@@ -261,6 +304,10 @@ public class CmisBindingFactory {
 
     /**
      * Creates a default CMIS local binding instance.
+     * 
+     * @param sessionParameters
+     *            the session parameters
+     * @return the binding object
      */
     public CmisBinding createCmisLocalBinding(Map<String, String> sessionParameters, TypeDefinitionCache typeDefCache) {
         checkSessionParameters(sessionParameters, false);

Modified: chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-impl/src/main/java/org/apache/chemistry/opencmis/client/util/FileUtils.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-impl/src/main/java/org/apache/chemistry/opencmis/client/util/FileUtils.java?rev=1746713&r1=1746712&r2=1746713&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-impl/src/main/java/org/apache/chemistry/opencmis/client/util/FileUtils.java (original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-impl/src/main/java/org/apache/chemistry/opencmis/client/util/FileUtils.java Fri Jun  3 13:01:57 2016
@@ -55,7 +55,9 @@ public final class FileUtils {
      * @param session
      *            the session
      * @return the object
+     * 
      * @throws CmisBaseException
+     *             if something go wrong, for example the object doesn't exist
      */
     public static CmisObject getObject(String pathOrIdOfObject, Session session) {
         if (session == null) {
@@ -83,7 +85,9 @@ public final class FileUtils {
      * @param session
      *            the session
      * @return the folder object
+     * 
      * @throws CmisBaseException
+     *             if something go wrong, for example the object doesn't exist
      */
     public static Folder getFolder(String pathOrIdOfObject, Session session) {
         CmisObject folder = getObject(pathOrIdOfObject, session);
@@ -107,8 +111,11 @@ public final class FileUtils {
      * @param versioningState
      *            the versioning state or <code>null</code>
      * @return the newly created document
+     * 
      * @throws FileNotFoundException
+     *             if the file does not exist
      * @throws CmisBaseException
+     *             if something go wrong, for example the object doesn't exist
      */
     public static Document createDocumentFromFile(String parentIdOrPath, File file, String type,
             VersioningState versioningState, Session session) throws FileNotFoundException {
@@ -182,7 +189,10 @@ public final class FileUtils {
      * @param type
      *            the folder type (defaults to <code>cmis:folder</code>)
      * @return the newly created folder
+     * 
      * @throws CmisBaseException
+     *             if something go wrong, for example the parent folder doesn't
+     *             exist
      */
     public static Folder createFolder(Folder parentFolder, String name, String type) {
         if (type == null) {
@@ -208,7 +218,10 @@ public final class FileUtils {
      * @param session
      *            the session
      * @return the newly created folder
+     * 
      * @throws CmisBaseException
+     *             if something go wrong, for example the parent folder doesn't
+     *             exist
      */
     public static Folder createFolder(String parentIdOrPath, String name, String type, Session session) {
         Folder parentFolder = getFolder(parentIdOrPath, session);
@@ -231,8 +244,11 @@ public final class FileUtils {
      *            the document
      * @param destinationPath
      *            the destination path
+     * 
      * @throws IOException
+     *             if the download fails because of an IO problem
      * @throws CmisBaseException
+     *             if something go wrong, for example the document doesn't exist
      */
     public static void download(Document doc, String destinationPath) throws IOException {
         if (doc == null) {
@@ -262,8 +278,11 @@ public final class FileUtils {
      *            the destination path
      * @param session
      *            the session
+     * 
      * @throws IOException
+     *             if the download fails because of an IO problem
      * @throws CmisBaseException
+     *             if something go wrong, for example the document doesn't exist
      */
     public static void download(String docIdOrPath, String destinationPath, Session session) throws IOException {
         CmisObject doc = getObject(docIdOrPath, session);
@@ -282,7 +301,9 @@ public final class FileUtils {
      *            the id or path of the object
      * @param session
      *            the session
+     * 
      * @throws CmisBaseException
+     *             if something go wrong, for example the object doesn't exist
      */
     public static void delete(String pathOrIdOfObject, Session session) {
         CmisObject object = getObject(pathOrIdOfObject, session);

Modified: chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/definitions/TypeDefinitionContainer.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/definitions/TypeDefinitionContainer.java?rev=1746713&r1=1746712&r2=1746713&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/definitions/TypeDefinitionContainer.java (original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/definitions/TypeDefinitionContainer.java Fri Jun  3 13:01:57 2016
@@ -30,11 +30,15 @@ public interface TypeDefinitionContainer
 
     /**
      * Returns the type definition at this level.
+     * 
+     * @return the type definition
      */
     TypeDefinition getTypeDefinition();
 
     /**
      * Returns direct children of the type definition at this level.
+     * 
+     * @return the children of this type
      */
     List<TypeDefinitionContainer> getChildren();
 }

Modified: chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/exceptions/CmisBaseException.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/exceptions/CmisBaseException.java?rev=1746713&r1=1746712&r2=1746713&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/exceptions/CmisBaseException.java (original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/exceptions/CmisBaseException.java Fri Jun  3 13:01:57 2016
@@ -208,6 +208,9 @@ public abstract class CmisBaseException
     /**
      * Returns additional data, if available.
      * 
+     * @param key
+     *            the data key
+     * 
      * @return additional data, can be {@code null}
      */
     public String getAdditionalData(String key) {
@@ -230,6 +233,8 @@ public abstract class CmisBaseException
 
     /**
      * Returns the name of the exception as defined in the CMIS specification.
+     * 
+     * @return the exception name
      */
     public abstract String getExceptionName();
 }

Modified: chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/server/CallContext.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/server/CallContext.java?rev=1746713&r1=1746712&r2=1746713&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/server/CallContext.java (original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/server/CallContext.java Fri Jun  3 13:01:57 2016
@@ -70,19 +70,26 @@ public interface CallContext {
     String MAX_CONTENT_SIZE = "maxContentSize";
     /** Key: encrypt temp files (values is a Boolean) */
     String ENCRYPT_TEMP_FILE = "encryptTempFiles";
-    /** Key: factory for threshold streams (value is a TempStoreOutputStreamFactory) */
+    /**
+     * Key: factory for threshold streams (value is a
+     * TempStoreOutputStreamFactory)
+     */
     String STREAM_FACTORY = "streamFactory";
-    
+
     /**
      * Returns the binding. Usually it returns
      * {@link CallContext#BINDING_ATOMPUB},
      * {@link CallContext#BINDING_WEBSERVICES},
      * {@link CallContext#BINDING_BROWSER} or {@link CallContext#BINDING_LOCAL}.
+     * 
+     * @return the binding
      */
     String getBinding();
 
     /**
-     * Returns if <code>true</code> object infos can improve the performance.
+     * Returns if {@code true} object infos can improve the performance.
+     * 
+     * @return if object infos are required
      */
     boolean isObjectInfoRequired();
 
@@ -91,62 +98,86 @@ public interface CallContext {
      * 
      * @param key
      *            the key
-     * @return the data if the key is valid, <code>null</code> otherwise
+     * 
+     * @return the data if the key is valid, {@code null} otherwise
      */
     Object get(String key);
 
     /**
      * Returns the CMIS version.
+     * 
+     * @return the CMIS version, not {@code null}
      */
     CmisVersion getCmisVersion();
 
     /**
-     * Returns the repository id.
+     * Returns the repository ID.
+     * 
+     * @return the repository ID or {@code null} if it's a repository info call
      */
     String getRepositoryId();
 
     /**
      * Returns the user name.
+     * 
+     * @return the user name if provided
      */
     String getUsername();
 
     /**
      * Returns the password.
+     * 
+     * @return the password if provided
      */
     String getPassword();
 
     /**
      * Returns the locale.
+     * 
+     * @return the locale if set
      */
     String getLocale();
 
     /**
-     * Returns the content offset if set, <code>null</code> otherwise
+     * Returns the content offset.
+     * 
+     * @return the content offset if set, {@code null} otherwise
      */
     BigInteger getOffset();
 
     /**
-     * Returns the content length if set, <code>null</code> otherwise
+     * Returns the content length.
+     * 
+     * @return the content length if set, {@code null} otherwise
      */
     BigInteger getLength();
 
     /**
      * Returns the temp directory.
+     * 
+     * @return the temp directory
      */
     File getTempDirectory();
 
     /**
      * Returns if temp files should be encrypted.
+     * 
+     * @return {@code true} if temp files should be encrypted, {@code false}
+     *         otherwise
      */
     boolean encryptTempFiles();
 
     /**
      * Returns the memory threshold.
+     * 
+     * @return the memory threshold in bytes
      */
     int getMemoryThreshold();
 
     /**
-     * Returns the may size of content.
+     * Returns the max size of content.
+     * 
+     * @return the max content size in bytes
      */
     long getMaxContentSize();
 }

Modified: chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/server/CmisService.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/server/CmisService.java?rev=1746713&r1=1746712&r2=1746713&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/server/CmisService.java (original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/server/CmisService.java Fri Jun  3 13:01:57 2016
@@ -83,6 +83,8 @@ public interface CmisService extends Rep
      * @param policies
      *            <em>(optional)</em> a list of policy IDs that MUST be applied
      *            to the newly created object
+     * @param extension
+     *            extension data
      * @return the object ID of the newly created object
      */
     String create(String repositoryId, Properties properties, String folderId, ContentStream contentStream,
@@ -101,9 +103,11 @@ public interface CmisService extends Rep
      * @param objectId
      *            the identifier for the object
      * @param allVersions
-     *            <em>(optional)</em> If <code>true</code> then delete all
-     *            versions of the document, otherwise delete only the document
-     *            object specified (default is <code>true</code>)
+     *            <em>(optional)</em> If {@code true} then delete all versions
+     *            of the document, otherwise delete only the document object
+     *            specified (default is {@code true})
+     * @param extension
+     *            extension data
      */
     void deleteObjectOrCancelCheckOut(String repositoryId, String objectId, Boolean allVersions,
             ExtensionsData extension);
@@ -124,12 +128,13 @@ public interface CmisService extends Rep
      * @param aclPropagation
      *            <em>(optional)</em> specifies how ACEs should be handled
      *            (default is {@link AclPropagation#REPOSITORYDETERMINED})
+     * @return new ACL
      */
     Acl applyAcl(String repositoryId, String objectId, Acl aces, AclPropagation aclPropagation);
 
     /**
-     * Returns the {@link ObjectInfo} of the given object id or
-     * <code>null</code> if no object info exists.
+     * Returns the {@link ObjectInfo} of the given object id or {@code null} if
+     * no object info exists.
      * 
      * Only AtomPub requests will require object infos.
      * 
@@ -137,6 +142,7 @@ public interface CmisService extends Rep
      *            the identifier for the repository
      * @param objectId
      *            the identifier for the object
+     * @return the object info
      */
     ObjectInfo getObjectInfo(String repositoryId, String objectId);
 

Modified: chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/server/TempStoreOutputStream.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/server/TempStoreOutputStream.java?rev=1746713&r1=1746712&r2=1746713&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/server/TempStoreOutputStream.java (original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/server/TempStoreOutputStream.java Fri Jun  3 13:01:57 2016
@@ -74,6 +74,11 @@ public abstract class TempStoreOutputStr
      * 
      * Implementations should clean up all attached resources when this stream
      * is closed.
+     * 
+     * @return the input stream
+     * 
+     * @throws IOException
+     *             if the input stream could not be created
      */
     public abstract InputStream getInputStream() throws IOException;
 

Modified: chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/AclService.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/AclService.java?rev=1746713&r1=1746712&r2=1746713&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/AclService.java (original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/AclService.java Fri Jun  3 13:01:57 2016
@@ -43,7 +43,9 @@ public interface AclService {
      *            the identifier for the object
      * @param onlyBasicPermissions
      *            <em>(optional)</em> an indicator if only basic permissions
-     *            should be returned (default is <code>true</code>)
+     *            should be returned (default is {@code true})
+     * @param extension
+     *            extension data
      * @return the ACL of the object
      */
     Acl getAcl(String repositoryId, String objectId, Boolean onlyBasicPermissions, ExtensionsData extension);
@@ -62,6 +64,8 @@ public interface AclService {
      * @param aclPropagation
      *            <em>(optional)</em> specifies how ACEs should be handled
      *            (default is {@link AclPropagation#REPOSITORYDETERMINED})
+     * @param extension
+     *            extension data
      * @return the ACL of the object
      */
     Acl applyAcl(String repositoryId, String objectId, Acl addAces, Acl removeAces, AclPropagation aclPropagation,

Modified: chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/DiscoveryService.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/DiscoveryService.java?rev=1746713&r1=1746712&r2=1746713&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/DiscoveryService.java (original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/DiscoveryService.java Fri Jun  3 13:01:57 2016
@@ -38,6 +38,14 @@ public interface DiscoveryService {
 
     /**
      * Executes a CMIS query statement against the contents of the repository.
+     * 
+     * @param repositoryId
+     *            the identifier for the repository
+     * @param statement
+     *            the query statement
+     * @param extension
+     *            extension data
+     * @return the query result
      */
     ObjectList query(String repositoryId, String statement, Boolean searchAllVersions, Boolean includeAllowableActions,
             IncludeRelationships includeRelationships, String renditionFilter, BigInteger maxItems,
@@ -45,6 +53,12 @@ public interface DiscoveryService {
 
     /**
      * Gets a list of content changes.
+     * 
+     * @param repositoryId
+     *            the identifier for the repository
+     * @param extension
+     *            extension data
+     * @return the list of changes
      */
     ObjectList getContentChanges(String repositoryId, Holder<String> changeLogToken, Boolean includeProperties,
             String filter, Boolean includePolicyIds, Boolean includeAcl, BigInteger maxItems, ExtensionsData extension);

Modified: chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/ExtendedRepositoryService.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/ExtendedRepositoryService.java?rev=1746713&r1=1746712&r2=1746713&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/ExtendedRepositoryService.java (original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/ExtendedRepositoryService.java Fri Jun  3 13:01:57 2016
@@ -39,9 +39,12 @@ public interface ExtendedRepositoryServi
      *            the identifier for the repository
      * @param typeId
      *            typeId of an object type specified in the repository
+     * @param extension
+     *            extension data
      * @param useCache
      *            specifies whether the type definition should be looked up in
      *            the type definition cache first or not
+     * @return the type definition
      */
     TypeDefinition getTypeDefinition(String repositoryId, String typeId, ExtensionsData extension, boolean useCache);
 }

Modified: chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/MultiFilingService.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/MultiFilingService.java?rev=1746713&r1=1746712&r2=1746713&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/MultiFilingService.java (original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/MultiFilingService.java Fri Jun  3 13:01:57 2016
@@ -34,12 +34,33 @@ public interface MultiFilingService {
 
     /**
      * Adds an existing fileable non-folder object to a folder.
+     * 
+     * @param repositoryId
+     *            the identifier for the repository
+     * @param objectId
+     *            the object to add
+     * @param folderId
+     *            the folder
+     * @param allVersions
+     *            a flag that indicates if all versions of a document should be
+     *            added to the folder or just this single version
+     * @param extension
+     *            extension data
      */
     void addObjectToFolder(String repositoryId, String objectId, String folderId, Boolean allVersions,
             ExtensionsData extension);
 
     /**
      * Removes an existing fileable non-folder object from a folder.
+     * 
+     * @param repositoryId
+     *            the identifier for the repository
+     * @param objectId
+     *            the object to remove
+     * @param folderId
+     *            the folder
+     * @param extension
+     *            extension data
      */
     void removeObjectFromFolder(String repositoryId, String objectId, String folderId, ExtensionsData extension);
 }

Modified: chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/NavigationService.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/NavigationService.java?rev=1746713&r1=1746712&r2=1746713&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/NavigationService.java (original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/NavigationService.java Fri Jun  3 13:01:57 2016
@@ -58,9 +58,9 @@ public interface NavigationService {
      *            followed by the ascending modifier "ASC" or the descending
      *            modifier "DESC" (default is repository specific)
      * @param includeAllowableActions
-     *            <em>(optional)</em> if <code>true</code>, then the repository
-     *            must return the available actions for each object in the
-     *            result set (default is <code>false</code>)
+     *            <em>(optional)</em> if {@code true}, then the repository must
+     *            return the available actions for each object in the result set
+     *            (default is {@code false})
      * @param includeRelationships
      *            <em>(optional)</em> indicates what relationships in which the
      *            objects participate must be returned (default is
@@ -68,11 +68,11 @@ public interface NavigationService {
      * @param renditionFilter
      *            <em>(optional)</em> indicates what set of renditions the
      *            repository must return whose kind matches this filter (default
-     *            is <code>"cmis:none"</code>)
+     *            is {@code "cmis:none"})
      * @param includePathSegment
-     *            <em>(optional)</em> if <code>true</code>, returns a path
-     *            segment for each child object for use in constructing that
-     *            object's path (default is <code>false</code>)
+     *            <em>(optional)</em> if {@code true}, returns a path segment
+     *            for each child object for use in constructing that object's
+     *            path (default is {@code false})
      * @param maxItems
      *            <em>(optional)</em> the maximum number of items to return in a
      *            response (default is repository specific)
@@ -80,6 +80,9 @@ public interface NavigationService {
      *            <em>(optional)</em> number of potential results that the
      *            repository MUST skip/page over before returning any results
      *            (default is 0)
+     * @param extension
+     *            extension data
+     * @return the list of children
      */
     ObjectInFolderList getChildren(String repositoryId, String folderId, String filter, String orderBy,
             Boolean includeAllowableActions, IncludeRelationships includeRelationships, String renditionFilter,
@@ -101,9 +104,9 @@ public interface NavigationService {
      *            defines which properties must be returned by the repository
      *            (default is repository specific)
      * @param includeAllowableActions
-     *            <em>(optional)</em> if <code>true</code>, then the repository
-     *            must return the available actions for each object in the
-     *            result set (default is <code>false</code>)
+     *            <em>(optional)</em> if {@code true}, then the repository must
+     *            return the available actions for each object in the result set
+     *            (default is {@code false})
      * @param includeRelationships
      *            <em>(optional)</em> indicates what relationships in which the
      *            objects participate must be returned (default is
@@ -111,11 +114,14 @@ public interface NavigationService {
      * @param renditionFilter
      *            <em>(optional)</em> indicates what set of renditions the
      *            repository must return whose kind matches this filter (default
-     *            is <code>"cmis:none"</code>)
+     *            is {@code "cmis:none"})
      * @param includePathSegment
-     *            <em>(optional)</em> if <code>true</code>, returns a path
-     *            segment for each child object for use in constructing that
-     *            object's path (default is <code>false</code>)
+     *            <em>(optional)</em> if {@code true}, returns a path segment
+     *            for each child object for use in constructing that object's
+     *            path (default is {@code false})
+     * @param extension
+     *            extension data
+     * @return the tree of descendants
      **/
     List<ObjectInFolderContainer> getDescendants(String repositoryId, String folderId, BigInteger depth, String filter,
             Boolean includeAllowableActions, IncludeRelationships includeRelationships, String renditionFilter,
@@ -137,9 +143,9 @@ public interface NavigationService {
      *            defines which properties must be returned by the repository
      *            (default is repository specific)
      * @param includeAllowableActions
-     *            <em>(optional)</em> if <code>true</code>, then the repository
-     *            must return the available actions for each object in the
-     *            result set (default is <code>false</code>)
+     *            <em>(optional)</em> if {@code true}, then the repository must
+     *            return the available actions for each object in the result set
+     *            (default is {@code false})
      * @param includeRelationships
      *            <em>(optional)</em> indicates what relationships in which the
      *            objects participate must be returned (default is
@@ -147,11 +153,14 @@ public interface NavigationService {
      * @param renditionFilter
      *            <em>(optional)</em> indicates what set of renditions the
      *            repository must return whose kind matches this filter (default
-     *            is <code>"cmis:none"</code>)
+     *            is {@code "cmis:none"})
      * @param includePathSegment
-     *            <em>(optional)</em> if <code>true</code>, returns a path
-     *            segment for each child object for use in constructing that
-     *            object's path (default is <code>false</code>)
+     *            <em>(optional)</em> if {@code true}, returns a path segment
+     *            for each child object for use in constructing that object's
+     *            path (default is {@code false})
+     * @param extension
+     *            extension data
+     * @return the folder tree
      **/
     List<ObjectInFolderContainer> getFolderTree(String repositoryId, String folderId, BigInteger depth, String filter,
             Boolean includeAllowableActions, IncludeRelationships includeRelationships, String renditionFilter,
@@ -169,9 +178,9 @@ public interface NavigationService {
      *            defines which properties must be returned by the repository
      *            (default is repository specific)
      * @param includeAllowableActions
-     *            <em>(optional)</em> if <code>true</code>, then the repository
-     *            must return the available actions for each object in the
-     *            result set (default is <code>false</code>)
+     *            <em>(optional)</em> if {@code true}, then the repository must
+     *            return the available actions for each object in the result set
+     *            (default is {@code false})
      * @param includeRelationships
      *            <em>(optional)</em> indicates what relationships in which the
      *            objects participate must be returned (default is
@@ -179,11 +188,14 @@ public interface NavigationService {
      * @param renditionFilter
      *            <em>(optional)</em> indicates what set of renditions the
      *            repository must return whose kind matches this filter (default
-     *            is <code>"cmis:none"</code>)
+     *            is {@code "cmis:none"})
      * @param includeRelativePathSegment
-     *            <em>(optional)</em> if <code>true</code>, returns a relative
-     *            path segment for each parent object for use in constructing
-     *            that object's path (default is <code>false</code>)
+     *            <em>(optional)</em> if {@code true}, returns a relative path
+     *            segment for each parent object for use in constructing that
+     *            object's path (default is {@code false})
+     * @param extension
+     *            extension data
+     * @return the list of parents
      */
     List<ObjectParentData> getObjectParents(String repositoryId, String objectId, String filter,
             Boolean includeAllowableActions, IncludeRelationships includeRelationships, String renditionFilter,
@@ -200,6 +212,9 @@ public interface NavigationService {
      *            <em>(optional)</em> a comma-separated list of query names that
      *            defines which properties must be returned by the repository
      *            (default is repository specific)
+     * @param extension
+     *            extension data
+     * @return the folder parent
      */
     ObjectData getFolderParent(String repositoryId, String folderId, String filter, ExtensionsData extension);
 
@@ -221,9 +236,9 @@ public interface NavigationService {
      *            followed by the ascending modifier "ASC" or the descending
      *            modifier "DESC" (default is repository specific)
      * @param includeAllowableActions
-     *            <em>(optional)</em> if <code>true</code>, then the repository
-     *            must return the available actions for each object in the
-     *            result set (default is <code>false</code>)
+     *            <em>(optional)</em> if {@code true}, then the repository must
+     *            return the available actions for each object in the result set
+     *            (default is {@code false})
      * @param includeRelationships
      *            <em>(optional)</em> indicates what relationships in which the
      *            objects participate must be returned (default is
@@ -231,7 +246,7 @@ public interface NavigationService {
      * @param renditionFilter
      *            <em>(optional)</em> indicates what set of renditions the
      *            repository must return whose kind matches this filter (default
-     *            is <code>"cmis:none"</code>)
+     *            is {@code "cmis:none"})
      * @param maxItems
      *            <em>(optional)</em> the maximum number of items to return in a
      *            response (default is repository specific)
@@ -239,6 +254,9 @@ public interface NavigationService {
      *            <em>(optional)</em> number of potential results that the
      *            repository MUST skip/page over before returning any results
      *            (default is 0)
+     * @param extension
+     *            extension data
+     * @return the list of checked out documents
      */
     ObjectList getCheckedOutDocs(String repositoryId, String folderId, String filter, String orderBy,
             Boolean includeAllowableActions, IncludeRelationships includeRelationships, String renditionFilter,

Modified: chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/ObjectService.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/ObjectService.java?rev=1746713&r1=1746712&r2=1746713&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/ObjectService.java (original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/ObjectService.java Fri Jun  3 13:01:57 2016
@@ -75,13 +75,16 @@ public interface ObjectService {
      * @param addAces
      *            <em>(optional)</em> a list of ACEs that must be added to the
      *            newly created document object, either using the ACL from
-     *            <code>folderId</code> if specified, or being applied if no
-     *            <code>folderId</code> is specified
+     *            {@code folderId} if specified, or being applied if no
+     *            {@code folderId} is specified
      * @param removeAces
      *            <em>(optional)</em> a list of ACEs that must be removed from
      *            the newly created document object, either using the ACL from
-     *            <code>folderId</code> if specified, or being ignored if no
-     *            <code>folderId</code> is specified
+     *            {@code folderId} if specified, or being ignored if no
+     *            {@code folderId} is specified
+     * @param extension
+     *            extension data
+     * @return the ID of the newly created document
      */
     String createDocument(String repositoryId, Properties properties, String folderId, ContentStream contentStream,
             VersioningState versioningState, List<String> policies, Acl addAces, Acl removeAces,
@@ -112,13 +115,16 @@ public interface ObjectService {
      * @param addAces
      *            <em>(optional)</em> a list of ACEs that must be added to the
      *            newly created document object, either using the ACL from
-     *            <code>folderId</code> if specified, or being applied if no
-     *            <code>folderId</code> is specified
+     *            {@code folderId} if specified, or being applied if no
+     *            {@code folderId} is specified
      * @param removeAces
      *            <em>(optional)</em> a list of ACEs that must be removed from
      *            the newly created document object, either using the ACL from
-     *            <code>folderId</code> if specified, or being ignored if no
-     *            <code>folderId</code> is specified
+     *            {@code folderId} if specified, or being ignored if no
+     *            {@code folderId} is specified
+     * @param extension
+     *            extension data
+     * @return the ID of the newly created document
      */
     String createDocumentFromSource(String repositoryId, String sourceId, Properties properties, String folderId,
             VersioningState versioningState, List<String> policies, Acl addAces, Acl removeAces,
@@ -141,13 +147,16 @@ public interface ObjectService {
      * @param addAces
      *            <em>(optional)</em> a list of ACEs that must be added to the
      *            newly created folder object, either using the ACL from
-     *            <code>folderId</code> if specified, or being applied if no
-     *            <code>folderId</code> is specified
+     *            {@code folderId} if specified, or being applied if no
+     *            {@code folderId} is specified
      * @param removeAces
      *            <em>(optional)</em> a list of ACEs that must be removed from
      *            the newly created folder object, either using the ACL from
-     *            <code>folderId</code> if specified, or being ignored if no
-     *            <code>folderId</code> is specified
+     *            {@code folderId} if specified, or being ignored if no
+     *            {@code folderId} is specified
+     * @param extension
+     *            extension data
+     * @return the ID of the newly created folder
      */
     String createFolder(String repositoryId, Properties properties, String folderId, List<String> policies,
             Acl addAces, Acl removeAces, ExtensionsData extension);
@@ -167,13 +176,16 @@ public interface ObjectService {
      * @param addAces
      *            <em>(optional)</em> a list of ACEs that must be added to the
      *            newly created relationship object, either using the ACL from
-     *            <code>folderId</code> if specified, or being applied if no
-     *            <code>folderId</code> is specified
+     *            {@code folderId} if specified, or being applied if no
+     *            {@code folderId} is specified
      * @param removeAces
      *            <em>(optional)</em> a list of ACEs that must be removed from
      *            the newly created relationship object, either using the ACL
-     *            from <code>folderId</code> if specified, or being ignored if
-     *            no <code>folderId</code> is specified
+     *            from {@code folderId} if specified, or being ignored if no
+     *            {@code folderId} is specified
+     * @param extension
+     *            extension data
+     * @return the ID of the newly created relationship
      */
     String createRelationship(String repositoryId, Properties properties, List<String> policies, Acl addAces,
             Acl removeAces, ExtensionsData extension);
@@ -197,13 +209,16 @@ public interface ObjectService {
      * @param addAces
      *            <em>(optional)</em> a list of ACEs that must be added to the
      *            newly created policy object, either using the ACL from
-     *            <code>folderId</code> if specified, or being applied if no
-     *            <code>folderId</code> is specified
+     *            {@code folderId} if specified, or being applied if no
+     *            {@code folderId} is specified
      * @param removeAces
      *            <em>(optional)</em> a list of ACEs that must be removed from
      *            the newly created policy object, either using the ACL from
-     *            <code>folderId</code> if specified, or being ignored if no
-     *            <code>folderId</code> is specified
+     *            {@code folderId} if specified, or being ignored if no
+     *            {@code folderId} is specified
+     * @param extension
+     *            extension data
+     * @return the ID of the newly created policy
      */
     String createPolicy(String repositoryId, Properties properties, String folderId, List<String> policies,
             Acl addAces, Acl removeAces, ExtensionsData extension);
@@ -227,13 +242,16 @@ public interface ObjectService {
      * @param addAces
      *            <em>(optional)</em> a list of ACEs that must be added to the
      *            newly created policy object, either using the ACL from
-     *            <code>folderId</code> if specified, or being applied if no
-     *            <code>folderId</code> is specified
+     *            {@code folderId} if specified, or being applied if no
+     *            {@code folderId} is specified
      * @param removeAces
      *            <em>(optional)</em> a list of ACEs that must be removed from
      *            the newly created policy object, either using the ACL from
-     *            <code>folderId</code> if specified, or being ignored if no
-     *            <code>folderId</code> is specified
+     *            {@code folderId} if specified, or being ignored if no
+     *            {@code folderId} is specified
+     * @param extension
+     *            extension data
+     * @return the ID of the newly created item
      */
     String createItem(String repositoryId, Properties properties, String folderId, List<String> policies, Acl addAces,
             Acl removeAces, ExtensionsData extension);
@@ -245,6 +263,9 @@ public interface ObjectService {
      *            the identifier for the repository
      * @param objectId
      *            the identifier for the object
+     * @param extension
+     *            extension data
+     * @return the allowable actions
      */
     AllowableActions getAllowableActions(String repositoryId, String objectId, ExtensionsData extension);
 
@@ -260,9 +281,9 @@ public interface ObjectService {
      *            defines which properties must be returned by the repository
      *            (default is repository specific)
      * @param includeAllowableActions
-     *            <em>(optional)</em> if <code>true</code>, then the repository
-     *            must return the allowable actions for the object (default is
-     *            <code>false</code>)
+     *            <em>(optional)</em> if {@code true}, then the repository must
+     *            return the allowable actions for the object (default is
+     *            {@code false})
      * @param includeRelationships
      *            <em>(optional)</em> indicates what relationships in which the
      *            object participates must be returned (default is
@@ -272,13 +293,15 @@ public interface ObjectService {
      *            repository must return whose kind matches this filter (default
      *            is <code>"cmis:none"</code>)
      * @param includePolicyIds
-     *            <em>(optional)</em> if <code>true</code>, then the repository
-     *            must return the policy ids for the object (default is
-     *            <code>false</code>)
+     *            <em>(optional)</em> if {@code true}, then the repository must
+     *            return the policy ids for the object (default is {@code false}
+     *            )
      * @param includeAcl
-     *            <em>(optional)</em> if <code>true</code>, then the repository
-     *            must return the ACL for the object (default is
-     *            <code>false</code>)
+     *            <em>(optional)</em> if {@code true}, then the repository must
+     *            return the ACL for the object (default is {@code false})
+     * @param extension
+     *            extension data
+     * @return the object
      */
     ObjectData getObject(String repositoryId, String objectId, String filter, Boolean includeAllowableActions,
             IncludeRelationships includeRelationships, String renditionFilter, Boolean includePolicyIds,
@@ -295,6 +318,9 @@ public interface ObjectService {
      *            <em>(optional)</em> a comma-separated list of query names that
      *            defines which properties must be returned by the repository
      *            (default is repository specific)
+     * @param extension
+     *            extension data
+     * @return the object properties
      */
     Properties getProperties(String repositoryId, String objectId, String filter, ExtensionsData extension);
 
@@ -317,6 +343,9 @@ public interface ObjectService {
      *            <em>(optional)</em> number of potential results that the
      *            repository must skip/page over before returning any results
      *            (default is 0)
+     * @param extension
+     *            extension data
+     * @return the list of renditions
      */
     List<RenditionData> getRenditions(String repositoryId, String objectId, String renditionFilter,
             BigInteger maxItems, BigInteger skipCount, ExtensionsData extension);
@@ -333,9 +362,9 @@ public interface ObjectService {
      *            defines which properties must be returned by the repository
      *            (default is repository specific)
      * @param includeAllowableActions
-     *            <em>(optional)</em> if <code>true</code>, then the repository
-     *            must return the allowable actions for the object (default is
-     *            <code>false</code>)
+     *            <em>(optional)</em> if {@code true}, then the repository must
+     *            return the allowable actions for the object (default is
+     *            {@code false})
      * @param includeRelationships
      *            <em>(optional)</em> indicates what relationships in which the
      *            object participates must be returned (default is
@@ -345,13 +374,15 @@ public interface ObjectService {
      *            repository must return whose kind matches this filter (default
      *            is <code>"cmis:none"</code>)
      * @param includePolicyIds
-     *            <em>(optional)</em> if <code>true</code>, then the repository
-     *            must return the policy ids for the object (default is
-     *            <code>false</code>)
+     *            <em>(optional)</em> if {@code true}, then the repository must
+     *            return the policy ids for the object (default is {@code false}
+     *            )
      * @param includeAcl
-     *            <em>(optional)</em> if <code>true</code>, then the repository
-     *            must return the ACL for the object (default is
-     *            <code>false</code>)
+     *            <em>(optional)</em> if {@code true}, then the repository must
+     *            return the ACL for the object (default is {@code false})
+     * @param extension
+     *            extension data
+     * @return the object
      */
     ObjectData getObjectByPath(String repositoryId, String path, String filter, Boolean includeAllowableActions,
             IncludeRelationships includeRelationships, String renditionFilter, Boolean includePolicyIds,
@@ -366,6 +397,9 @@ public interface ObjectService {
      *            the identifier for the repository
      * @param objectId
      *            the identifier for the object
+     * @param extension
+     *            extension data
+     * @return the content stream
      */
     ContentStream getContentStream(String repositoryId, String objectId, String streamId, BigInteger offset,
             BigInteger length, ExtensionsData extension);
@@ -381,9 +415,11 @@ public interface ObjectService {
      * @param changeToken
      *            <em>(optional)</em> the last change token of this object that
      *            the client received. The repository might return a new change
-     *            token (default is <code>null</code>)
+     *            token (default is {@code null})
      * @param properties
      *            the updated property values that must be applied to the object
+     * @param extension
+     *            extension data
      */
     void updateProperties(String repositoryId, Holder<String> objectId, Holder<String> changeToken,
             Properties properties, ExtensionsData extension);
@@ -401,6 +437,9 @@ public interface ObjectService {
      *            the secondary types to apply
      * @param removeSecondaryTypeIds
      *            the secondary types to remove
+     * @param extension
+     *            extension data
+     * @return the list of updated objects with their change tokens
      */
     List<BulkUpdateObjectIdAndChangeToken> bulkUpdateProperties(String repositoryId,
             List<BulkUpdateObjectIdAndChangeToken> objectIdsAndChangeTokens, Properties properties,
@@ -418,6 +457,8 @@ public interface ObjectService {
      *            the identifier for the target folder
      * @param sourceFolderId
      *            the identifier for the source folder
+     * @param extension
+     *            extension data
      */
     void moveObject(String repositoryId, Holder<String> objectId, String targetFolderId, String sourceFolderId,
             ExtensionsData extension);
@@ -430,9 +471,11 @@ public interface ObjectService {
      * @param objectId
      *            the identifier for the object
      * @param allVersions
-     *            <em>(optional)</em> If <code>true</code> then delete all
-     *            versions of the document, otherwise delete only the document
-     *            object specified (default is <code>true</code>)
+     *            <em>(optional)</em> If {@code true} then delete all versions
+     *            of the document, otherwise delete only the document object
+     *            specified (default is {@code true})
+     * @param extension
+     *            extension data
      */
     void deleteObject(String repositoryId, String objectId, Boolean allVersions, ExtensionsData extension);
 
@@ -445,18 +488,22 @@ public interface ObjectService {
      * @param folderId
      *            the identifier for the folder
      * @param allVersions
-     *            <em>(optional)</em> If <code>true</code> then delete all
-     *            versions of the document, otherwise delete only the document
-     *            object specified (default is <code>true</code>)
+     *            <em>(optional)</em> If {@code true} then delete all versions
+     *            of the document, otherwise delete only the document object
+     *            specified (default is {@code true})
      * @param unfileObjects
      *            <em>(optional)</em> defines how the repository must process
      *            file-able child- or descendant-objects (default is
      *            {@link UnfileObject#DELETE})
      * @param continueOnFailure
-     *            <em>(optional)</em> If <code>true</code>, then the repository
+     *            <em>(optional)</em> If {@code true}, then the repository
      *            should continue attempting to perform this operation even if
      *            deletion of a child- or descendant-object in the specified
-     *            folder cannot be deleted (default is <code>false</code>)
+     *            folder cannot be deleted (default is {@code false})
+     * @param extension
+     *            extension data
+     * @return a (possibly incomplete) collection of object IDs of objects that
+     *         couldn't be deleted
      */
     FailedToDeleteData deleteTree(String repositoryId, String folderId, Boolean allVersions,
             UnfileObject unfileObjects, Boolean continueOnFailure, ExtensionsData extension);
@@ -473,18 +520,20 @@ public interface ObjectService {
      *            the identifier for the object. The repository might return a
      *            different/new object id
      * @param overwriteFlag
-     *            <em>(optional)</em> If <code>true</code>, then the repository
-     *            must replace the existing content stream for the object (if
-     *            any) with the input content stream. If If <code>false</code>,
-     *            then the repository must only set the input content stream for
-     *            the object if the object currently does not have a content
-     *            stream (default is <code>true</code>)
+     *            <em>(optional)</em> If {@code true}, then the repository must
+     *            replace the existing content stream for the object (if any)
+     *            with the input content stream. If If {@code false}, then the
+     *            repository must only set the input content stream for the
+     *            object if the object currently does not have a content stream
+     *            (default is {@code true})
      * @param changeToken
      *            <em>(optional)</em> the last change token of this object that
      *            the client received. The repository might return a new change
-     *            token (default is <code>null</code>)
+     *            token (default is {@code null})
      * @param contentStream
      *            the content stream
+     * @param extension
+     *            extension data
      */
     void setContentStream(String repositoryId, Holder<String> objectId, Boolean overwriteFlag,
             Holder<String> changeToken, ContentStream contentStream, ExtensionsData extension);
@@ -500,7 +549,9 @@ public interface ObjectService {
      * @param changeToken
      *            <em>(optional)</em> the last change token of this object that
      *            the client received. The repository might return a new change
-     *            token (default is <code>null</code>)
+     *            token (default is {@code null})
+     * @param extension
+     *            extension data
      */
     void deleteContentStream(String repositoryId, Holder<String> objectId, Holder<String> changeToken,
             ExtensionsData extension);
@@ -516,11 +567,13 @@ public interface ObjectService {
      * @param changeToken
      *            <em>(optional)</em> the last change token of this object that
      *            the client received. The repository might return a new change
-     *            token (default is <code>null</code>)
+     *            token (default is {@code null})
      * @param contentStream
      *            the content stream to append
      * @param isLastChunk
      *            indicates if this content stream is the last chunk
+     * @param extension
+     *            extension data
      */
     void appendContentStream(String repositoryId, Holder<String> objectId, Holder<String> changeToken,
             ContentStream contentStream, boolean isLastChunk, ExtensionsData extension);

Modified: chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/PolicyService.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/PolicyService.java?rev=1746713&r1=1746712&r2=1746713&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/PolicyService.java (original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/PolicyService.java Fri Jun  3 13:01:57 2016
@@ -37,16 +37,47 @@ public interface PolicyService {
 
     /**
      * Applies a specified policy to an object.
+     * 
+     * @param repositoryId
+     *            the identifier for the repository
+     * @param policyId
+     *            the policy to add
+     * @param objectId
+     *            the object
+     * @param extension
+     *            extension data
      */
     void applyPolicy(String repositoryId, String policyId, String objectId, ExtensionsData extension);
 
     /**
      * Removes a specified policy from an object.
+     * 
+     * @param repositoryId
+     *            the identifier for the repository
+     * @param policyId
+     *            the policy to remove
+     * @param objectId
+     *            the object
+     * @param extension
+     *            extension data
      */
     void removePolicy(String repositoryId, String policyId, String objectId, ExtensionsData extension);
 
     /**
      * Gets the list of policies currently applied to the specified object.
+     * 
+     * @param repositoryId
+     *            the identifier for the repository
+     * @param objectId
+     *            the object
+     * @param filter
+     *            <em>(optional)</em> a comma-separated list of query names that
+     *            defines which properties must be returned by the repository
+     *            (default is repository specific)
+     * @param extension
+     *            extension data
+     * 
+     * @return the list of applied policies
      */
     List<ObjectData> getAppliedPolicies(String repositoryId, String objectId, String filter, ExtensionsData extension);
 }

Modified: chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/RelationshipService.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/RelationshipService.java?rev=1746713&r1=1746712&r2=1746713&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/RelationshipService.java (original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/RelationshipService.java Fri Jun  3 13:01:57 2016
@@ -39,6 +39,14 @@ public interface RelationshipService {
     /**
      * Gets all or a subset of relationships associated with an independent
      * object.
+     * 
+     * @param repositoryId
+     *            the identifier for the repository
+     * @param objectId
+     *            the object
+     * @param extension
+     *            extension data
+     * @return the list of relationships
      */
     ObjectList getObjectRelationships(String repositoryId, String objectId, Boolean includeSubRelationshipTypes,
             RelationshipDirection relationshipDirection, String typeId, String filter, Boolean includeAllowableActions,

Modified: chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/RepositoryService.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/RepositoryService.java?rev=1746713&r1=1746712&r2=1746713&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/RepositoryService.java (original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/RepositoryService.java Fri Jun  3 13:01:57 2016
@@ -45,6 +45,10 @@ public interface RepositoryService {
      * 
      * In contrast to the CMIS specification this method returns repository
      * infos not only repository IDs.
+     * 
+     * @param extension
+     *            extension data
+     * @return the list of repositories
      */
     List<RepositoryInfo> getRepositoryInfos(ExtensionsData extension);
 
@@ -54,6 +58,9 @@ public interface RepositoryService {
      * 
      * @param repositoryId
      *            the identifier for the repository
+     * @param extension
+     *            extension data
+     * @return the repository info
      */
     RepositoryInfo getRepositoryInfo(String repositoryId, ExtensionsData extension);
 
@@ -78,6 +85,9 @@ public interface RepositoryService {
      *            <em>(optional)</em> number of potential results that the
      *            repository MUST skip/page over before returning any results
      *            (default is 0)
+     * @param extension
+     *            extension data
+     * @return the list of type children
      */
     TypeDefinitionList getTypeChildren(String repositoryId, String typeId, Boolean includePropertyDefinitions,
             BigInteger maxItems, BigInteger skipCount, ExtensionsData extension);
@@ -100,6 +110,9 @@ public interface RepositoryService {
      *            <em>(optional)</em> if <code>true</code> the repository MUST
      *            return the property definitions for each object type returned
      *            (default is <code>false</code>)
+     * @param extension
+     *            extension data
+     * @return the tree of type descendants
      */
     List<TypeDefinitionContainer> getTypeDescendants(String repositoryId, String typeId, BigInteger depth,
             Boolean includePropertyDefinitions, ExtensionsData extension);
@@ -111,6 +124,9 @@ public interface RepositoryService {
      *            the identifier for the repository
      * @param typeId
      *            typeId of an object type specified in the repository
+     * @param extension
+     *            extension data
+     * @return the type definition
      */
     TypeDefinition getTypeDefinition(String repositoryId, String typeId, ExtensionsData extension);
 
@@ -121,6 +137,8 @@ public interface RepositoryService {
      *            the identifier for the repository
      * @param type
      *            the type definition
+     * @param extension
+     *            extension data
      * @return the newly created type
      */
     TypeDefinition createType(String repositoryId, TypeDefinition type, ExtensionsData extension);
@@ -132,6 +150,8 @@ public interface RepositoryService {
      *            the identifier for the repository
      * @param type
      *            the type definition
+     * @param extension
+     *            extension data
      * @return the updated type
      */
     TypeDefinition updateType(String repositoryId, TypeDefinition type, ExtensionsData extension);
@@ -143,6 +163,8 @@ public interface RepositoryService {
      *            the identifier for the repository
      * @param typeId
      *            typeId of an object type specified in the repository
+     * @param extension
+     *            extension data
      */
     void deleteType(String repositoryId, String typeId, ExtensionsData extension);
 }

Modified: chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/VersioningService.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/VersioningService.java?rev=1746713&r1=1746712&r2=1746713&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/VersioningService.java (original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/spi/VersioningService.java Fri Jun  3 13:01:57 2016
@@ -46,6 +46,8 @@ public interface VersioningService {
      * @param objectId
      *            input: the identifier for the document that should be checked
      *            out, output: the identifier for the newly created PWC
+     * @param extension
+     *            extension data
      * @param contentCopied
      *            output: indicator if the content of the original document has
      *            been copied to the PWC
@@ -59,14 +61,16 @@ public interface VersioningService {
      *            the identifier for the repository
      * @param objectId
      *            the identifier for the PWC
+     * @param extension
+     *            extension data
      */
     void cancelCheckOut(String repositoryId, String objectId, ExtensionsData extension);
 
     /**
      * Checks-in the private working copy (PWC) document.
      * 
-     * The stream in <code>contentStream</code> is consumed but not closed by
-     * this method.
+     * The stream in {@code contentStream} is consumed but not closed by this
+     * method.
      * 
      * @param repositoryId
      *            the identifier for the repository
@@ -75,7 +79,7 @@ public interface VersioningService {
      *            the newly created version document
      * @param major
      *            indicator if the new version should become a major (
-     *            <code>true</code>) or minor (<code>false</code>) version
+     *            {@code true}) or minor ({@code false}) version
      * @param properties
      *            <em>(optional)</em> the property values that must be applied
      *            to the newly created document object
@@ -93,6 +97,8 @@ public interface VersioningService {
      * @param removeAces
      *            <em>(optional)</em> a list of ACEs that must be removed from
      *            the newly created document object
+     * @param extension
+     *            extension data
      */
     void checkIn(String repositoryId, Holder<String> objectId, Boolean major, Properties properties,
             ContentStream contentStream, String checkinComment, List<String> policies, Acl addAces, Acl removeAces,
@@ -103,6 +109,17 @@ public interface VersioningService {
      * 
      * @param repositoryId
      *            the identifier for the repository
+     * @param objectId
+     *            the identifier for the object
+     * @param versionSeriesId
+     *            the version series ID
+     * @param filter
+     *            <em>(optional)</em> a comma-separated list of query names that
+     *            defines which properties must be returned by the repository
+     *            (default is repository specific)
+     * @param extension
+     *            extension data
+     * @return the document object
      */
     ObjectData getObjectOfLatestVersion(String repositoryId, String objectId, String versionSeriesId, Boolean major,
             String filter, Boolean includeAllowableActions, IncludeRelationships includeRelationships,
@@ -114,6 +131,17 @@ public interface VersioningService {
      * 
      * @param repositoryId
      *            the identifier for the repository
+     * @param objectId
+     *            the identifier for the object
+     * @param versionSeriesId
+     *            the version series ID
+     * @param filter
+     *            <em>(optional)</em> a comma-separated list of query names that
+     *            defines which properties must be returned by the repository
+     *            (default is repository specific)
+     * @param extension
+     *            extension data
+     * @return the document properties
      */
     Properties getPropertiesOfLatestVersion(String repositoryId, String objectId, String versionSeriesId,
             Boolean major, String filter, ExtensionsData extension);
@@ -122,8 +150,8 @@ public interface VersioningService {
      * Returns the list of all document objects in the specified version series,
      * sorted by the property "cmis:creationDate" descending.
      * 
-     * Either the <code>objectId</code> or the <code>versionSeriesId</code>
-     * parameter must be set.
+     * Either the {@code objectId} or the {@code versionSeriesId} parameter must
+     * be set.
      * 
      * @param repositoryId
      *            the identifier for the repository
@@ -136,10 +164,11 @@ public interface VersioningService {
      *            defines which properties must be returned by the repository
      *            (default is repository specific)
      * @param includeAllowableActions
-     *            <em>(optional)</em> if <code>true</code>, then the repository
-     *            must return the allowable actions for the objects (default is
-     *            <code>false</code>)
-     * 
+     *            <em>(optional)</em> if {@code true}, then the repository must
+     *            return the allowable actions for the objects (default is
+     *            {@code false})
+     * @param extension
+     *            extension data
      * @return the complete version history of the version series
      */
     List<ObjectData> getAllVersions(String repositoryId, String objectId, String versionSeriesId, String filter,

Modified: chemistry/opencmis/trunk/chemistry-opencmis-server/chemistry-opencmis-server-bindings/src/main/java/org/apache/chemistry/opencmis/server/impl/endpoints/SimpleCmisEndpointsDocumentServlet.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-server/chemistry-opencmis-server-bindings/src/main/java/org/apache/chemistry/opencmis/server/impl/endpoints/SimpleCmisEndpointsDocumentServlet.java?rev=1746713&r1=1746712&r2=1746713&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-server/chemistry-opencmis-server-bindings/src/main/java/org/apache/chemistry/opencmis/server/impl/endpoints/SimpleCmisEndpointsDocumentServlet.java (original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-server/chemistry-opencmis-server-bindings/src/main/java/org/apache/chemistry/opencmis/server/impl/endpoints/SimpleCmisEndpointsDocumentServlet.java Fri Jun  3 13:01:57 2016
@@ -57,13 +57,16 @@ public class SimpleCmisEndpointsDocument
         }
 
         // load template from file
+        InputStream stream = null;
         try {
-            InputStream stream = config.getServletContext().getResourceAsStream(template);
+            stream = config.getServletContext().getResourceAsStream(template);
             if (stream != null) {
                 endpointsDocument = IOUtils.readAllLines(stream);
             }
         } catch (Exception e) {
             LOG.error("Could not read CMIS Endpoints Document template from {}!", template, e);
+        } finally {
+            IOUtils.closeQuietly(stream);
         }
     }
 

Modified: chemistry/opencmis/trunk/chemistry-opencmis-server/chemistry-opencmis-server-support/src/main/java/org/apache/chemistry/opencmis/server/support/query/PredicateWalkerBase.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-server/chemistry-opencmis-server-support/src/main/java/org/apache/chemistry/opencmis/server/support/query/PredicateWalkerBase.java?rev=1746713&r1=1746712&r2=1746713&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-server/chemistry-opencmis-server-support/src/main/java/org/apache/chemistry/opencmis/server/support/query/PredicateWalkerBase.java (original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-server/chemistry-opencmis-server-support/src/main/java/org/apache/chemistry/opencmis/server/support/query/PredicateWalkerBase.java Fri Jun  3 13:01:57 2016
@@ -23,10 +23,10 @@ import org.antlr.runtime.tree.Tree;
 /**
  * Base interface for a tree walker of a WHERE clause.
  * <p>
- * COntains only a single method used by the ANTLR query walker to
- * initiate a tree walk for evaluating the query. You can inherit from
- * this interface if you want to have your own walking mechanism
- * <p>
+ * COntains only a single method used by the ANTLR query walker to initiate a
+ * tree walk for evaluating the query. You can inherit from this interface if
+ * you want to have your own walking mechanism
+ * </p>
  */
 public interface PredicateWalkerBase {