[libsoup/wip/doc-fixes: 2/10] docs: Fix minor docs issues for HSTSEnforcer

[Patrick Griffis <pgriffis src gnome org>]

commit 0d8cb98597bcd14a10a14f9174ead5b07c1e2b97
Author: Patrick Griffis <pgriffis igalia com>
Date:   Sat Sep 19 19:53:10 2020 -0700

    docs: Fix minor docs issues for HSTSEnforcer

 libsoup/hsts/soup-hsts-enforcer.h |  4 +++-
 libsoup/hsts/soup-hsts-policy.c   | 15 ++-------------
 2 files changed, 5 insertions(+), 14 deletions(-)
---
diff --git a/libsoup/hsts/soup-hsts-enforcer.h b/libsoup/hsts/soup-hsts-enforcer.h
index ba7d43f5..d0223188 100644
--- a/libsoup/hsts/soup-hsts-enforcer.h
+++ b/libsoup/hsts/soup-hsts-enforcer.h
@@ -24,7 +24,8 @@ G_DECLARE_DERIVABLE_TYPE (SoupHSTSEnforcer, soup_hsts_enforcer, SOUP, HSTS_ENFOR
  * change the scheme of the #SoupURI in the #SoupMessage to HTTPS. Implementations might want to
  * chain up to the @has_valid_policy in the parent class to check, for instance, for runtime
  * policies.
- * @changed: the class closure for the #SoupHSTSEnforcer::changed signal.
+ * @changed: The class closure for the #SoupHSTSEnforcer::changed signal.
+ * @hsts_enforced: The class closure for the #SoupHSTSEnforcer::hsts-enforced signal.
  **/
 struct _SoupHSTSEnforcerClass {
        GObjectClass parent_class;
@@ -40,6 +41,7 @@ struct _SoupHSTSEnforcerClass {
        void (*hsts_enforced) (SoupHSTSEnforcer *enforcer,
                               SoupMessage      *message);
 
+        /* <private> */
        gpointer padding[4];
 };
 
diff --git a/libsoup/hsts/soup-hsts-policy.c b/libsoup/hsts/soup-hsts-policy.c
index 39bce01d..2bae29ba 100644
--- a/libsoup/hsts/soup-hsts-policy.c
+++ b/libsoup/hsts/soup-hsts-policy.c
@@ -18,18 +18,6 @@
 #include "soup-date-utils-private.h"
 #include "soup.h"
 
-/**
- * SECTION:soup-hsts-policy
- * @short_description: HTTP Strict Transport Security policies
- * @see_also: #SoupHSTSEnforcer
- *
- * #SoupHSTSPolicy implements HTTP policies, as described by <ulink
- * url="http://tools.ietf.org/html/rfc6797";>RFC 6797</ulink>.
- *
- * To have a #SoupSession handle HSTS policies for your appliction
- * automatically, use a #SoupHSTSEnforcer.
- **/
-
 /**
  * SoupHSTSPolicy:
  * @domain: The domain or hostname that the policy applies to
@@ -37,7 +25,8 @@
  * @expires: the policy expiration time, or %NULL for a permanent session policy
  * @include_subdomains: %TRUE if the policy applies on subdomains
  *
- * An HTTP Strict Transport Security policy.
+ * #SoupHSTSPolicy implements HTTP policies, as described by
+ * [RFC 6797](http://tools.ietf.org/html/rfc6797).
  *
  * @domain represents the host that this policy applies to. The domain
  * must be IDNA-canonicalized. soup_hsts_policy_new() and related methods