jackrabbit-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From tri...@apache.org
Subject svn commit: r1765204 [4/6] - in /jackrabbit/commons/filevault/trunk: vault-cli/src/main/java/org/apache/jackrabbit/vault/cli/ vault-cli/src/main/java/org/apache/jackrabbit/vault/cli/extended/ vault-cli/src/main/java/org/apache/jackrabbit/vault/util/con...
Date Mon, 17 Oct 2016 03:07:26 GMT
Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/JcrPackageManager.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/JcrPackageManager.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/JcrPackageManager.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/JcrPackageManager.java Mon Oct 17 03:07:22 2016
@@ -39,7 +39,7 @@ public interface JcrPackageManager exten
      * Opens a package with the given package id.
      *
      * @param id the package id.
-     * @return the new package or <code>null</code> it the package does not exist or is not valid.
+     * @return the new package or {@code null} it the package does not exist or is not valid.
      * @throws RepositoryException if an error occurs
      * @since 2.3.22
      */
@@ -49,34 +49,34 @@ public interface JcrPackageManager exten
      * Opens a package that is based on the given node.
      *
      * @param node the underlying node
-     * @return the new package or <code>null</code> it the package is not
+     * @return the new package or {@code null} it the package is not
      *         valid.
      * @throws RepositoryException if an error occurs
      */
     JcrPackage open(Node node) throws RepositoryException;
 
     /**
-     * Opens a package that is based on the given node. If <code>allowInvalid</code>
-     * is <code>true</code> also invalid packages are returned, but only if the
+     * Opens a package that is based on the given node. If {@code allowInvalid}
+     * is {@code true} also invalid packages are returned, but only if the
      * node is file like (i.e. is nt:hierarchyNode and has a
      * jcr:content/jcr:data property).
      *
      * @param node the underlying node
-     * @param allowInvalid if <code>true</code> invalid packages are openend, too.
-     * @return the new package or <code>null</code> it the package is not
-     *         valid unless <code>allowInvalid</code> is <code>true</code>.
+     * @param allowInvalid if {@code true} invalid packages are openend, too.
+     * @return the new package or {@code null} it the package is not
+     *         valid unless {@code allowInvalid} is {@code true}.
      * @throws RepositoryException if an error occurs
      */
     JcrPackage open(Node node, boolean allowInvalid) throws RepositoryException;
 
     /**
      * Finds the id of the package that matches the given dependency best.
-     * If <code>onlyInstalled</code> is <code>true</code> only installed packages are searched.
+     * If {@code onlyInstalled} is {@code true} only installed packages are searched.
      *
      * @param dependency dependency information
-     * @param onlyInstalled if <code>true</code> only installed packages are searched.
+     * @param onlyInstalled if {@code true} only installed packages are searched.
      *
-     * @return the id of the matching package or <code>null</code> if not found.
+     * @return the id of the matching package or {@code null} if not found.
      * @throws RepositoryException if an error occurs
      *
      * @since 2.4.6
@@ -88,14 +88,14 @@ public interface JcrPackageManager exten
      * the package. if the package does not provide such a path, the nameHint
      * is respected and the package is placed below the package root.
      * if the package already exists at that path it is not installed and
-     * <code>null</code> is returned unless <code>replace</code> is <code>true</code>.
+     * {@code null} is returned unless {@code replace} is {@code true}.
      *
      * @param file package file to upload
      * @param isTmpFile indicates if the given file is a temp file and can be
      *        deleted when the package is closed
-     * @param replace if <code>true</code> existing packages are replaced.
+     * @param replace if {@code true} existing packages are replaced.
      * @param nameHint hint for the name if package does not provide one
-     * @return the new jcr package or <code>null</code> if not installed
+     * @return the new jcr package or {@code null} if not installed
      * @throws RepositoryException if an error occurrs
      * @throws IOException if an I/O error occurrs
      */
@@ -107,15 +107,15 @@ public interface JcrPackageManager exten
      * the package. if the package does not provide such a path, the nameHint
      * is respected and the package is placed below the package root.
      * if the package already exists at that path it is not uploaded a
-     * {@link ItemExistsException} is thrown unless <code>replace</code> is
-     * <code>true</code>.
+     * {@link ItemExistsException} is thrown unless {@code replace} is
+     * {@code true}.
      *
      * @param file package file to upload
      * @param isTmpFile indicates if the given file is a temp file and can be
      *        deleted when the package is closed
-     * @param replace if <code>true</code> existing packages are replaced.
+     * @param replace if {@code true} existing packages are replaced.
      * @param nameHint hint for the name if package does not provide one
-     * @param strict if <code>true</code> import is more strict in regards to errors
+     * @param strict if {@code true} import is more strict in regards to errors
      * @return the new jcr package
      * @throws RepositoryException if an error occurrs
      * @throws IOException if an I/O error occurrs
@@ -127,12 +127,12 @@ public interface JcrPackageManager exten
      * Uploads a package. The location is chosen from the installation path of
      * the package. if the package does not provide such a path an IOException is thrown.
      * if the package already exists at that path it is not uploaded a
-     * {@link ItemExistsException} is thrown unless <code>replace</code> is
-     * <code>true</code>.
+     * {@link ItemExistsException} is thrown unless {@code replace} is
+     * {@code true}.
      *
      * @param in input stream that provides the content of the package. note that after this method returns,
      *        the input stream is closed in any case.
-     * @param replace if <code>true</code> existing packages are replaced.
+     * @param replace if {@code true} existing packages are replaced.
      * @return the new jcr package
      * @throws RepositoryException if an error occurrs
      * @throws IOException if an I/O error occurrs
@@ -143,13 +143,13 @@ public interface JcrPackageManager exten
      * Uploads a package. The location is chosen from the installation path of
      * the package. if the package does not provide such a path an IOException is thrown.
      * if the package already exists at that path it is not uploaded a
-     * {@link ItemExistsException} is thrown unless <code>replace</code> is
-     * <code>true</code>.
+     * {@link ItemExistsException} is thrown unless {@code replace} is
+     * {@code true}.
      *
      * @param in input stream that provides the content of the package. note that after this method returns,
      *        the input stream is closed in any case.
-     * @param replace if <code>true</code> existing packages are replaced.
-     * @param strict if <code>true</code> import is more strict in regards to errors
+     * @param replace if {@code true} existing packages are replaced.
+     * @param strict if {@code true} import is more strict in regards to errors
      * @return the new jcr package
      * @throws RepositoryException if an error occurrs
      * @throws IOException if an I/O error occurrs
