[neon/backports-jammy/libsignon-glib/Neon/unstable] debian: fix invalid gtk-doc comments

[Pino Toscano]

Git commit 2a4a0d9771259186fa82d3f9aec589a9c1e11606 by Pino Toscano.
Committed on 31/12/2020 at 12:49.
Pushed by carlosdem into branch 'Neon/unstable'.

fix invalid gtk-doc comments

M  +1    -0    debian/changelog
A  +49   -0    debian/patches/fix-gtkdoc-comments.diff
M  +1    -0    debian/patches/series

https://invent.kde.org/neon/backports-jammy/libsignon-glib/-/commit/2a4a0d9771259186fa82d3f9aec589a9c1e11606

diff --git a/debian/changelog b/debian/changelog
index c175aed..d56a628 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -15,6 +15,7 @@ libsignon-glib (1.15-0r1) UNRELEASED; urgency=medium
   * Statically import the D-Bus interfaces for now, as they are fetched using
     a Git submodule, which is not exported in tarballs created from GitLab;
     patch signon-dbus-specification-interfaces.diff. (Closes: #975793)
+  * Fix few invalid gtk-doc comments; patch fix-gtkdoc-comments.diff.
 
  -- Debian/Kubuntu Qt/KDE Maintainers <debian-qt-kde at lists.debian.org>  Thu, 31 Dec 2020 12:54:04 +0100
 
diff --git a/debian/patches/fix-gtkdoc-comments.diff b/debian/patches/fix-gtkdoc-comments.diff
new file mode 100644
index 0000000..8b4abf7
--- /dev/null
+++ b/debian/patches/fix-gtkdoc-comments.diff
@@ -0,0 +1,49 @@
+Author: Pino Toscano
+Description: Fix invalid gtk-doc comments
+ Taken from the (much larger) upstream commit
+ 5172fbcb3ca691f947baa6e9ded6b4ee48c18707.
+Forwarded: not-needed
+Last-Update: 2020-12-31
+
+--- a/libsignon-glib/signon-auth-session.c
++++ b/libsignon-glib/signon-auth-session.c
+@@ -85,27 +85,27 @@ struct _SignonAuthSessionPrivate
+ };
+ 
+ enum SignonAuthSessionState {
+-    SIGNON_AUTH_SESSION_STATE_NOT_STARTED = 0,   /**< No message. */
+-    SIGNON_AUTH_SESSION_STATE_RESOLVING_HOST,    /**< Resolving remote server
++    SIGNON_AUTH_SESSION_STATE_NOT_STARTED = 0,   /* No message. */
++    SIGNON_AUTH_SESSION_STATE_RESOLVING_HOST,    /* Resolving remote server
+                                                    host name. */
+-    SIGNON_AUTH_SESSION_STATE_CONNECTING,        /**< Connecting to remote
++    SIGNON_AUTH_SESSION_STATE_CONNECTING,        /* Connecting to remote
+                                                    server. */
+-    SIGNON_AUTH_SESSION_STATE_SENDING_DATA,      /**< Sending data to remote
++    SIGNON_AUTH_SESSION_STATE_SENDING_DATA,      /* Sending data to remote
+                                                    server. */
+-    SIGNON_AUTH_SESSION_STATE_WAITING_REPLY,     /**< Waiting reply from remote
++    SIGNON_AUTH_SESSION_STATE_WAITING_REPLY,     /* Waiting reply from remote
+                                                    server. */
+-    SIGNON_AUTH_SESSION_STATE_USER_PENDING,      /**< Waiting response from
++    SIGNON_AUTH_SESSION_STATE_USER_PENDING,      /* Waiting response from
+                                                    user. */
+-    SIGNON_AUTH_SESSION_STATE_UI_REFRESHING,     /**< Refreshing ui request. */
+-    SIGNON_AUTH_SESSION_STATE_PROCESS_PENDING,   /**< Waiting another process
++    SIGNON_AUTH_SESSION_STATE_UI_REFRESHING,     /* Refreshing ui request. */
++    SIGNON_AUTH_SESSION_STATE_PROCESS_PENDING,   /* Waiting another process
+                                                    to start. */
+-    SIGNON_AUTH_SESSION_STATE_STARTED,           /**< Authentication session is
++    SIGNON_AUTH_SESSION_STATE_STARTED,           /* Authentication session is
+                                                    started. */
+-    SIGNON_AUTH_SESSION_STATE_PROCESS_CANCELING, /**< Canceling.current
++    SIGNON_AUTH_SESSION_STATE_PROCESS_CANCELING, /* Canceling.current
+                                                    process. */
+-    SIGNON_AUTH_SESSION_STATE_PROCESS_DONE,      /**< Authentication
++    SIGNON_AUTH_SESSION_STATE_PROCESS_DONE,      /* Authentication
+                                                    completed. */
+-    SIGNON_AUTH_SESSION_STATE_CUSTOM,            /**< Custom message. */
++    SIGNON_AUTH_SESSION_STATE_CUSTOM,            /* Custom message. */
+     SIGNON_AUTH_SESSION_STATE_LAST
+ };
+ 
diff --git a/debian/patches/series b/debian/patches/series
index 9a5c4b4..2e8fc96 100644
--- a/debian/patches/series
+++ b/debian/patches/series
@@ -1,2 +1,3 @@
 disable-deprecation-error.patch
 signon-dbus-specification-interfaces.diff
+fix-gtkdoc-comments.diff