[libgdata] docs: Fix some documentation comment syntax



commit 50e671a77fff86641a211ea1434b067d35e359db
Author: Philip Withnall <philip tecnocode co uk>
Date:   Fri Apr 13 00:04:09 2012 +0100

    docs: Fix some documentation comment syntax

 gdata/services/documents/gdata-documents-entry.c |   10 +++++-----
 gdata/services/picasaweb/gdata-picasaweb-album.c |   18 +++++++++---------
 2 files changed, 14 insertions(+), 14 deletions(-)
---
diff --git a/gdata/services/documents/gdata-documents-entry.c b/gdata/services/documents/gdata-documents-entry.c
index 589f544..4eb7cdb 100644
--- a/gdata/services/documents/gdata-documents-entry.c
+++ b/gdata/services/documents/gdata-documents-entry.c
@@ -169,7 +169,7 @@ gdata_documents_entry_class_init (GDataDocumentsEntryClass *klass)
 	entry_class->get_entry_uri = get_entry_uri;
 
 	/**
-	 * GDataDocumentsEntry:edited
+	 * GDataDocumentsEntry:edited:
 	 *
 	 * The last time the document was edited. If the document has not been edited yet, the content indicates the time it was created.
 	 *
@@ -185,7 +185,7 @@ gdata_documents_entry_class_init (GDataDocumentsEntryClass *klass)
 	                                                     G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
 
 	/**
-	 * GDataDocumentsEntry:last-viewed
+	 * GDataDocumentsEntry:last-viewed:
 	 *
 	 * The last time the document was viewed.
 	 *
@@ -225,7 +225,7 @@ gdata_documents_entry_class_init (GDataDocumentsEntryClass *klass)
 	                                                       G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 
 	/**
-	 * GDataDocumentsEntry:resource-id
+	 * GDataDocumentsEntry:resource-id:
 	 *
 	 * The resource ID of the document. This should not normally need to be used in client code, and is mostly for internal use. To uniquely
 	 * identify a given document or folder, use its #GDataEntry:id.
@@ -248,7 +248,7 @@ gdata_documents_entry_class_init (GDataDocumentsEntryClass *klass)
 	                                                      G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
 
 	/**
-	 * GDataDocumentsEntry:document-id
+	 * GDataDocumentsEntry:document-id:
 	 *
 	 * The document ID of the document, which is different from its entry ID (GDataEntry:id). The
 	 * <ulink type="http" url="https://developers.google.com/google-apps/documents-list/#terminology_used_in_this_guide";>online GData
@@ -264,7 +264,7 @@ gdata_documents_entry_class_init (GDataDocumentsEntryClass *klass)
 	                                                      G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
 
 	/**
-	 * GDataDocumentsEntry:last-modified-by
+	 * GDataDocumentsEntry:last-modified-by:
 	 *
 	 * Indicates the author of the last modification.
 	 *
diff --git a/gdata/services/picasaweb/gdata-picasaweb-album.c b/gdata/services/picasaweb/gdata-picasaweb-album.c
index a5a93d0..9dc2110 100644
--- a/gdata/services/picasaweb/gdata-picasaweb-album.c
+++ b/gdata/services/picasaweb/gdata-picasaweb-album.c
@@ -171,7 +171,7 @@ gdata_picasaweb_album_class_init (GDataPicasaWebAlbumClass *klass)
 	entry_class->kind_term = "http://schemas.google.com/photos/2007#album";;
 
 	/**
-	 * GDataPicasaWebAlbum:album-id
+	 * GDataPicasaWebAlbum:album-id:
 	 *
 	 * The ID of the album. This is a substring of the ID returned by gdata_entry_get_id() for #GDataPicasaWebAlbum<!-- -->s; for example,
 	 * if gdata_entry_get_id() returned "http://picasaweb.google.com/data/entry/user/libgdata.picasaweb/albumid/5328889949261497249"; for a
@@ -189,7 +189,7 @@ gdata_picasaweb_album_class_init (GDataPicasaWebAlbumClass *klass)
 	                                                      G_PARAM_READWRITE | G_PARAM_CONSTRUCT_ONLY | G_PARAM_STATIC_STRINGS));
 
 	/**
-	 * GDataPicasaWebAlbum:user
+	 * GDataPicasaWebAlbum:user:
 	 *
 	 * The username of the album owner.
 	 *
@@ -205,7 +205,7 @@ gdata_picasaweb_album_class_init (GDataPicasaWebAlbumClass *klass)
 	                                                      G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
 
 	/**
-	 * GDataPicasaWebAlbum:nickname
+	 * GDataPicasaWebAlbum:nickname:
 	 *
 	 * The user's nickname. This is a user-specified value that should be used when referring to the user by name.
 	 *
@@ -221,7 +221,7 @@ gdata_picasaweb_album_class_init (GDataPicasaWebAlbumClass *klass)
 	                                                      G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
 
 	/**
-	 * GDataPicasaWebAlbum:edited
+	 * GDataPicasaWebAlbum:edited:
 	 *
 	 * The time this album was last edited. If the album has not been edited yet, the content indicates the time it was created.
 	 *
@@ -237,7 +237,7 @@ gdata_picasaweb_album_class_init (GDataPicasaWebAlbumClass *klass)
 	                                                     G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
 
 	/**
-	 * GDataPicasaWebAlbum:location
+	 * GDataPicasaWebAlbum:location:
 	 *
 	 * The user-specified location associated with the album. A place name.
 	 *
@@ -253,7 +253,7 @@ gdata_picasaweb_album_class_init (GDataPicasaWebAlbumClass *klass)
 	                                                      G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 
 	/**
-	 * GDataPicasaWebAlbum:visibility
+	 * GDataPicasaWebAlbum:visibility:
 	 *
 	 * The visibility (or access rights) of the album.
 	 *
@@ -269,7 +269,7 @@ gdata_picasaweb_album_class_init (GDataPicasaWebAlbumClass *klass)
 	                                                    G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 
 	/**
-	 * GDataPicasaWebAlbum:timestamp
+	 * GDataPicasaWebAlbum:timestamp:
 	 *
 	 * The timestamp of when the album occurred, settable by the user. This a UNIX timestamp in milliseconds (not seconds) since the epoch.
 	 *
@@ -286,7 +286,7 @@ gdata_picasaweb_album_class_init (GDataPicasaWebAlbumClass *klass)
 
 	/* TODO: Change to photo-count? */
 	/**
-	 * GDataPicasaWebAlbum:num-photos
+	 * GDataPicasaWebAlbum:num-photos:
 	 *
 	 * The number of photos and videos in the album.
 	 *
@@ -303,7 +303,7 @@ gdata_picasaweb_album_class_init (GDataPicasaWebAlbumClass *klass)
 
 	/* TODO: Change to remaining-photos-count? */
 	/**
-	 * GDataPicasaWebAlbum:num-photos-remaining
+	 * GDataPicasaWebAlbum:num-photos-remaining:
 	 *
 	 * The number of photos and videos that can still be uploaded to this album.
 	 * This doesn't account for quota, just a hardcoded maximum number per album set by Google.



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]