[libsoup] Bug 789099 - Warnings while generating introspection files

[Tomas Popela <tpopela src gnome org>]

commit 2d58483cadd7ab72bf9fabf1968c1b5ad0dd723e
Author: Tomas Popela <tpopela redhat com>
Date:   Thu Oct 19 09:50:28 2017 +0200

    Bug 789099 - Warnings while generating introspection files
    
    Reorganize the documentation to fix the warnings.

 libsoup/soup-session-async.c |   11 +++++------
 libsoup/soup-session-sync.c  |   11 +++++------
 2 files changed, 10 insertions(+), 12 deletions(-)
---
diff --git a/libsoup/soup-session-async.c b/libsoup/soup-session-async.c
index e9d4712..c187989 100644
--- a/libsoup/soup-session-async.c
+++ b/libsoup/soup-session-async.c
@@ -18,16 +18,15 @@
 
 /**
  * SECTION:soup-session-async
- * @short_description: (Deprecated) SoupSession for asynchronous
- *   (main-loop-based) I/O.
+ * @short_description: SoupSession for asynchronous (main-loop-based) I/O
+ * (deprecated).
  *
  * #SoupSessionAsync is an implementation of #SoupSession that uses
  * non-blocking I/O via the glib main loop for all I/O.
  *
- * As of libsoup 2.42, this is deprecated in favor of the plain
- * #SoupSession class (which uses both asynchronous and synchronous
- * I/O, depending on the API used). See the <link
- * linkend="libsoup-session-porting">porting guide</link>.
+ * Deprecated: 2.42: Use the #SoupSession class (which uses both asynchronous
+ * and synchronous I/O, depending on the API used). See the
+ * <link linkend="libsoup-session-porting">porting guide</link>.
  **/
 
 G_GNUC_BEGIN_IGNORE_DEPRECATIONS;
diff --git a/libsoup/soup-session-sync.c b/libsoup/soup-session-sync.c
index 42e5078..229ac1e 100644
--- a/libsoup/soup-session-sync.c
+++ b/libsoup/soup-session-sync.c
@@ -17,16 +17,15 @@
 
 /**
  * SECTION:soup-session-sync
- * @short_description: (Deprecated) SoupSession for blocking I/O in
- *   multithreaded programs.
+ * @short_description: SoupSession for blocking I/O in multithreaded programs
+ * (deprecated).
  *
  * #SoupSessionSync is an implementation of #SoupSession that uses
  * synchronous I/O, intended for use in multi-threaded programs.
  *
- * As of libsoup 2.42, this is deprecated in favor of the plain
- * #SoupSession class (which uses both asynchronous and synchronous
- * I/O, depending on the API used). See the <link
- * linkend="libsoup-session-porting">porting guide</link>.
+ * Deprecated: 2.42: Use the #SoupSession class (which uses both asynchronous
+ * and synchronous I/O, depending on the API used). See the
+ * <link linkend="libsoup-session-porting">porting guide</link>.
  **/
 
 G_GNUC_BEGIN_IGNORE_DEPRECATIONS;