@@ -186,7 +186,7 @@ public interface JcrPackageManager exten
      *
      * @param group group of the new package
      * @param name name of the new package
-     * @param version version of the new package; can be <code>null</code>
+     * @param version version of the new package; can be {@code null}
      * @return a new jcr package
      * @throws RepositoryException if a repository error occurrs
      * @throws IOException if an I/O exception occurs
@@ -205,12 +205,12 @@ public interface JcrPackageManager exten
 
     /**
      * Renames the given package with a new group id and name. Please note that
-     * the package is moved and the internal 'path' is adjusted in the deinition,
+     * the package is moved and the internal 'path' is adjusted in the definition,
      * but the package is not rewrapped.
      *
      * @param pack the package to rename
-     * @param groupId the new group id or <code>null</code>
-     * @param name the new name or <code>null</code>
+     * @param groupId the new group id or {@code null}
+     * @param name the new name or {@code null}
      * @return the renamed package
      * @throws RepositoryException if an error occurs
      * @throws PackageException if the package is not unwrapped.
@@ -226,9 +226,9 @@ public interface JcrPackageManager exten
      * the definition, but the package is not rewrapped.
      *
      * @param pack the package to rename
-     * @param groupId the new group id or <code>null</code>
-     * @param name the new name or <code>null</code>
-     * @param version the new version or <code>null</code>
+     * @param groupId the new group id or {@code null}
+     * @param name the new name or {@code null}
+     * @param version the new version or {@code null}
      * @return the renamed package
      * @throws RepositoryException if an error occurs
      * @throws PackageException if the package is not unwrapped.
@@ -295,8 +295,8 @@ public interface JcrPackageManager exten
 
     /**
      * Returns the configured package root node.
-     * @param noCreate do not create missing root if <code>true</code>
-     * @return the package root node or <code>null</code> if not present and noCreate is <code>true</code>.
+     * @param noCreate do not create missing root if {@code true}
+     * @return the package root node or {@code null} if not present and noCreate is {@code true}.
      * @throws RepositoryException if an error occurs
      */
     Node getPackageRoot(boolean noCreate) throws RepositoryException;
