Merge pull request #35 from pemari-msft/master

Azure Storage Client Library - 3.1.0

Author: Joe Giardino

Lib/ClassLibraryCommon/Auth/Protocol/IAuthenticationHandler.cs

@@ -28,7 +28,7 @@ public interface IAuthenticationHandler
         /// Signs the specified HTTP request so it can be authenticated by the Windows Azure storage services.
         /// </summary>
         /// <param name="request">The HTTP request to sign.</param>
-        /// <param name="operationContext">An <see cref="OperationContext"/> object for tracking the current operation.</param>
+        /// <param name="operationContext">An <see cref="OperationContext"/> object that represents the context for the current operation.</param>
         void SignRequest(HttpWebRequest request, OperationContext operationContext);
     }
 }

Lib/ClassLibraryCommon/Auth/Protocol/NoOpAuthenticationHandler.cs

@@ -35,7 +35,7 @@ public NoOpAuthenticationHandler()
         /// Signs the specified HTTP request with no authentication information.
         /// </summary>
         /// <param name="request">The HTTP request to sign.</param>
-        /// <param name="operationContext">An <see cref="OperationContext"/> object for tracking the current operation.</param>
+        /// <param name="operationContext">An <see cref="OperationContext"/> object that represents the context for the current operation.</param>
         public void SignRequest(HttpWebRequest request, OperationContext operationContext)
         {
             // no op

Lib/ClassLibraryCommon/Auth/Protocol/SharedKeyAuthenticationHandler.cs

@@ -53,7 +53,7 @@ public SharedKeyAuthenticationHandler(ICanonicalizer canonicalizer, StorageCrede
         /// Signs the specified HTTP request with a shared key.
         /// </summary>
         /// <param name="request">The HTTP request to sign.</param>
-        /// <param name="operationContext">An <see cref="OperationContext"/> object for tracking the current operation.</param>
+        /// <param name="operationContext">An <see cref="OperationContext"/> object that represents the context for the current operation.</param>
         public void SignRequest(HttpWebRequest request, OperationContext operationContext)
         {
             CommonUtility.AssertNotNull("request", request);

Lib/ClassLibraryCommon/Auth/Protocol/SharedKeyLiteAuthenticationHandler.cs

@@ -44,7 +44,7 @@ public SharedKeyLiteAuthenticationHandler(ICanonicalizer canonicalizer, StorageC
         /// Signs the specified HTTP request with a shared key.
         /// </summary>
         /// <param name="request">The HTTP request to sign.</param>
-        /// <param name="operationContext">An <see cref="OperationContext"/> object for tracking the current operation.</param>
+        /// <param name="operationContext">An <see cref="OperationContext"/> object that represents the context for the current operation.</param>
         public void SignRequest(HttpWebRequest request, OperationContext operationContext)
         {
             this.authenticationHandler.SignRequest(request, operationContext);

Lib/ClassLibraryCommon/Blob/BlobReadStream.cs

@@ -31,9 +31,9 @@ internal sealed class BlobReadStream : BlobReadStreamBase
         /// Initializes a new instance of the BlobReadStream class.
         /// </summary>
         /// <param name="blob">Blob reference to read from</param>
-        /// <param name="accessCondition">An object that represents the access conditions for the blob. If null, no condition is used.</param>
-        /// <param name="options">An object that specifies additional options for the request.</param>
-        /// <param name="operationContext">An <see cref="OperationContext"/> object for tracking the current operation.</param>
+        /// <param name="accessCondition">An <see cref="AccessCondition"/> object that represents the condition that must be met in order for the request to proceed. If <c>null</c>, no condition is used.</param>
+        /// <param name="options">A <see cref="BlobRequestOptions"/> object that specifies additional options for the request.</param>
+        /// <param name="operationContext">An <see cref="OperationContext"/> object that represents the context for the current operation.</param>
         internal BlobReadStream(ICloudBlob blob, AccessCondition accessCondition, BlobRequestOptions options, OperationContext operationContext)
             : base(blob, accessCondition, options, operationContext)
         {

Lib/ClassLibraryCommon/Blob/BlobWriteStream.cs

@@ -37,9 +37,9 @@ internal sealed class BlobWriteStream : BlobWriteStreamBase
         /// Initializes a new instance of the BlobWriteStream class for a block blob.
         /// </summary>
         /// <param name="blockBlob">Blob reference to write to.</param>
-        /// <param name="accessCondition">An object that represents the access conditions for the blob. If null, no condition is used.</param>
-        /// <param name="options">An object that specifies additional options for the request.</param>
-        /// <param name="operationContext">An <see cref="OperationContext"/> object for tracking the current operation.</param>
+        /// <param name="accessCondition">An <see cref="AccessCondition"/> object that represents the condition that must be met in order for the request to proceed. If <c>null</c>, no condition is used.</param>
+        /// <param name="options">A <see cref="BlobRequestOptions"/> object that specifies additional options for the request.</param>
+        /// <param name="operationContext">An <see cref="OperationContext"/> object that represents the context for the current operation.</param>
         internal BlobWriteStream(CloudBlockBlob blockBlob, AccessCondition accessCondition, BlobRequestOptions options, OperationContext operationContext)
             : base(blockBlob, accessCondition, options, operationContext)
         {
@@ -51,9 +51,9 @@ internal BlobWriteStream(CloudBlockBlob blockBlob, AccessCondition accessConditi
         /// <param name="pageBlob">Blob reference to write to.</param>
         /// <param name="pageBlobSize">Size of the page blob.</param>
         /// <param name="createNew">Use <c>true</c> if the page blob is newly created, <c>false</c> otherwise.</param>
-        /// <param name="accessCondition">An object that represents the access conditions for the blob. If null, no condition is used.</param>
-        /// <param name="options">An object that specifies additional options for the request.</param>
-        /// <param name="operationContext">An <see cref="OperationContext"/> object for tracking the current operation.</param>
+        /// <param name="accessCondition">An <see cref="AccessCondition"/> object that represents the condition that must be met in order for the request to proceed. If <c>null</c>, no condition is used.</param>
+        /// <param name="options">A <see cref="BlobRequestOptions"/> object that specifies additional options for the request.</param>
+        /// <param name="operationContext">An <see cref="OperationContext"/> object that represents the context for the current operation.</param>
         internal BlobWriteStream(CloudPageBlob pageBlob, long pageBlobSize, bool createNew, AccessCondition accessCondition, BlobRequestOptions options, OperationContext operationContext)
             : base(pageBlob, pageBlobSize, createNew, accessCondition, options, operationContext)
         {
@@ -279,10 +279,10 @@ public override void EndFlush(IAsyncResult asyncResult)
 
 #if WINDOWS_PHONE
         /// <summary>
-        /// Returns a task that performs an asynchronous flush operation.
+        /// Initiates an asynchronous operation that performs an asynchronous flush operation.
         /// </summary>
         /// <param name="cancellationToken">A <see cref="CancellationToken"/> to observe while waiting for a task to complete.</param>
-        /// <returns>A <see cref="Task"/> object that represents the current operation.</returns>
+        /// <returns>A <see cref="Task"/> object that represents the asynchronous operation.</returns>
         public override Task FlushAsync(CancellationToken cancellationToken)
         {
             return AsyncExtensions.TaskFromVoidApm(this.BeginFlush, this.EndFlush, cancellationToken);