summaryrefslogtreecommitdiff
path: root/backends/libsocialweb/lib
diff options
context:
space:
mode:
authorPhilip Withnall <philip@tecnocode.co.uk>2012-04-24 00:02:43 +0100
committerPhilip Withnall <philip@tecnocode.co.uk>2012-04-25 22:28:58 +0100
commit186a237ba31d9bb392a48511ab2b95bdb4352d2c (patch)
treef24228e00fd2f5754c755fc9a048e1ad2ebbe106 /backends/libsocialweb/lib
parentcacb8622b1346ae09d6581ea7195be0ed760d0f1 (diff)
Bug 663890 — @throws annotations missing for some functions
Add missing ‘@throws’ annotations to various public methods. Closes: https://bugzilla.gnome.org/show_bug.cgi?id=663890
Diffstat (limited to 'backends/libsocialweb/lib')
-rw-r--r--backends/libsocialweb/lib/swf-persona-store.vala10
1 files changed, 10 insertions, 0 deletions
diff --git a/backends/libsocialweb/lib/swf-persona-store.vala b/backends/libsocialweb/lib/swf-persona-store.vala
index 6bb4b1d0..e8736ef5 100644
--- a/backends/libsocialweb/lib/swf-persona-store.vala
+++ b/backends/libsocialweb/lib/swf-persona-store.vala
@@ -195,6 +195,9 @@ public class Swf.PersonaStore : Folks.PersonaStore
* Add a new {@link Persona} to the PersonaStore.
*
* See {@link Folks.PersonaStore.add_persona_from_details}.
+ *
+ * @throws Folks.PersonaStoreError.READ_ONLY every time — libsocialweb is
+ * read-only
*/
public override async Folks.Persona? add_persona_from_details (
HashTable<string, Value?> details) throws Folks.PersonaStoreError
@@ -207,6 +210,9 @@ public class Swf.PersonaStore : Folks.PersonaStore
* Remove a {@link Persona} from the PersonaStore.
*
* See {@link Folks.PersonaStore.remove_persona}.
+ *
+ * @throws Folks.PersonaStoreError.READ_ONLY every time — libsocialweb is
+ * read-only
*/
public override async void remove_persona (Folks.Persona persona)
throws Folks.PersonaStoreError
@@ -303,6 +309,10 @@ public class Swf.PersonaStore : Folks.PersonaStore
* Prepare the PersonaStore for use.
*
* See {@link Folks.PersonaStore.prepare}.
+ *
+ * @throws Folks.PersonaStoreError.INVALID_ARGUMENT if the libsocialweb
+ * service capabilities couldn’t be retrieved, or if the ‘contacts’ capability
+ * wasn’t found, or if a view couldn’t be opened
*/
public override async void prepare () throws GLib.Error
{