@@ -322,11 +322,11 @@ public interface JcrPackageManager exten
 
     /**
      * Returns the list of all packages installed below the package root that
-     * match the given group. if <code>group</code> is <code>null</code> all
+     * match the given group. if {@code group} is {@code null} all
      * packages are returned.
      *
      * @param group the group filter
-     * @param built if <code>true</code> only packages with size > 0 are listed
+     * @param built if {@code true} only packages with size &gt; 0 are listed
      * @return the list of packages
      * @throws RepositoryException if an error occurs
      */

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/PackageException.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/PackageException.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/PackageException.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/PackageException.java Mon Oct 17 03:07:22 2016
@@ -18,7 +18,7 @@
 package org.apache.jackrabbit.vault.packaging;
 
 /**
- * <code>PackageException</code>...
+ * {@code PackageException}...
  */
 public class PackageException extends Exception {
 

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/PackageId.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/PackageId.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/PackageId.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/PackageId.java Mon Oct 17 03:07:22 2016
@@ -21,7 +21,7 @@ import org.apache.jackrabbit.util.XMLCha
 import org.apache.jackrabbit.vault.util.Text;
 
 /**
- * <code>PackageId</code> provides the basic metrics for identifying a package.
+ * {@code PackageId} provides the basic metrics for identifying a package.
  * A package id consists of a group id, a name and a version.
  * the group is a relative path, eg: "company/project/subgroup", the name and the version
  * can be of any format.
@@ -205,7 +205,7 @@ public class PackageId implements Compar
 
     /**
      * Returns a package id from a id string. if the given id is null or an
-     * empty string, <code>null</code> is returned.
+     * empty string, {@code null} is returned.
      * @param str the string
      * @return the package id
      */
@@ -254,7 +254,7 @@ public class PackageId implements Compar
     /**
      * Checks if this definition was constructed from a path, rather from a
      * group and name.
-     * @return <code>true</code> if constructed from path.
+     * @return {@code true} if constructed from path.
      *
      * @since 2.2.26
      */
@@ -310,7 +310,7 @@ public class PackageId implements Compar
 
     /**
      * Returns a download name in the form
-     * <code>name [ "-" version ] ".zip"</code>
+     * {@code name [ "-" version ] ".zip"}
      * @return the download name
      * @since 2.0
      */
@@ -324,7 +324,7 @@ public class PackageId implements Compar
     }
 
     /**
-     * Returns the version of this package or <code>null</code> if n/a.
+     * Returns the version of this package or {@code null} if n/a.
      * @return the version of this package
      */
     public Version getVersion() {
@@ -437,7 +437,7 @@ public class PackageId implements Compar
     private static final int STATE_URI = 5;
 
     /**
-     * Parses the <code>jcrName</code> (either qualified or expanded) and validates it.
+     * Parses the {@code jcrName} (either qualified or expanded) and validates it.
      * @throws java.lang.IllegalArgumentException if the name is not valid
      */
     private static void assertValidJcrName(String jcrName) throws IllegalArgumentException {

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/PackageManager.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/PackageManager.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/PackageManager.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/PackageManager.java Mon Oct 17 03:07:22 2016
@@ -80,7 +80,7 @@ public interface PackageManager {
     /**
      * Opens the given file and creates a package
      * @param file the file
-     * @param strict if <code>true</code> the import is more strict in respect to errors.
+     * @param strict if {@code true} the import is more strict in respect to errors.
      * @return the package
      * @throws IOException if an error occurrs
      */
@@ -88,7 +88,7 @@ public interface PackageManager {
 
     /**
      * Assembles a package using the given meta information and file to
-     * store to. if file is <code>null</code> a temp file is generated.
+     * store to. if file is {@code null} a temp file is generated.
      *
      * @param s the repository session
      * @param opts export options
@@ -118,7 +118,7 @@ public interface PackageManager {
 
     /**
      * Re-wraps a package using the given meta information and file to
-     * store to. if file is <code>null</code> a temp file is generated.
+     * store to. if file is {@code null} a temp file is generated.
      *
      * @param opts export options
      * @param src source package

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/PackageProperties.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/PackageProperties.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/PackageProperties.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/PackageProperties.java Mon Oct 17 03:07:22 2016
@@ -141,26 +141,26 @@ public interface PackageProperties {
     String PREFIX_INSTALL_HOOK = "installhook.";
 
     /**
-     * Returns the id of this package or <code>null</code> if the id can't
+     * Returns the id of this package or {@code null} if the id can't
      * be determined.
      * @return the id of this package.
      */
     PackageId getId();
 
     /**
-     * Returns the last modification date or <code>null</code> if n/a.
-     * @return last modification date or <code>null</code>
+     * Returns the last modification date or {@code null} if n/a.
+     * @return last modification date or {@code null}
      */
     Calendar getLastModified();
 
     /**
-     * Returns the user that last modified the package or <code>null</code> if n/a.
-     * @return the user or <code>null</code>
+     * Returns the user that last modified the package or {@code null} if n/a.
+     * @return the user or {@code null}
      */
     String getLastModifiedBy();
 
     /**
-     * Returns the date when this package was built or <code>null</code> if n/a.
+     * Returns the date when this package was built or {@code null} if n/a.
      * @return the creation date
      */
     Calendar getCreated();
@@ -172,7 +172,7 @@ public interface PackageProperties {
     String getCreatedBy();
 
     /**
-     * Returns the date when this package was wrapped or <code>null</code> if n/a.
+     * Returns the date when this package was wrapped or {@code null} if n/a.
      * @return the wrapped date
      * @since 2.2.22
      */
@@ -186,15 +186,15 @@ public interface PackageProperties {
     String getLastWrappedBy();
 
     /**
-     * Returns a description of this package or <code>null</code> if n/a
+     * Returns a description of this package or {@code null} if n/a
      * @return a description
      */
     String getDescription();
 
     /**
-     * Returns <code>true</code> if this package can only be extracted by a
+     * Returns {@code true} if this package can only be extracted by a
      * admin session.
-     * @return <code>true</code> if this package requires an admin session for extraction.
+     * @return {@code true} if this package requires an admin session for extraction.
      */
     boolean requiresRoot();
 

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/Packaging.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/Packaging.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/Packaging.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/Packaging.java Mon Oct 17 03:07:22 2016
@@ -48,8 +48,8 @@ public interface Packaging {
     JcrPackageDefinition createPackageDefinition(Node defNode);
 
     /**
-     * Opens a package that is based on the given node. If <code>allowInvalid</code>
-     * is <code>true</code> also invalid packages are returned, but only if the
+     * Opens a package that is based on the given node. If {@code allowInvalid}
+     * is {@code true} also invalid packages are returned, but only if the
      * node is file like (i.e. is nt:hierarchyNode and has a
      * jcr:content/jcr:data property).
      *
@@ -57,9 +57,9 @@ public interface Packaging {
      * which does not create a package manager instance.
      *
      * @param node the underlying node
-     * @param allowInvalid if <code>true</code> invalid packages are openend, too.
-     * @return the new package or <code>null</code> it the package is not
-     *         valid unless <code>allowInvalid</code> is <code>true</code>.
+     * @param allowInvalid if {@code true} invalid packages are opened, too.
+     * @return the new package or {@code null} it the package is not
+     *         valid unless {@code allowInvalid} is {@code true}.
      * @throws javax.jcr.RepositoryException if an error occurs
      * 
      * @since 2.3.0

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/PackagingService.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/PackagingService.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/PackagingService.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/PackagingService.java Mon Oct 17 03:07:22 2016
@@ -62,8 +62,8 @@ public class PackagingService {
     }
 
     /**
-     * Opens a package that is based on the given node. If <code>allowInvalid</code>
-     * is <code>true</code> also invalid packages are returned, but only if the
+     * Opens a package that is based on the given node. If {@code allowInvalid}
+     * is {@code true} also invalid packages are returned, but only if the
      * node is file like (i.e. is nt:hierarchyNode and has a
      * jcr:content/jcr:data property).
      *
@@ -71,9 +71,9 @@ public class PackagingService {
      * which does not create a package manager instance.
      *
      * @param node the underlying node
-     * @param allowInvalid if <code>true</code> invalid packages are openend, too.
-     * @return the new package or <code>null</code> it the package is not
-     *         valid unless <code>allowInvalid</code> is <code>true</code>.
+     * @param allowInvalid if {@code true} invalid packages are openend, too.
+     * @return the new package or {@code null} it the package is not
+     *         valid unless {@code allowInvalid} is {@code true}.
      * @throws RepositoryException if an error occurs
      * 
      * @since 2.3.0

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/SubPackageHandling.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/SubPackageHandling.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/SubPackageHandling.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/SubPackageHandling.java Mon Oct 17 03:07:22 2016
@@ -27,16 +27,16 @@ import org.apache.jackrabbit.util.Text;
  * configuration consists of a list of {@link org.apache.jackrabbit.vault.packaging.SubPackageHandling.Entry}s that
  * match against a given {@link org.apache.jackrabbit.vault.packaging.PackageId}. The version of the package id is
  * ignored.
- * <p/>
+ * <p>
  * The sub package handling can be specified in the package properties as a string of the following format:
- * <xmp>
+ * <pre>
  *     subPackageHandling := instruction { "," instruction };
  *     instruction := packageIdFilter { ";" option }
  *     packageIdFilter := packageNameFilter | groupNameFilter ":" packageNameFilter;
  *     groupNameFilter := "*" | groupName;
  *     packageNameFilter := "*" | packageName;
  *     option := "install" | "extract" | "add" | "ignore";
- * </xmp>
+ * </pre>
  *
  *  Note that 'ignore' is currently not really supported as sub packages are part of the normal package content and
  *  behaves the same as 'add'. Future implementations will transport the sub packages outside of the normal package

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/VaultPackage.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/VaultPackage.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/VaultPackage.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/VaultPackage.java Mon Oct 17 03:07:22 2016
@@ -31,13 +31,13 @@ import org.apache.jackrabbit.vault.fs.io
 /**
  * Defines a vault package. A vault package is a binary assembled representation
  * of a vault export.
- * <p/>
+ * <p>
  * Note that VaultPackage currently extends from PackageProperties to keep the interface backwards compatible.
  */
 public interface VaultPackage extends PackageProperties {
 
     /**
-     * Returns the id of this package or <code>null</code> if the id can't
+     * Returns the id of this package or {@code null} if the id can't
      * be determined.
      * @return the id of this package.
      */
@@ -52,19 +52,19 @@ public interface VaultPackage extends Pa
 
     /**
      * Checks if this package is valid.
-     * @return <code>true</code> if this package is valid.
+     * @return {@code true} if this package is valid.
      */
     boolean isValid();
 
     /**
      * Checks if this package is closed.
-     * @return <code>true</code> if this package is closed.
+     * @return {@code true} if this package is closed.
      */
     boolean isClosed();
 
     /**
      * Returns the meta inf that was either loaded or specified during build.
-     * @return the meta inf or <code>null</code>.
+     * @return the meta inf or {@code null}.
      */
     MetaInf getMetaInf();
 
@@ -86,7 +86,7 @@ public interface VaultPackage extends Pa
     void extract(Session session, ImportOptions opts) throws RepositoryException, PackageException;
 
     /**
-     * Returns the underlying file or <code>null</code> if not available.
+     * Returns the underlying file or {@code null} if not available.
      * @return the file
      * @since 2.0
      */
@@ -99,7 +99,7 @@ public interface VaultPackage extends Pa
 
     /**
      * Returns the underlying package archive
-     * @return the archive or <code>null</code> if already closed
+     * @return the archive or {@code null} if already closed
      */
     Archive getArchive();
 }
\ No newline at end of file

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/Version.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/Version.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/Version.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/Version.java Mon Oct 17 03:07:22 2016
@@ -47,7 +47,7 @@ public class Version implements Comparab
     /**
      * Creates a new version from the given string.
      * @param str the version string.
-     * @return the new version or {@link Version#EMPTY} if <code>str</code> is an empty string.
+     * @return the new version or {@link Version#EMPTY} if {@code str} is an empty string.
      * @since 2.2.4
      */
     public static Version create(String str) {
@@ -61,7 +61,7 @@ public class Version implements Comparab
     /**
      * Creates a new version from version segments
      * @param segments version segments
-     * @return the new version or {@link Version#EMPTY} if <code>segments</code> is empty.
+     * @return the new version or {@link Version#EMPTY} if {@code segments} is empty.
      * @since 2.2.4
      */
     public static Version create(String[] segments) {
@@ -114,15 +114,17 @@ public class Version implements Comparab
      * Compares this version to the given one, segment by segment with a special
      * "SNAPSHOT" handling.
      *
+     * <pre>
      * Examples:
-     * "1" < "2"
-     * "1.0" < "2"
-     * "2.0.1" < "2.1"
-     * "2.1" < "2.1.1"
-     * "2.9" < "2.11"
-     * "2.1" > "2.1-SNAPSHOT"
-     * "2.1" > "2.1-R1234556"
-     * "2.1-R12345" < "2.1-SNAPSHOT"
+     * "1" &lt; "2"
+     * "1.0" &lt; "2"
+     * "2.0.1" &lt; "2.1"
+     * "2.1" &lt; "2.1.1"
+     * "2.9" &lt; "2.11"
+     * "2.1" &lt; "2.1-SNAPSHOT"
+     * "2.1" &gt; "2.1-R1234556"
+     * "2.1-R12345" &lt; "2.1-SNAPSHOT"
+     * </pre>
      *
      * @param o the other version
      * @return  a negative integer, zero, or a positive integer as this version
@@ -176,15 +178,17 @@ public class Version implements Comparab
      * Compares this version to the given one, segment by segment without any special
      * "SNAPSHOT" handling.
      *
+     * <pre>
      * Examples:
-     * "1" < "2"
-     * "1.0" < "2"
-     * "2.0.1" < "2.1"
-     * "2.1" < "2.1.1"
-     * "2.9" < "2.11"
-     * "2.1" < "2.1-SNAPSHOT"
-     * "2.1" < "2.1-R1234556"
-     * "2.1-R12345" < "2.1-SNAPSHOT"
+     * "1" &lt; "2"
+     * "1.0" &lt; "2"
+     * "2.0.1" &lt; "2.1"
+     * "2.1" &lt; "2.1.1"
+     * "2.9" &lt; "2.11"
+     * "2.1" &lt; "2.1-SNAPSHOT"
+     * "2.1" &lt; "2.1-R1234556"
+     * "2.1-R12345" &lt; "2.1-SNAPSHOT"
+     * </pre>
      *
      * @param o the other version
      * @return  a negative integer, zero, or a positive integer as this version

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/VersionRange.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/VersionRange.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/VersionRange.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/VersionRange.java Mon Oct 17 03:07:22 2016
@@ -55,9 +55,9 @@ public class VersionRange {
 
     /**
      * Creates a new version range.
-     * @param low lower bound or <code>null</code>
+     * @param low lower bound or {@code null}
      * @param lowIncl specifies if lower bound is inclusive
-     * @param high upper bound or <code>null</code>
+     * @param high upper bound or {@code null}
      * @param highIncl specifies if upper bound is inclusive
      * @throws IllegalArgumentException if bounds are not valid
      */
@@ -114,15 +114,15 @@ public class VersionRange {
 
     /**
      * Returns the lower bound
-     * @return the lower bound or <code>null</code>
+     * @return the lower bound or {@code null}
      */
     public Version getLow() {
         return low;
     }
 
     /**
-     * Returns <code>true</code> if the lower bound is inclusive
-     * @return <code>true</code> if the lower bound is inclusive
+     * Returns {@code true} if the lower bound is inclusive
+     * @return {@code true} if the lower bound is inclusive
      */
     public boolean isLowInclusive() {
         return lowIncl;
@@ -130,15 +130,15 @@ public class VersionRange {
 
     /**
      * Returns the upper bound
-     * @return the upper bound or <code>null</code>
+     * @return the upper bound or {@code null}
      */
     public Version getHigh() {
         return high;
     }
 
     /**
-     * Returns <code>true</code> if the upper bound is inclusive
-     * @return <code>true</code> if the upper bound is inclusive
+     * Returns {@code true} if the upper bound is inclusive
+     * @return {@code true} if the upper bound is inclusive
      */
     public boolean isHighInclusive() {
         return highIncl;
@@ -163,7 +163,7 @@ public class VersionRange {
     /**
      * Checks if the given version is in this range.
      * @param v the version to check
-     * @return <code>true</code> if the given version is in this range.
+     * @return {@code true} if the given version is in this range.
      */
     public boolean isInRange(Version v) {
         if (low != null) {

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/AdminPermissionChecker.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/AdminPermissionChecker.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/AdminPermissionChecker.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/AdminPermissionChecker.java Mon Oct 17 03:07:22 2016
@@ -43,7 +43,7 @@ public class AdminPermissionChecker {
      *
      * @param session a JCR session
      * @return whether the passed session is an admin session
-     * @throws RepositoryException
+     * @throws RepositoryException If an error occurrs.
      */
     public static boolean hasAdministrativePermissions(Session session) throws RepositoryException {
         String userId = session.getUserID();

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/InstallContextImpl.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/InstallContextImpl.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/InstallContextImpl.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/InstallContextImpl.java Mon Oct 17 03:07:22 2016
@@ -28,7 +28,7 @@ import org.apache.jackrabbit.vault.packa
 import org.apache.jackrabbit.vault.packaging.VaultPackage;
 
 /**
- * <code>InstallContextImpl</code>...
+ * {@code InstallContextImpl}...
  */
 public class InstallContextImpl implements InstallContext {
 

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/JcrPackageDefinitionImpl.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/JcrPackageDefinitionImpl.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/JcrPackageDefinitionImpl.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/JcrPackageDefinitionImpl.java Mon Oct 17 03:07:22 2016
@@ -110,7 +110,7 @@ public class JcrPackageDefinitionImpl im
     /**
      * Writes the properties derived from the package id to the content
      * @param id the package id
-     * @param autoSave if <code>true</code> the changes are saved automatically.
+     * @param autoSave if {@code true} the changes are saved automatically.
      */
     public void setId(PackageId id, boolean autoSave) {
         set(PN_GROUP, id.getGroup(), false);
@@ -122,7 +122,7 @@ public class JcrPackageDefinitionImpl im
      * Returns the installation path. If the path is not defined in the definition,
      * the grand-parent of the underlying node is returned. if the path would end
      * with .zip or .jar, the extension is truncated.
-     * @return the installation path or <code>null</code> if it cannot be determined.
+     * @return the installation path or {@code null} if it cannot be determined.
      */
     private String getInstallationPath() {
         try {
@@ -242,7 +242,7 @@ public class JcrPackageDefinitionImpl im
      * package to this node.
      *
      * @param packArchive the archive of the package
-     * @param autoSave saves changed automatically if <code>true</code>
+     * @param autoSave saves changed automatically if {@code true}
      * @throws RepositoryException if an error occurs
      */
     private void extractDefinition(Archive packArchive, boolean autoSave)
@@ -377,7 +377,7 @@ public class JcrPackageDefinitionImpl im
     /**
      * Writes the given properties to the content.
      * @param props the properties
-     * @param autoSave saves the changes automatically if <code>true</code>
+     * @param autoSave saves the changes automatically if {@code true}
      */
     protected void writeProperties(Properties props, boolean autoSave) {
         try {
@@ -433,7 +433,7 @@ public class JcrPackageDefinitionImpl im
     /**
      * Internal method that converts a ISO date to a calendar.
      * @param iso the iso8601 formatted date
-     * @return the calendar or <code>null</code>
+     * @return the calendar or {@code null}
      */
     private static Calendar getDate(String iso) {
         if (iso == null) {
@@ -572,8 +572,8 @@ public class JcrPackageDefinitionImpl im
      * - updates the lastUnwrapped(by) properties
      * - clears the unwrapped property
      *
-     * @param now the date or <code>null</code>
-     * @param autoSave saves the changes automatically if <code>true</code>
+     * @param now the date or {@code null}
+     * @param autoSave saves the changes automatically if {@code true}
      */
     public void sealForAssembly(Calendar now, boolean autoSave) {
         try {
@@ -601,8 +601,8 @@ public class JcrPackageDefinitionImpl im
      * - updates the lastUnwrapped(by) properties
      * - clears the unwrapped property
      *
-     * @param now the date or <code>null</code>
-     * @param autoSave saves the changes automatically if <code>true</code>
+     * @param now the date or {@code null}
+     * @param autoSave saves the changes automatically if {@code true}
      */
     public void sealForRewrap(Calendar now, boolean autoSave) {
         try {
@@ -630,8 +630,8 @@ public class JcrPackageDefinitionImpl im
 
     /**
      * Touches the lastUnpacked (i.e. installed) properties.
-     * @param now the date or <code>null</code>
-     * @param autoSave saves the changes automatically if <code>true</code>
+     * @param now the date or {@code null}
+     * @param autoSave saves the changes automatically if {@code true}
      */
     public void touchLastUnpacked(Calendar now, boolean autoSave) {
         try {
@@ -648,7 +648,7 @@ public class JcrPackageDefinitionImpl im
 
     /**
      * Clears the last unpacked properties.
-     * @param autoSave saves the changes automatically if <code>true</code>
+     * @param autoSave saves the changes automatically if {@code true}
      */
     public void clearLastUnpacked(boolean autoSave) {
         try {
@@ -813,7 +813,7 @@ public class JcrPackageDefinitionImpl im
     /**
      * Writes the workspace filter to the definition
      * @param filter the filter
-     * @param save automatically save the changes if <code>true</code>
+     * @param save automatically save the changes if {@code true}
      * @throws RepositoryException if an error occurs
      */
     public void writeFilter(WorkspaceFilter filter, boolean save)
@@ -832,7 +832,7 @@ public class JcrPackageDefinitionImpl im
 
     /**
      * Returns the user id of the current session. if the userid provided by
-     * the session is <code>null</code>, "system" is returned.
+     * the session is {@code null}, "system" is returned.
      * @return the user id
      */
     private String getUserId() {

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/JcrPackageImpl.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/JcrPackageImpl.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/JcrPackageImpl.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/JcrPackageImpl.java Mon Oct 17 03:07:22 2016
@@ -189,7 +189,7 @@ public class JcrPackageImpl implements J
      * @param parent the parent node
      * @param pid the package id of the new package.
      * @param pack the underlying zip package or null.
-     * @param autoSave if <code>true</code> the changes are persisted immediately
+     * @param autoSave if {@code true} the changes are persisted immediately
      * @return the created jcr vault package.
      * @throws RepositoryException if an repository error occurs
      * @throws IOException if an I/O error occurs
@@ -333,8 +333,8 @@ public class JcrPackageImpl implements J
      * @param forceFileArchive if {@code true} a file archive is enforced
      * @return the package
      *
-     * @throws RepositoryException
-     * @throws IOException
+     * @throws RepositoryException If a repository error occurrs.
+     * @throws IOException if an i/o error occurrs.
      */
     protected VaultPackage getPackage(boolean forceFileArchive) throws RepositoryException, IOException {
         if (forceFileArchive && pack != null && !(pack.getArchive() instanceof ZipArchive)) {
@@ -398,8 +398,8 @@ public class JcrPackageImpl implements J
      * internally extracts the package.
      *
      * @param options the import options
-     * @param createSnapshot <code>true</code> if a snapshot should be created
-     * @param replaceSnapshot <code>true</code> if a snapshot should be replaced
+     * @param createSnapshot {@code true} if a snapshot should be created
+     * @param replaceSnapshot {@code true} if a snapshot should be replaced
      * @throws RepositoryException if a repository error occurs
      * @throws PackageException if a package error occurs
      * @throws IOException if an I/O error occurs
@@ -543,9 +543,9 @@ public class JcrPackageImpl implements J
     /**
      * Internally creates the snapshot
      * @param opts exports options when building the snapshot
-     * @param replace if <code>true</code> existing snapshot will be replaced
+     * @param replace if {@code true} existing snapshot will be replaced
      * @param acHandling user acHandling to use when snapshot is installed, i.e. package is uninstalled
-     * @return the package of the snapshot or <code>null</code>
+     * @return the package of the snapshot or {@code null}
      * @throws RepositoryException if an error occurrs.
      * @throws PackageException if an error occurrs.
      * @throws IOException if an error occurrs.

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/JcrPackageManagerImpl.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/JcrPackageManagerImpl.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/JcrPackageManagerImpl.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/JcrPackageManagerImpl.java Mon Oct 17 03:07:22 2016
@@ -60,7 +60,7 @@ import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
 /**
- * Extends the <code>PackageManager</code> by JCR specific methods
+ * Extends the {@code PackageManager} by JCR specific methods
  */
 public class JcrPackageManagerImpl extends PackageManagerImpl implements JcrPackageManager {
 
@@ -572,7 +572,7 @@ public class JcrPackageManagerImpl exten
     /**
      * yet another Convenience method to create intermediate nodes.
      * @param path path to create
-     * @param autoSave if <code>true</code> all changes are automatically persisted
+     * @param autoSave if {@code true} all changes are automatically persisted
      * @return the node
      * @throws RepositoryException if an error occurrs
      */
@@ -727,14 +727,14 @@ public class JcrPackageManagerImpl exten
     }
 
     /**
-     * internally adds the packages below <code>root</code> to the given list
+     * internally adds the packages below {@code root} to the given list
      * recursively.
      *
      * @param root root node
      * @param packages list for the packages
      * @param filter optional filter to filter out packages
-     * @param built if <code>true</code> only packages with size > 0 are returned
-     * @param shallow if <code>true</code> don't recurs
+     * @param built if {@code true} only packages with size > 0 are returned
+     * @param shallow if {@code true} don't recurs
      * @throws RepositoryException if an error occurs
      */
     private void listPackages(Node root, List<JcrPackage> packages,

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/JcrWorkspaceFilter.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/JcrWorkspaceFilter.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/JcrWorkspaceFilter.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/JcrWorkspaceFilter.java Mon Oct 17 03:07:22 2016
@@ -34,7 +34,7 @@ import org.apache.jackrabbit.vault.fs.co
 import org.apache.jackrabbit.vault.fs.filter.DefaultPathFilter;
 
 /**
- * <code>JcrWorkspaceFilter</code> implements serializations of a workspace
+ * {@code JcrWorkspaceFilter} implements serializations of a workspace
  * filter that is stored in the repository
  */
 public class JcrWorkspaceFilter  {

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/PackageManagerMBean.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/PackageManagerMBean.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/PackageManagerMBean.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/PackageManagerMBean.java Mon Oct 17 03:07:22 2016
@@ -19,7 +19,7 @@ package org.apache.jackrabbit.vault.pack
 import javax.management.openmbean.TabularData;
 
 /**
- * <code>PackageManagerMBean</code>...
+ * {@code PackageManagerMBean}...
  */
 public interface PackageManagerMBean {
 

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/PackageManagerMBeanImpl.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/PackageManagerMBeanImpl.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/PackageManagerMBeanImpl.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/PackageManagerMBeanImpl.java Mon Oct 17 03:07:22 2016
@@ -45,7 +45,7 @@ import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
 /**
- * <code>PackageManagerMBeanImpl</code> provide a MBean that lists all available packages as tabular data.
+ * {@code PackageManagerMBeanImpl} provide a MBean that lists all available packages as tabular data.
  */
 @Component()
 @Property(name = "jmx.objectname", value="org.apache.jackrabbit.vault.packaging:type=manager")

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/PackagingImpl.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/PackagingImpl.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/PackagingImpl.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/PackagingImpl.java Mon Oct 17 03:07:22 2016
@@ -30,7 +30,7 @@ import org.apache.jackrabbit.vault.packa
 import org.apache.jackrabbit.vault.util.JcrConstants;
 
 /**
- * <code>PackagingImpl</code>...
+ * {@code PackagingImpl}...
  */
 @Component(metatype = false, immediate = true)
 @Service(value = Packaging.class)

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/ZipVaultPackage.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/ZipVaultPackage.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/ZipVaultPackage.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/packaging/impl/ZipVaultPackage.java Mon Oct 17 03:07:22 2016
@@ -122,7 +122,7 @@ public class ZipVaultPackage extends Pac
 
     /**
      * Returns the file this package is based on.
-     * @return the file of this package or <code>null</code>.
+     * @return the file of this package or {@code null}.
      */
     public File getFile() {
         return (archive instanceof ZipArchive) ? ((ZipArchive) archive).getFile() : null;

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/BinaryCheckOutputStream.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/BinaryCheckOutputStream.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/BinaryCheckOutputStream.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/BinaryCheckOutputStream.java Mon Oct 17 03:07:22 2016
@@ -21,7 +21,7 @@ import java.io.IOException;
 import java.io.OutputStream;
 
 /**
- * <code>BinaryCheckOutputStream</code>...
+ * {@code BinaryCheckOutputStream}...
  */
 public class BinaryCheckOutputStream extends OutputStream {
 

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/CredentialsProvider.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/CredentialsProvider.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/CredentialsProvider.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/CredentialsProvider.java Mon Oct 17 03:07:22 2016
@@ -21,7 +21,7 @@ import javax.jcr.Credentials;
 import org.apache.jackrabbit.vault.fs.api.RepositoryAddress;
 
 /**
- * <code>CredentialsProvider</code>...
+ * {@code CredentialsProvider}...
  */
 public interface CredentialsProvider {
 

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/DefaultProgressListener.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/DefaultProgressListener.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/DefaultProgressListener.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/DefaultProgressListener.java Mon Oct 17 03:07:22 2016
@@ -22,7 +22,7 @@ import java.io.PrintWriter;
 import org.apache.jackrabbit.vault.fs.api.ProgressTrackerListener;
 
 /**
- * <code>DefaultProgressListener</code>...
+ * {@code DefaultProgressListener}...
 */
 public class DefaultProgressListener implements ProgressTrackerListener {
 

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/DocViewProperty.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/DocViewProperty.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/DocViewProperty.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/DocViewProperty.java Mon Oct 17 03:07:22 2016
@@ -41,7 +41,7 @@ import org.apache.jackrabbit.value.Value
  * It contains formatting and parsing methods for writing/reading enhanced
  * docview properties.
  *
- * <code>prop:= [ "{" type "}" ] ( value | "[" [ value { "," value } ] "]" )</code>
+ * {@code prop:= [ "{" type "}" ] ( value | "[" [ value { "," value } ] "]" )}
  */
 public class DocViewProperty {
 
@@ -71,7 +71,7 @@ public class DocViewProperty {
     /**
      * indicates a binary ref property
      */
-    public final boolean isRef;
+    public final boolean isReferenceProperty;
 
     /**
      * set of unambigous property names
@@ -88,20 +88,28 @@ public class DocViewProperty {
      * @param values values.
      * @param multi multiple flag
      * @param type type of the property
-     * @throws IllegalArgumentException if single value property and not
-     *         exactly 1 value is given.
+     * @throws IllegalArgumentException if single value property and not exactly 1 value is given.
      */
     public DocViewProperty(String name, String[] values, boolean multi, int type) {
         this(name, values, multi, type, false);
     }
 
-    public DocViewProperty(String name, String[] values, boolean multi, int type, boolean ref) {
+    /**
+     * Creates a new property.
+     * @param name name of the property
+     * @param values values.
+     * @param multi multiple flag
+     * @param type type of the property
+     * @param isRef {@code true} to indicated that this is a binary reference property
+     * @throws IllegalArgumentException if single value property and not exactly 1 value is given.
+     */
+    public DocViewProperty(String name, String[] values, boolean multi, int type, boolean isRef) {
         this.name = name;
         this.values = values;
         isMulti = multi;
         // validate type
         if (type == PropertyType.UNDEFINED) {
-            if (name.equals("jcr:primaryType") || name.equals("jcr:mixinTypes")) {
+            if ("jcr:primaryType".equals(name) || "jcr:mixinTypes".equals(name)) {
                 type = PropertyType.NAME;
             }
         }
@@ -109,7 +117,7 @@ public class DocViewProperty {
         if (!isMulti && values.length != 1) {
             throw new IllegalArgumentException("Single value property needs exactly 1 value.");
         }
-        this.isRef = ref;
+        this.isReferenceProperty = isRef;
     }
 
     /**
@@ -248,7 +256,8 @@ public class DocViewProperty {
     /**
      * Formats the given jcr property to the enhanced docview syntax.
      * @param prop the jcr property
-     * @param sort if <code>true</code> multivalue properties are sorted
+     * @param sort if {@code true} multivalue properties are sorted
+     * @param useBinaryReferences {@code true} to use binary references
      * @return the formatted string
      * @throws RepositoryException if a repository error occurs
      */
@@ -357,7 +366,7 @@ public class DocViewProperty {
      * Sets this property on the given node
      *
      * @param node the node
-     * @return <code>true</code> if the value was modified.
+     * @return {@code true} if the value was modified.
      * @throws RepositoryException if a repository error occurs
      */
     public boolean apply(Node node) throws RepositoryException {
@@ -399,7 +408,7 @@ public class DocViewProperty {
         } else {
             Value v = prop == null ? null : prop.getValue();
             if (type == PropertyType.BINARY) {
-                if (isRef) {
+                if (isReferenceProperty) {
                     ReferenceBinary ref = new SimpleReferenceBinary(values[0]);
                     Binary binary = node.getSession().getValueFactory().createValue(ref).getBinary();
                     if (v != null) {

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/FileInputSource.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/FileInputSource.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/FileInputSource.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/FileInputSource.java Mon Oct 17 03:07:22 2016
@@ -28,7 +28,7 @@ import org.apache.jackrabbit.vault.fs.ap
 /**
  * Implements a input source that is based on a {@link File}. The path of the
  * file is used as systemId.
- * <p/>
+ * <p>
  * Currently only {@link #getByteStream()} is implemented.
  *
  */
@@ -54,7 +54,7 @@ public class FileInputSource extends Vau
     }
 
     /**
-     * Sets the linefeed to use. If this is not <code>null</code> the output
+     * Sets the linefeed to use. If this is not {@code null} the output
      * stream of the file is wrapped by a {@link LineInputStream} with that
      * given line feed
      * @param lineSeparator the linefeed for text

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/HtmlProgressListener.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/HtmlProgressListener.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/HtmlProgressListener.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/HtmlProgressListener.java Mon Oct 17 03:07:22 2016
@@ -23,7 +23,7 @@ import java.io.Writer;
 import org.apache.jackrabbit.vault.fs.api.ProgressTrackerListener;
 
 /**
- * <code>HtmlProgressTrackerListener</code> implements a progress tracker listener that writes the progress in HTML.
+ * {@code HtmlProgressTrackerListener} implements a progress tracker listener that writes the progress in HTML.
  */
 public class HtmlProgressListener implements ProgressTrackerListener {
 

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/ItemNameComparator.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/ItemNameComparator.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/ItemNameComparator.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/ItemNameComparator.java Mon Oct 17 03:07:22 2016
@@ -23,7 +23,7 @@ import javax.jcr.Item;
 import javax.jcr.RepositoryException;
 
 /**
- * <code>ItemNameComparator</code>...
+ * {@code ItemNameComparator}...
  */
 public class ItemNameComparator implements Comparator<Item> {
 

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/MD5.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/MD5.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/MD5.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/MD5.java Mon Oct 17 03:07:22 2016
@@ -25,7 +25,7 @@ import java.security.MessageDigest;
 import java.security.NoSuchAlgorithmException;
 
 /**
- * <code>MD5</code>...
+ * {@code MD5}...
  */
 public class MD5 {
 

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/MimeTypes.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/MimeTypes.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/MimeTypes.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/MimeTypes.java Mon Oct 17 03:07:22 2016
@@ -22,7 +22,7 @@ import java.util.HashMap;
 import java.util.HashSet;
 
 /**
- * <code>MimeTypes</code> contains a mapping from extensions to mime types.
+ * {@code MimeTypes} contains a mapping from extensions to mime types.
  *
  */
 public class MimeTypes {
@@ -94,7 +94,7 @@ public class MimeTypes {
     /**
      * Retrieve the mimetype for the given extension or name
      * @param name the name
-     * @return the mimetype or <code>null</code>
+     * @return the mimetype or {@code null}
      */
     public static String getMimeType(String name) {
         return getMimeType(name, null);
@@ -104,7 +104,7 @@ public class MimeTypes {
      * Retrieve the mimetype for the given extension or name
      * @param name the name
      * @param defaultType type to return if no mapping is found.
-     * @return the mimetype or <code>null</code>
+     * @return the mimetype or {@code null}
      */
     public static String getMimeType(String name, String defaultType) {
         name = name.substring(name.lastIndexOf('.') + 1);
@@ -133,7 +133,7 @@ public class MimeTypes {
     /**
      * checks if the given mimetype denotes binary content
      * @param mimeType the mime type
-     * @return <code>true</code> if binary or if <code>mimeType</code> is <code>null</code>
+     * @return {@code true} if binary or if {@code mimeType} is {@code null}
      */
     public static boolean isBinary(String mimeType) {
         if (mimeType == null) {
@@ -150,7 +150,7 @@ public class MimeTypes {
      * Checks if the given mime type is mapped to the extension
      * @param mimeType the mime type
      * @param ext the extension
-     * @return <code>true</code> if the given mime type contains that extension
+     * @return {@code true} if the given mime type contains that extension
      */
     public static boolean hasExtension(String mimeType, String ext) {
         MimeType mt = byMimeType.get(mimeType);
@@ -210,8 +210,8 @@ public class MimeTypes {
         }
 
         /**
-         * Returns <code>true</code> if this is a binary mime type
-         * @return <code>true</code> if binary.
+         * Returns {@code true} if this is a binary mime type
+         * @return {@code true} if binary.
          *
          */
         public boolean isBinary() {

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/NodeNameComparator.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/NodeNameComparator.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/NodeNameComparator.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/NodeNameComparator.java Mon Oct 17 03:07:22 2016
@@ -23,7 +23,7 @@ import javax.jcr.Node;
 import javax.jcr.RepositoryException;
 
 /**
- * <code>ItemNameComparator</code>...
+ * {@code ItemNameComparator}...
  */
 public class NodeNameComparator implements Comparator<Node> {
 

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/PathComparator.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/PathComparator.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/PathComparator.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/PathComparator.java Mon Oct 17 03:07:22 2016
@@ -20,7 +20,7 @@ package org.apache.jackrabbit.vault.util
 import java.util.Comparator;
 
 /**
- * <code>PathComparator</code>...
+ * {@code PathComparator}...
  *
  */
 public class PathComparator implements Comparator<String> {
@@ -53,8 +53,10 @@ public class PathComparator implements C
      * Compared to the {@link String#compareTo(String)} it handles the '/'
      * differently giving it the highest priority so that:
      *
-     * "/a" < "/b"
-     * "/a1foo" < "/a/foo"
+     * <pre>
+     * "/a" &lt; "/b"
+     * "/a1foo" &lt; "/a/foo"
+     * </pre>
      */
     public int compare(String o1, String o2) {
         if (o1.equals(o2)) {

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/PathUtil.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/PathUtil.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/PathUtil.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/PathUtil.java Mon Oct 17 03:07:22 2016
@@ -23,14 +23,14 @@ import javax.jcr.Node;
 import javax.jcr.RepositoryException;
 
 /**
- * <code>PathUtil</code>...
+ * {@code PathUtil}...
  *
  */
 public class PathUtil {
 
     /**
      * make a canonical path. removes all /./ and /../ and multiple slashes.
-     * @param parent the parent path (can be <code>null</code>)
+     * @param parent the parent path (can be {@code null})
      * @param path the path to resolve
      * @return the canonicalized path
      */

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/PlatformNameFormat.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/PlatformNameFormat.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/PlatformNameFormat.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/PlatformNameFormat.java Mon Oct 17 03:07:22 2016
@@ -191,7 +191,7 @@ public class PlatformNameFormat {
     /**
      * Returns the repository path for the given platform one.
      * @param path the platform path
-     * @param respectDotDir if <code>true</code>, all ".dir" are removed.
+     * @param respectDotDir if {@code true}, all ".dir" are removed.
      * @return the repository path
      */
     public static String getRepositoryPath(String path, boolean respectDotDir) {

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/RepositoryCopier.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/RepositoryCopier.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/RepositoryCopier.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/RepositoryCopier.java Mon Oct 17 03:07:22 2016
@@ -530,13 +530,13 @@ public class RepositoryCopier {
         }
     }
     /**
-     * Checks if <code>src</code> node is newer than <code>dst</code> node.
+     * Checks if {@code src} node is newer than {@code dst} node.
      * this only applies if the nodes have either a "jcr:lastModified" or
      * "cq:lastModified" property.
      *
      * @param src source node
      * @param dst destination node
-     * @return <code>true</code> if src is newer than dst node or if the
+     * @return {@code true} if src is newer than dst node or if the
      *         nodes could not be compared
      */
     private boolean isNewer(Node src, Node dst) {

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/RepositoryProvider.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/RepositoryProvider.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/RepositoryProvider.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/RepositoryProvider.java Mon Oct 17 03:07:22 2016
@@ -35,7 +35,7 @@ import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
 /**
- * <code>RepositoryProvider</code>...
+ * {@code RepositoryProvider}...
  *
  */
 public class RepositoryProvider {

Modified: jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/TempFileInputStream.java
URL: http://svn.apache.org/viewvc/jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/TempFileInputStream.java?rev=1765204&r1=1765203&r2=1765204&view=diff
==============================================================================
--- jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/TempFileInputStream.java (original)
+++ jackrabbit/commons/filevault/trunk/vault-core/src/main/java/org/apache/jackrabbit/vault/util/TempFileInputStream.java Mon Oct 17 03:07:22 2016
@@ -24,7 +24,7 @@ import java.io.FileNotFoundException;
 import java.io.IOException;
 
 /**
- * <code>TempFileInputStream</code>...
+ * {@code TempFileInputStream}...
  */
 public class TempFileInputStream extends FileInputStream {
 



Mime
View raw message