initial commit (Azure#48285)

Author: nickliu-msft

sdk/storage/Azure.Storage.Blobs/src/BlockBlobClient.cs

@@ -1829,9 +1829,12 @@ private async Task<Response<BlockInfo>> StageBlockFromUriInternal(
         /// this by specifying whether to commit a block from the committed
         /// block list or from the uncommitted block list, or to commit the
         /// most recently uploaded version of the block, whichever list it
-        /// may belong to.  Any blocks not specified in the block list and
+        /// may belong to.  Any blocks not specified in the block list are
         /// permanently deleted.
         ///
+        /// Note: Uncommitted blocks will expire and be permanently deleted after 7 days.
+        /// Blocks that are committed to a blob do not expire.
+        ///
         /// For more information, see
         /// <see href="https://docs.microsoft.com/rest/api/storageservices/put-block-list">
         /// Put Block List</see>.
@@ -1886,9 +1889,12 @@ public virtual Response<BlobContentInfo> CommitBlockList(
         /// this by specifying whether to commit a block from the committed
         /// block list or from the uncommitted block list, or to commit the
         /// most recently uploaded version of the block, whichever list it
-        /// may belong to.  Any blocks not specified in the block list and
+        /// may belong to.  Any blocks not specified in the block list are
         /// permanently deleted.
         ///
+        /// Note: Uncommitted blocks will expire and be permanently deleted after 7 days.
+        /// Blocks that are committed to a blob do not expire.
+        ///
         /// For more information, see
         /// <see href="https://docs.microsoft.com/rest/api/storageservices/put-block-list">
         /// Put Block List</see>.
@@ -1959,9 +1965,12 @@ public virtual Response<BlobContentInfo> CommitBlockList(
         /// this by specifying whether to commit a block from the committed
         /// block list or from the uncommitted block list, or to commit the
         /// most recently uploaded version of the block, whichever list it
-        /// may belong to.  Any blocks not specified in the block list and
+        /// may belong to.  Any blocks not specified in the block list are
         /// permanently deleted.
         ///
+        /// Note: Uncommitted blocks will expire and be permanently deleted after 7 days.
+        /// Blocks that are committed to a blob do not expire.
+        ///
         /// For more information, see
         /// <see href="https://docs.microsoft.com/rest/api/storageservices/put-block-list">
         /// Put Block List</see>.
@@ -2016,9 +2025,12 @@ await CommitBlockListInternal(
         /// this by specifying whether to commit a block from the committed
         /// block list or from the uncommitted block list, or to commit the
         /// most recently uploaded version of the block, whichever list it
-        /// may belong to.  Any blocks not specified in the block list and
+        /// may belong to.  Any blocks not specified in the block list are
         /// permanently deleted.
         ///
+        /// Note: Uncommitted blocks will expire and be permanently deleted after 7 days.
+        /// Blocks that are committed to a blob do not expire.
+        ///
         /// For more information, see
         /// <see href="https://docs.microsoft.com/rest/api/storageservices/put-block-list">
         /// Put Block List</see>.
@@ -2089,9 +2101,12 @@ await CommitBlockListInternal(
         /// this by specifying whether to commit a block from the committed
         /// block list or from the uncommitted block list, or to commit the
         /// most recently uploaded version of the block, whichever list it
-        /// may belong to.  Any blocks not specified in the block list and
+        /// may belong to.  Any blocks not specified in the block list are
         /// permanently deleted.
         ///
+        /// Note: Uncommitted blocks will expire and be permanently deleted after 7 days.
+        /// Blocks that are committed to a blob do not expire.
+        ///
         /// For more information, see
         /// <see href="https://docs.microsoft.com/rest/api/storageservices/put-block-list">
         /// Put Block List</see>.