Merge pull request #4 from jcookems/fixDocWarnings

Fix JavaDoc build warnings

microsoft-azure-api/src/main/java/com/microsoft/windowsazure/services/blob/client/BlobContainerProperties.java

@@ -131,7 +131,7 @@ public void setLeaseStatus(final LeaseStatus leaseStatus) {
     /**
      * Sets the lease status on the container. Reserved for internal use.
      * 
-     * @param LeaseState
+     * @param leaseState
      *            The lease state to set, as a <code>LeaseState</code> object.
      */
     public void setLeaseState(final LeaseState leaseState) {
@@ -141,7 +141,7 @@ public void setLeaseState(final LeaseState leaseState) {
     /**
      * Sets the lease duration on the container. Reserved for internal use.
      * 
-     * @param LeaseDuration
+     * @param leaseDuration
      *            The lease duration to set, as a <code>LeaseDuration</code> object.
      */
     public void setLeaseDuration(final LeaseDuration leaseDuration) {

microsoft-azure-api/src/main/java/com/microsoft/windowsazure/services/blob/client/BlobProperties.java

@@ -334,7 +334,7 @@ public void setLeaseStatus(final LeaseStatus leaseStatus) {
     /**
      * Sets the lease state for the blob. Reserved for internal use.
      * 
-     * @param LeaseState
+     * @param leaseState
      *            The lease state to set, represented by a <code>LeaseState</code> object.
      */
     public void setLeaseState(final LeaseState leaseState) {
@@ -344,7 +344,7 @@ public void setLeaseState(final LeaseState leaseState) {
     /**
      * Sets the lease duration for the blob. Reserved for internal use.
      * 
-     * @param LeaseDuration
+     * @param leaseDuration
      *            The lease duration value to set, represented by a <code>LeaseDuration</code> object.
      */
     public void setLeaseDuration(final LeaseDuration leaseDuration) {

microsoft-azure-api/src/main/java/com/microsoft/windowsazure/services/blob/client/CloudBlob.java

@@ -1247,7 +1247,7 @@ public final void downloadRange(final long offset, final int length, final byte[
      *            the number of bytes to read
      * @param buffer
      *            the byte buffer to write to.
-     * @param bufferOffet
+     * @param bufferOffset
      *            the offset in the byte buffer to begin writing.
      * @param accessCondition
      *            An {@link AccessCondition} object that represents the access conditions for the blob.
@@ -1468,10 +1468,6 @@ else if (this.getResult().getStatusCode() == HttpURLConnection.HTTP_NOT_FOUND) {
      *            signature.
      * @param groupPolicyIdentifier
      *            A <code>String</code> that represents the container-level access policy.
-     * @param opContext
-     *            An {@link OperationContext} object that represents the context for the current operation. This object
-     *            is used to track requests to the storage service, and to provide additional runtime information about
-     *            the operation.
      * 
      * @return A <code>String</code> that represents the shared access signature.
      * 

microsoft-azure-api/src/main/java/com/microsoft/windowsazure/services/blob/core/storage/SharedAccessSignatureHelper.java

@@ -149,10 +149,6 @@ public static UriQueryBuilder generateSharedAccessSignature(final SharedAccessQu
     /**
      * Get the complete query builder for creating the Shared Access Signature query.
      * 
-     * @param policy
-     *            The shared access policy to hash.
-     * @param groupPolicyIdentifier
-     *            An optional identifier for the policy.
      * @param signature
      *            The signature to use.
      * @return The finished query builder
@@ -285,7 +281,7 @@ public static String generateSharedAccessSignatureHash(final SharedAccessBlobPol
      * 
      * @param policy
      *            The shared access policy to hash.
-     * @param groupPolicyIdentifier
+     * @param accessPolicyIdentifier
      *            An optional identifier for the policy.
      * @param resourceName
      *            the resource name.
@@ -356,7 +352,7 @@ public static String generateSharedAccessSignatureHash(final String permissions,
      * 
      * @param policy
      *            The shared access policy to hash.
-     * @param groupPolicyIdentifier
+     * @param accessPolicyIdentifier
      *            An optional identifier for the policy.
      * @param resourceName
      *            the resource name.

microsoft-azure-api/src/main/java/com/microsoft/windowsazure/services/blob/models/CreateBlobOptions.java

@@ -20,7 +20,7 @@
 
 /**
  * Represents the options that may be set on a
- * {@link BlobContract#createPageBlob(String, String, int, CreateBlobOptions) createPageBlob} or
+ * {@link BlobContract#createPageBlob(String, String, long, CreateBlobOptions) createPageBlob} or
  * {@link BlobContract#createBlockBlob(String, String, java.io.InputStream, CreateBlobOptions) createBlockBlob} request.
  * These options include an optional server timeout for the operation, the MIME content type and content encoding for
  * the blob, the content language, the MD5 hash, a cache control value, blob metadata, a blob lease ID, a sequence

microsoft-azure-api/src/main/java/com/microsoft/windowsazure/services/blob/models/CreateBlobResult.java

@@ -21,7 +21,7 @@
 /**
  * A wrapper class for the response returned from a Blob Service REST API Create Blob operation. This is returned by
  * calls to implementations of {@link BlobContract#createPageBlob(String, String, long, CreateBlobOptions)} and
- * {@link BlobContract#createBlockBlob(String, String, long, CreateBlobOptions)}.
+ * {@link BlobContract#createBlockBlob(String, String, java.io.InputStream, CreateBlobOptions)}.
  * <p>
  * See the <a href="http://msdn.microsoft.com/en-us/library/windowsazure/dd179451.aspx">Put Blob</a> documentation on
  * MSDN for details of the underlying Blob Service REST API operation.

microsoft-azure-api/src/main/java/com/microsoft/windowsazure/services/media/entityoperations/EntityOperation.java

@@ -25,7 +25,6 @@ public interface EntityOperation {
      * Supplies the current proxy information to the action.
      * 
      * @param proxyData
-     * @return
      */
     public void setProxyData(EntityProxyData proxyData);
 

microsoft-azure-api/src/main/java/com/microsoft/windowsazure/services/media/models/ContentKey.java

@@ -172,7 +172,7 @@ public Creator setProtectionKeyType(ProtectionKeyType protectionKeyType) {
     /**
      * Create an operation that will retrieve the given content key.
      * 
-     * @param ContentKeyId
+     * @param contentKeyId
      *            id of content key to retrieve
      * @return the operation
      */
@@ -205,7 +205,7 @@ public static DefaultListOperation<ContentKeyInfo> list(LinkInfo<ContentKeyInfo>
     /**
      * Create an operation to delete the given content key.
      * 
-     * @param ContentKeyId
+     * @param contentKeyId
      *            id of content key to delete
      * @return the delete operation
      */

microsoft-azure-api/src/main/java/com/microsoft/windowsazure/services/queue/client/SharedAccessQueuePolicy.java

@@ -75,7 +75,7 @@ public static EnumSet<SharedAccessQueuePermissions> permissionsFromString(final
      *            A {@link SharedAccessQueuePermissions} object that represents the shared access permissions.
      * 
      * @return A <code>String</code> that represents the shared access permissions in the "rwdl" format, which is
-     *         described at {@link SharedAccessQueuePermissions#permissionsFromString}.
+     *         described at {@link SharedAccessQueuePolicy#permissionsFromString(String)}.
      */
     public static String permissionsToString(final EnumSet<SharedAccessQueuePermissions> permissions) {
         if (permissions == null) {

microsoft-azure-api/src/main/java/com/microsoft/windowsazure/services/table/client/SharedAccessTablePolicy.java

@@ -75,7 +75,7 @@ public static EnumSet<SharedAccessTablePermissions> permissionsFromString(final
      *            A set of {@link SharedAccessTablePermissions} objects that represent the shared access permissions.
      * 
      * @return A <code>String</code> that represents the shared access permissions in the "rwdl" format, which is
-     *         described at {@link SharedAccessTablePermissions#permissionsFromString}.
+     *         described at {@link SharedAccessTablePolicy#permissionsFromString(String)}.
      */
     public static String permissionsToString(final EnumSet<SharedAccessTablePermissions> permissions) {
         if (permissions == null) {