Merge pull request #412 from sharwell/obsolete-sync

Mark all synchronous extensions as obsolete

Author: sharwell

src/Documentation/Content/AsynchronousServices.aml

@@ -228,6 +228,12 @@
     <section address="SynchronousExtensions">
       <title>Synchronous Extensions</title>
       <content>
+        <alert class="warning">
+          <para>
+            All synchronous extension methods provided by this library are obsolete, and will be removed from a future
+            release.
+          </para>
+        </alert>
         <para>
           The namespace <codeEntityReference>N:net.openstack.Core.Synchronous</codeEntityReference> contains extension
           methods that allow methods in an asynchronous service interface to be invoked synchronously. These extension

src/corelib/Core/Synchronous/AutoScaleServiceExtensions.cs

@@ -13,6 +13,7 @@
     /// </summary>
     /// <threadsafety static="true" instance="false"/>
     /// <preliminary/>
+    [Obsolete("These synchronous wrappers should not be used. For more information, see http://blogs.msdn.com/b/pfxteam/archive/2012/04/13/10293638.aspx.")]
     public static class ClaimExtensions
     {
         /// <summary>
@@ -26,6 +27,7 @@ public static class ClaimExtensions
         /// <param name="claim">The claim.</param>
         /// <exception cref="ArgumentNullException">If <paramref name="claim"/> is <see langword="null"/>.</exception>
         /// <exception cref="WebException">If the REST request does not return successfully.</exception>
+        [Obsolete("These synchronous wrappers should not be used. For more information, see http://blogs.msdn.com/b/pfxteam/archive/2012/04/13/10293638.aspx.")]
         public static void Refresh(this Claim claim)
         {
             if (claim == null)
@@ -61,6 +63,7 @@ public static void Refresh(this Claim claim)
         /// <exception cref="ArgumentOutOfRangeException">If <paramref name="timeToLive"/> is negative or <see cref="TimeSpan.Zero"/>.</exception>
         /// <exception cref="InvalidOperationException">If the claim is empty (i.e. <see cref="Claim.Messages"/> is empty).</exception>
         /// <exception cref="WebException">If the REST request does not return successfully.</exception>
+        [Obsolete("These synchronous wrappers should not be used. For more information, see http://blogs.msdn.com/b/pfxteam/archive/2012/04/13/10293638.aspx.")]
         public static void Renew(this Claim claim, TimeSpan timeToLive)
         {
             if (claim == null)

src/corelib/Core/Synchronous/ClaimExtensions.cs

@@ -12,6 +12,7 @@
     /// </summary>
     /// <threadsafety static="true" instance="false"/>
     /// <preliminary/>
+    [Obsolete("These synchronous wrappers should not be used. For more information, see http://blogs.msdn.com/b/pfxteam/archive/2012/04/13/10293638.aspx.")]
     public static class ReadOnlyCollectionPageSynchronousExtensions
     {
         /// <summary>
@@ -30,6 +31,7 @@ public static class ReadOnlyCollectionPageSynchronousExtensions
         /// <returns>A read-only collection containing the complete set of results from the paginated collection.</returns>
         /// <exception cref="ArgumentNullException">If <paramref name="page"/> is <see langword="null"/>.</exception>
         /// <seealso cref="ReadOnlyCollectionPageExtensions.GetAllPagesAsync"/>
+        [Obsolete("These synchronous wrappers should not be used. For more information, see http://blogs.msdn.com/b/pfxteam/archive/2012/04/13/10293638.aspx.")]
         public static ReadOnlyCollection<T> GetAllPages<T>(this ReadOnlyCollectionPage<T> page)
         {
             if (page == null)
@@ -58,6 +60,7 @@ public static ReadOnlyCollection<T> GetAllPages<T>(this ReadOnlyCollectionPage<T
         /// <exception cref="InvalidOperationException">If <see cref="ReadOnlyCollectionPage{T}.CanHaveNextPage"/> is <see langword="false"/>.</exception>
         /// <exception cref="WebException">If the REST request does not return successfully.</exception>
         /// <seealso cref="ReadOnlyCollectionPage{T}.GetNextPageAsync"/>
+        [Obsolete("These synchronous wrappers should not be used. For more information, see http://blogs.msdn.com/b/pfxteam/archive/2012/04/13/10293638.aspx.")]
         public static ReadOnlyCollectionPage<T> GetNextPage<T>(this ReadOnlyCollectionPage<T> page)
         {
             if (page == null)