[libgdata] picasaweb: Clarify how to handle authentication failures during upload

[Debarshi Ray <debarshir src gnome org>]

commit f352682abd5897029f36435d1563ebc8fa7c1f43
Author: Debarshi Ray <debarshir gnome org>
Date:   Fri Jun 17 12:53:24 2016 +0200

    picasaweb: Clarify how to handle authentication failures during upload
    
    https://bugzilla.gnome.org/show_bug.cgi?id=767784

 gdata/services/picasaweb/gdata-picasaweb-service.c |    6 ++++--
 1 files changed, 4 insertions(+), 2 deletions(-)
---
diff --git a/gdata/services/picasaweb/gdata-picasaweb-service.c 
b/gdata/services/picasaweb/gdata-picasaweb-service.c
index 67455a2..ee0ef4d 100644
--- a/gdata/services/picasaweb/gdata-picasaweb-service.c
+++ b/gdata/services/picasaweb/gdata-picasaweb-service.c
@@ -586,8 +586,10 @@ gdata_picasaweb_service_query_files_async (GDataPicasaWebService *self, GDataPic
  * #GDataUploadStream. If @album is %NULL, the file will be uploaded to the currently-authenticated user's 
"Drop Box" album. A user must be
  * authenticated to use this function.
  *
- * If @file has already been inserted, a %GDATA_SERVICE_ERROR_ENTRY_ALREADY_INSERTED error will be returned. 
If no user is authenticated
- * with the service, %GDATA_SERVICE_ERROR_AUTHENTICATION_REQUIRED will be returned.
+ * If @file has already been inserted, a %GDATA_SERVICE_ERROR_ENTRY_ALREADY_INSERTED error will be returned.
+ *
+ * If no user is authenticated with the service, %GDATA_SERVICE_ERROR_AUTHENTICATION_REQUIRED will be 
returned. It is recommended to retry the
+ * upload after refreshing the authorization tokens held by the associated #GDataAuthorizer using 
gdata_authorizer_refresh_authorization().
  *
  * The stream returned by this function should be written to using the standard #GOutputStream methods, 
asychronously or synchronously. Once the stream
  * is closed (using g_output_stream_close()), gdata_picasaweb_service_finish_file_upload() should be called 
on it to parse and return the updated