* to only have one socket address associated with it).
*
* Return value: (transfer full): a new #GSocketAddress
+ *
+ * Since: 2.32
*/
GSocketAddress *
soup_address_get_gsockaddr (SoupAddress *addr)
entry = NULL;
} else if ((soup_message_headers_get_encoding (entry->headers) == SOUP_ENCODING_CHUNKED) ||
entry->length != (gsize) content_length) {
- /** Two options here:
+ /* Two options here:
*
* 1. "chunked" data, entry was temporarily added to
* cache (as content-length is 0) and now that we have
* transmission (typically compressed) and thus we
* have to substract the content-length value that was
* added to the cache and add the unencoded length
- **/
+ */
gint length_to_add = entry->length - content_length;
/* Make room in cache if needed */
SoupCacheEntry *entry_a = (SoupCacheEntry *)a;
SoupCacheEntry *entry_b = (SoupCacheEntry *)b;
- /** The rationale of this sorting func is
+ /* The rationale of this sorting func is
*
* 1. sort by hits -> LRU algorithm, then
*
*
* 3. sort by size, replace first small size resources as they
* are cheaper to download
- **/
+ */
/* Sort by hits */
if (entry_a->hits != entry_b->hits)
*
* Returns: a new #SoupCache
*
- * Since: 2.28
- **/
+ * Since: 2.34
+ */
SoupCache *
soup_cache_new (const char *cache_dir, SoupCacheType cache_type)
{
* and the cached reply and the time ellapsed since it was cached.
*
* Returns: whether or not the @cache has a valid response for @msg
- **/
+ *
+ * Since: 2.34
+ */
SoupCacheResponse
soup_cache_has_response (SoupCache *cache, SoupMessage *msg)
{
* Calculates whether the @msg can be cached or not.
*
* Returns: a #SoupCacheability value indicating whether the @msg can be cached or not.
- **/
+ *
+ * Since: 2.34
+ */
SoupCacheability
soup_cache_get_cacheability (SoupCache *cache, SoupMessage *msg)
{
* This function will force all pending writes in the @cache to be
* committed to disk. For doing so it will iterate the #GMainContext
* associated with @cache's session as long as needed.
- **/
+ *
+ * Since: 2.34
+ */
void
soup_cache_flush (SoupCache *cache)
{
*
* Will remove all entries in the @cache plus all the cache files
* associated with them.
- **/
+ *
+ * Since: 2.34
+ */
void
soup_cache_clear (SoupCache *cache)
{
* SOUP_COOKIE_JAR_ACCEPT_POLICY:
*
* Alias for the #SoupCookieJar:accept-policy property.
- **/
+ *
+ * Since: 2.30
+ */
+ /**
+ * SoupCookieJar:accept-policy:
+ *
+ * The policy the jar should follow to accept or reject cookies
+ *
+ * Since: 2.30
+ */
g_object_class_install_property (
object_class, PROP_ACCEPT_POLICY,
g_param_spec_enum (SOUP_COOKIE_JAR_ACCEPT_POLICY,
* document. If no first party is set in a message when this policy is
* in effect, cookies will be assumed to be third party by default.
*
-**/
+ * Since: 2.30
+ */
/**
* soup_cookie_jar_get_accept_policy:
* If @value is (non-ASCII) UTF-8, this will instead use RFC 5987
* encoding, just like soup_header_g_string_append_param().
*
- * Since: 2.32
+ * Since: 2.30
**/
void
soup_header_g_string_append_param_quoted (GString *string,
*
* Removes all the headers listed in the Connection header.
*
- **/
+ * Since: 2.36
+ */
void
soup_message_headers_clean_connection_headers (SoupMessageHeaders *hdrs)
{
* Alias for the #SoupMessage:first-party property. (The
* #SoupURI loaded in the application when the message was
* queued.)
+ *
+ * Since: 2.30
**/
+ /**
+ * SoupMessage:first-party:
+ *
+ * The #SoupURI loaded in the application when the message was
+ * queued.
+ *
+ * Since: 2.30
+ */
g_object_class_install_property (
object_class, PROP_FIRST_PARTY,
g_param_spec_boxed (SOUP_MESSAGE_FIRST_PARTY,
*
* Alias for the #SoupMessage:tls-certificate property. (The
* TLS certificate associated with the message, if any.)
+ *
+ * Since: 2.34
**/
+ /**
+ * SoupMessage:tls-certificate:
+ *
+ * The #GTlsCertificate associated with the message
+ *
+ * Since: 2.34
+ */
g_object_class_install_property (
object_class, PROP_TLS_CERTIFICATE,
g_param_spec_object (SOUP_MESSAGE_TLS_CERTIFICATE,
*
* Alias for the #SoupMessage:tls-errors property. (The
* verification errors on #SoupMessage:tls-certificate.)
+ *
+ * Since: 2.34
**/
+ /**
+ * SoupMessage:tls-certificate:
+ *
+ * The verification errors on #SoupMessage:tls-certificate
+ *
+ * Since: 2.34
+ */
g_object_class_install_property (
object_class, PROP_TLS_ERRORS,
g_param_spec_flags (SOUP_MESSAGE_TLS_ERRORS,
*
* Since: 2.30
**/
-SoupURI*
+SoupURI *
soup_message_get_first_party (SoupMessage *msg)
{
SoupMessagePrivate *priv;
#include "soup-session-feature.h"
#include "soup-uri.h"
+/**
+ * SoupProxyResolverDefault:
+ *
+ * A #SoupProxyURIResolver implementation that uses the default gio
+ * #GProxyResolver to resolve proxies.
+ *
+ * Since: 2.34
+ */
+
static void soup_proxy_resolver_default_interface_init (SoupProxyURIResolverInterface *proxy_resolver_interface);
G_DEFINE_TYPE_EXTENDED (SoupProxyResolverDefault, soup_proxy_resolver_default, G_TYPE_OBJECT, 0,
* Gets a new reference to the #SoupMessage associated to this SoupRequest
*
* Returns: a new reference to the #SoupMessage
- **/
+ *
+ * Since: 2.34
+ */
SoupMessage *
soup_request_http_get_message (SoupRequestHTTP *http)
{
* @short_description: Protocol-independent streaming request interface
*
* FIXME
- **/
+ */
/**
* SoupRequest:
*
* FIXME
*
- * Since: 2.30
- **/
+ * Since: 2.34
+ */
static void soup_request_initable_interface_init (GInitableIface *initable_interface);
SOUP_SESSION_FEATURE_GET_CLASS (feature)->detach (feature, session);
}
+/**
+ * soup_session_feature_add_feature:
+ * @feature: the "base" feature
+ * @type: the #GType of a "sub-feature"
+ *
+ * Adds a "sub-feature" of type @type to the base feature @feature.
+ * This is used for features that can be extended with multiple
+ * different types. Eg, the authentication manager can be extended
+ * with subtypes of #SoupAuth.
+ *
+ * Return value: %TRUE if @feature accepted @type as a subfeature.
+ *
+ * Since: 2.34
+ */
gboolean
soup_session_feature_add_feature (SoupSessionFeature *feature,
GType type)
return FALSE;
}
+/**
+ * soup_session_feature_remove_feature:
+ * @feature: the "base" feature
+ * @type: the #GType of a "sub-feature"
+ *
+ * Removes the "sub-feature" of type @type from the base feature
+ * @feature. See soup_session_feature_add_feature().
+ *
+ * Return value: %TRUE if @type was removed from @feature
+ *
+ * Since: 2.34
+ */
gboolean
soup_session_feature_remove_feature (SoupSessionFeature *feature,
GType type)
return FALSE;
}
+/**
+ * soup_session_feature_has_feature:
+ * @feature: the "base" feature
+ * @type: the #GType of a "sub-feature"
+ *
+ * Tests if @feature has a "sub-feature" of type @type. See
+ * soup_session_feature_add_feature().
+ *
+ * Return value: %TRUE if @feature has a subfeature of type @type
+ *
+ * Since: 2.34
+ */
gboolean
soup_session_feature_has_feature (SoupSessionFeature *feature,
GType type)
* SOUP_SESSION_ACCEPT_LANGUAGE:
*
* Alias for the #SoupSession:accept-language property, qv.
+ *
+ * Since: 2.30
**/
g_object_class_install_property (
object_class, PROP_ACCEPT_LANGUAGE,
* SOUP_SESSION_ACCEPT_LANGUAGE_AUTO:
*
* Alias for the #SoupSession:accept-language-auto property, qv.
+ *
+ * Since: 2.30
**/
g_object_class_install_property (
object_class, PROP_ACCEPT_LANGUAGE_AUTO,