[libsoup] soup_cookie_new: clarify the interpretation of @domain

[Dan Winship <danw src gnome org>]

commit 74b6fc3525a04432495cb2db5d6ce62c5a90c5a6
Author: Dan Winship <danw gnome org>
Date:   Sun Aug 25 09:40:05 2013 -0400

    soup_cookie_new: clarify the interpretation of @domain
    
    https://bugzilla.gnome.org/show_bug.cgi?id=691840

 libsoup/soup-cookie.c |    4 ++++
 1 files changed, 4 insertions(+), 0 deletions(-)
---
diff --git a/libsoup/soup-cookie.c b/libsoup/soup-cookie.c
index 731a4a5..3f7dcc3 100755
--- a/libsoup/soup-cookie.c
+++ b/libsoup/soup-cookie.c
@@ -358,6 +358,10 @@ cookie_new_internal (const char *name, const char *value,
  * soup_cookie_set_secure() and soup_cookie_set_http_only() if you
  * need to set those attributes on the returned cookie.)
  *
+ * If @domain starts with ".", that indicates a domain (which matches
+ * the string after the ".", or any hostname that has @domain as a
+ * suffix). Otherwise, it is a hostname and must match exactly.
+ *
  * @max_age is used to set the "expires" attribute on the cookie; pass
  * -1 to not include the attribute (indicating that the cookie expires
  * with the current session), 0 for an already-expired cookie, or a