[libgdata] Bug 593336 — Query parameter "q=..." isn't valid for album kinds

[Philip Withnall <pwithnall src gnome org>]

commit d499901b4a689db1218beeae693498e947db4025
Author: Philip Withnall <philip tecnocode co uk>
Date:   Sun Sep 20 17:05:05 2009 +0100

    Bug 593336 â?? Query parameter "q=..." isn't valid for album kinds
    
    Add a few notes in the API documentation to say that the q parameter
    isn't valid for album queries. Closes: bgo#593336

 gdata/services/picasaweb/gdata-picasaweb-query.c   |    2 ++
 gdata/services/picasaweb/gdata-picasaweb-service.c |    2 ++
 2 files changed, 4 insertions(+), 0 deletions(-)
---
diff --git a/gdata/services/picasaweb/gdata-picasaweb-query.c b/gdata/services/picasaweb/gdata-picasaweb-query.c
index d56dedf..1e4e803 100644
--- a/gdata/services/picasaweb/gdata-picasaweb-query.c
+++ b/gdata/services/picasaweb/gdata-picasaweb-query.c
@@ -298,6 +298,8 @@ get_query_uri (GDataQuery *self, const gchar *feed_uri, GString *query_uri, gboo
  *
  * Creates a new #GDataPicasaWebQuery with its #GDataQuery:q property set to @q.
  *
+ * Note that when querying for albums with gdata_picasaweb_service_query_all_albums(), the @q parameter cannot be used.
+ *
  * Return value: a new #GDataPicasaWebQuery
  *
  * Since: 0.4.0
diff --git a/gdata/services/picasaweb/gdata-picasaweb-service.c b/gdata/services/picasaweb/gdata-picasaweb-service.c
index 3d285c5..a9ff465 100644
--- a/gdata/services/picasaweb/gdata-picasaweb-service.c
+++ b/gdata/services/picasaweb/gdata-picasaweb-service.c
@@ -111,6 +111,8 @@ gdata_picasaweb_service_new (const gchar *client_id)
  * @query. If a user is authenticated with the service, @username can be set as %NULL to return a list of albums belonging
  * to the currently-authenticated user.
  *
+ * Note that the #GDataQuery:q query parameter cannot be set on @query for album queries.
+ *
  * For more details, see gdata_service_query().
  *
  * Return value: a #GDataFeed of query results; unref with g_object_unref()