-/* typical parameter-less _new function */
-/* if this is a kind of GtkWidget, it should probably return at GtkWidget* */
-ModestTnySendQueue* modest_tny_send_queue_new (TnyTransportAccount *account);
+
+/**
+ * modest_tny_send_queue_new:
+ * @account: a valid camel transport account
+ *
+ * create a new modest #ModestTnySendQueue object.
+ *
+ * Returns: a new #ModestTnySendQueue instance, or NULL in case
+ * of any error
+ */
+ModestTnySendQueue* modest_tny_send_queue_new (TnyCamelTransportAccount *account);
+
+
+
+/**
+ * modest_tny_send_queue_flush:
+ * @self: a valid #ModestTnySendQueue instance
+ *
+ * (try to) send the messages in the outbox folder
+ *
+ */
+void modest_tny_send_queue_flush (ModestTnySendQueue* self);
+