* Parses a string representing a mailing address into a
* structure of type #EAddressWestern.
*
- * Return value: A new #EAddressWestern structure, or %NULL if the parsing failed.
+ * Returns: A new #EAddressWestern structure, or %NULL if the parsing failed.
**/
EAddressWestern *
e_address_western_parse (const gchar *in_address)
*
* Create a new #EBookQuery which is the logical AND of the queries in #qs.
*
- * Return value: A new #EBookQuery
+ * Returns: A new #EBookQuery
**/
EBookQuery *
e_book_query_and (gint nqs, EBookQuery **qs, gboolean unref)
*
* Creates a new #EBookQuery which is the logical OR of the queries in #qs.
*
- * Return value: A new #EBookQuery
+ * Returns: A new #EBookQuery
**/
EBookQuery *
e_book_query_or (gint nqs, EBookQuery **qs, gboolean unref)
*
* Creates a new #EBookQuery which is the logical AND of the queries specified.
*
- * Return value: A new #EBookQuery
+ * Returns: A new #EBookQuery
**/
EBookQuery *
e_book_query_andv (EBookQuery *q, ...)
*
* Creates a new #EBookQuery which is the logical OR of the queries specified.
*
- * Return value: A new #EBookQuery
+ * Returns: A new #EBookQuery
**/
EBookQuery *
e_book_query_orv (EBookQuery *q, ...)
*
* Creates a new #EBookQuery which is the opposite of #q.
*
- * Return value: the new #EBookQuery
+ * Returns: the new #EBookQuery
**/
EBookQuery *
e_book_query_not (EBookQuery *q, gboolean unref)
*
* Creates a new #EBookQuery which tests @field for @value using the test @test.
*
- * Return value: the new #EBookQuery
+ * Returns: the new #EBookQuery
**/
EBookQuery *
e_book_query_field_test (EContactField field,
*
* Creates a new #EBookQuery which tests @field for @value using the test @test.
*
- * Return value: the new #EBookQuery
+ * Returns: the new #EBookQuery
*
* Since: 2.22
**/
* @field: a #EContactField
*
* Creates a new #EBookQuery which tests if the field @field exists.
- * Return value: the new #EBookQuery
+ * Returns: the new #EBookQuery
**/
EBookQuery *
e_book_query_field_exists (EContactField field)
*
* Creates a new #EBookQuery which tests if the field @field exists. @field
* should be a vCard field name, such as #FN or #X-MSN.
- * Return value: the new #EBookQuery
+ * Returns: the new #EBookQuery
**/
EBookQuery *
e_book_query_vcard_field_exists (const gchar *field)
*
* Creates a new #EBookQuery which tests if any field contains @value.
*
- * Return value: the new #EBookQuery
+ * Returns: the new #EBookQuery
**/
EBookQuery *
e_book_query_any_field_contains (const gchar *value)
* @q: a #EBookQuery
*
* Increment the reference count on @q.
- * Return value: @q
+ * Returns: @q
**/
EBookQuery *
e_book_query_ref (EBookQuery *q)
*
* Parse @query_string and return a new #EBookQuery representing it.
*
- * Return value: the new #EBookQuery.
+ * Returns: the new #EBookQuery.
**/
EBookQuery*
e_book_query_from_string (const gchar *query_string)
*
* Return the string representation of @q.
*
- * Return value: The string form of the query. This string should be freed when
+ * Returns: The string form of the query. This string should be freed when
* finished with.
**/
gchar *
*
* Creates a copy of @q.
*
- * Return value: A new #EBookQuery identical to @q.
+ * Returns: A new #EBookQuery identical to @q.
**/
EBookQuery*
e_book_query_copy (EBookQuery *q)
* is a private function, applications should call #e_book_get_book_view or
* #e_book_async_get_book_view.
*
- * Return value: A new #EBookView.
+ * Returns: A new #EBookView.
**/
EBookView *
_e_book_view_new (EBook *book, DBusGProxy *view_proxy, GStaticRecMutex *view_proxy_lock)
*
* Returns the #EBook that this book view is monitoring.
*
- * Return value: an #EBook.
+ * Returns: an #EBook.
*
* Since: 2.22
**/
*
* Adds @contact to @book.
*
- * Return value: %TRUE if successful, %FALSE otherwise.
+ * Returns: %TRUE if successful, %FALSE otherwise.
**/
gboolean
e_book_add_contact (EBook *book,
*
* Adds @contact to @book without blocking.
*
- * Return value: %TRUE if the operation was started, %FALSE otherwise.
+ * Returns: %TRUE if the operation was started, %FALSE otherwise.
**/
gboolean
e_book_async_add_contact (EBook *book,
* Applies the changes made to @contact to the stored version in
* @book.
*
- * Return value: %TRUE if successful, %FALSE otherwise
+ * Returns: %TRUE if successful, %FALSE otherwise
**/
gboolean
e_book_commit_contact (EBook *book,
* Applies the changes made to @contact to the stored version in
* @book without blocking.
*
- * Return value: %TRUE if the operation was started, %FALSE otherwise.
+ * Returns: %TRUE if the operation was started, %FALSE otherwise.
**/
guint
e_book_async_commit_contact (EBook *book,
* to allocated strings, and both the #GList and the strings
* must be freed by the caller.
*
- * Return value: %TRUE if successful, %FALSE otherwise.
+ * Returns: %TRUE if successful, %FALSE otherwise.
**/
gboolean
e_book_get_required_fields (EBook *book,
* Gets a list of fields that are required to be filled in for
* all contacts in this @book. This function does not block.
*
- * Return value: %TRUE if the operation was started, %FALSE otherwise.
+ * Returns: %TRUE if the operation was started, %FALSE otherwise.
**/
guint
e_book_async_get_required_fields (EBook *book,
* will contain pointers to allocated strings, and both the
* #GList and the strings must be freed by the caller.
*
- * Return value: %TRUE if successful, %FALSE otherwise
+ * Returns: %TRUE if successful, %FALSE otherwise
**/
gboolean
e_book_get_supported_fields (EBook *book,
* in this @book. Other fields may be discarded. This
* function does not block.
*
- * Return value: %TRUE if successful, %FALSE otherwise.
+ * Returns: %TRUE if successful, %FALSE otherwise.
**/
guint
e_book_async_get_supported_fields (EBook *book,
* The list will contain pointers to allocated strings, and both the
* #GList and the strings must be freed by the caller.
*
- * Return value: %TRUE if successful, %FALSE otherwise
+ * Returns: %TRUE if successful, %FALSE otherwise
**/
gboolean
e_book_get_supported_auth_methods (EBook *book,
* Queries @book for the list of authentication methods it supports.
* This function does not block.
*
- * Return value: %TRUE if successful, %FALSE otherwise.
+ * Returns: %TRUE if successful, %FALSE otherwise.
**/
guint
e_book_async_get_supported_auth_methods (EBook *book,
* @auth_method. @auth_method must be one of the authentication
* methods returned using e_book_get_supported_auth_methods.
*
- * Return value: %TRUE if successful, %FALSE otherwise
+ * Returns: %TRUE if successful, %FALSE otherwise
**/
gboolean
e_book_authenticate_user (EBook *book,
* methods returned using e_book_get_supported_auth_methods.
* This function does not block.
*
- * Return value: %FALSE if successful, %TRUE otherwise.
+ * Returns: %FALSE if successful, %TRUE otherwise.
**/
guint
e_book_async_authenticate_user (EBook *book,
* Fills in @contact with the contents of the vcard in @book
* corresponding to @id.
*
- * Return value: %TRUE if successful, %FALSE otherwise
+ * Returns: %TRUE if successful, %FALSE otherwise
**/
gboolean
e_book_get_contact (EBook *book,
*
* Retrieves a contact specified by @id from @book.
*
- * Return value: %FALSE if successful, %TRUE otherwise
+ * Returns: %FALSE if successful, %TRUE otherwise
**/
guint
e_book_async_get_contact (EBook *book,
*
* Removes the contact with id @id from @book.
*
- * Return value: %TRUE if successful, %FALSE otherwise
+ * Returns: %TRUE if successful, %FALSE otherwise
**/
gboolean
e_book_remove_contact (EBook *book,
* have more than one id to remove, as some backends can implement it
* as a batch request.
*
- * Return value: %TRUE if successful, %FALSE otherwise
+ * Returns: %TRUE if successful, %FALSE otherwise
**/
gboolean
e_book_remove_contacts (EBook *book,
*
* Removes @contact from @book.
*
- * Return value: %TRUE if successful, %FALSE otherwise
+ * Returns: %TRUE if successful, %FALSE otherwise
**/
guint
e_book_async_remove_contact (EBook *book,
*
* Removes the contact with id @id from @book.
*
- * Return value: %TRUE if successful, %FALSE otherwise
+ * Returns: %TRUE if successful, %FALSE otherwise
**/
guint
e_book_async_remove_contact_by_id (EBook *book,
* have more than one id to remove, as some backends can implement it
* as a batch request.
*
- * Return value: %TRUE if successful, %FALSE otherwise
+ * Returns: %TRUE if successful, %FALSE otherwise
**/
guint
e_book_async_remove_contacts (EBook *book,
* specified by @requested_fields and limited at @max_results records. On an
* error, @error is set and %FALSE returned.
*
- * Return value: %TRUE if successful, %FALSE otherwise
+ * Returns: %TRUE if successful, %FALSE otherwise
**/
gboolean
e_book_get_book_view (EBook *book,
* Query @book with @query, creating a #EBookView with the fields
* specified by @requested_fields and limited at @max_results records.
*
- * Return value: %FALSE if successful, %TRUE otherwise
+ * Returns: %FALSE if successful, %TRUE otherwise
**/
guint
e_book_async_get_book_view (EBook *book,
* Query @book with @query, setting @contacts to the list of contacts which
* matched. On failed, @error will be set and %FALSE returned.
*
- * Return value: %TRUE on success, %FALSE otherwise
+ * Returns: %TRUE on success, %FALSE otherwise
**/
gboolean
e_book_get_contacts (EBook *book,
*
* Query @book with @query.
*
- * Return value: %FALSE on success, %TRUE otherwise
+ * Returns: %FALSE on success, %TRUE otherwise
**/
guint
e_book_async_get_contacts (EBook *book,
* Get the set of changes since the previous call to #e_book_get_changes for a
* given change ID.
*
- * Return value: TRUE on success, FALSE otherwise
+ * Returns: TRUE on success, FALSE otherwise
*/
gboolean
e_book_get_changes (EBook *book,
* Get the set of changes since the previous call to #e_book_async_get_changes
* for a given change ID.
*
- * Return value: TRUE on success, FALSE otherwise
+ * Returns: TRUE on success, FALSE otherwise
*/
guint
e_book_async_get_changes (EBook *book,
* blocked e_book function corresponding to current operation will
* return with a status of E_BOOK_STATUS_CANCELLED.
*
- * Return value: %TRUE on success, %FALSE otherwise
+ * Returns: %TRUE on success, %FALSE otherwise
**/
gboolean
e_book_cancel (EBook *book,
*
* Opens the addressbook, making it ready for queries and other operations.
*
- * Return value: %TRUE if the book was successfully opened, %FALSE otherwise.
+ * Returns: %TRUE if the book was successfully opened, %FALSE otherwise.
*/
gboolean
e_book_open (EBook *book,
* Opens the addressbook, making it ready for queries and other operations.
* This function does not block.
*
- * Return value: %FALSE if successful, %TRUE otherwise.
+ * Returns: %FALSE if successful, %TRUE otherwise.
**/
guint
e_book_async_open (EBook *book,
* Removes the backing data for this #EBook. For example, with the file backend this
* deletes the database file. You cannot get it back!
*
- * Return value: %TRUE on success, %FALSE on failure.
+ * Returns: %TRUE on success, %FALSE on failure.
*/
gboolean
e_book_remove (EBook *book,
* Remove the backing data for this #EBook. For example, with the file backend this
* deletes the database file. You cannot get it back!
*
- * Return value: %FALSE if successful, %TRUE otherwise.
+ * Returns: %FALSE if successful, %TRUE otherwise.
**/
guint
e_book_async_remove (EBook *book,
*
* Get the URI that this book has loaded. This string should not be freed.
*
- * Return value: The URI.
+ * Returns: The URI.
*/
const gchar *
e_book_get_uri (EBook *book)
*
* Get the #ESource that this book has loaded.
*
- * Return value: The source.
+ * Returns: The source.
*/
ESource *
e_book_get_source (EBook *book)
* Get the list of capabilities which the backend for this address book
* supports. This string should not be freed.
*
- * Return value: The capabilities list
+ * Returns: The capabilities list
*/
const gchar *
e_book_get_static_capabilities (EBook *book,
* Check to see if the backend for this address book supports the capability
* @cap.
*
- * Return value: %TRUE if the backend supports @cap, %FALSE otherwise.
+ * Returns: %TRUE if the backend supports @cap, %FALSE otherwise.
*/
gboolean
e_book_check_static_capability (EBook *book,
*
* Check if this book has been opened.
*
- * Return value: %TRUE if this book has been opened, otherwise %FALSE.
+ * Returns: %TRUE if this book has been opened, otherwise %FALSE.
*/
gboolean
e_book_is_opened (EBook *book)
*
* Check if this book is writable.
*
- * Return value: %TRUE if this book is writable, otherwise %FALSE.
+ * Returns: %TRUE if this book is writable, otherwise %FALSE.
*/
gboolean
e_book_is_writable (EBook *book)
*
* Check if this book is connected.
*
- * Return value: %TRUE if this book is connected, otherwise %FALSE.
+ * Returns: %TRUE if this book is connected, otherwise %FALSE.
**/
gboolean
e_book_is_online (EBook *book)
* Get the #EContact referring to the user of the address book
* and set it in @contact and @book.
*
- * Return value: %TRUE if successful, otherwise %FALSE.
+ * Returns: %TRUE if successful, otherwise %FALSE.
**/
gboolean
e_book_get_self (EContact **contact, EBook **book, GError **error)
* Specify that @contact residing in @book is the #EContact that
* refers to the user of the address book.
*
- * Return value: %TRUE if successful, %FALSE otherwise.
+ * Returns: %TRUE if successful, %FALSE otherwise.
**/
gboolean
e_book_set_self (EBook *book, EContact *contact, GError **error)
*
* Check if @contact is the user of the address book.
*
- * Return value: %TRUE if @contact is the user, %FALSE otherwise.
+ * Returns: %TRUE if @contact is the user, %FALSE otherwise.
**/
gboolean
e_book_is_self (EContact *contact)
* sets the #ESource of the #EBook as the "default" addressbook. This is the source
* that will be loaded in the e_book_get_default_addressbook call.
*
- * Return value: %TRUE if the setting was stored in libebook's ESourceList, otherwise %FALSE.
+ * Returns: %TRUE if the setting was stored in libebook's ESourceList, otherwise %FALSE.
*/
gboolean
e_book_set_default_addressbook (EBook *book, GError **error)
* sets @source as the "default" addressbook. This is the source that
* will be loaded in the e_book_get_default_addressbook call.
*
- * Return value: %TRUE if the setting was stored in libebook's ESourceList, otherwise %FALSE.
+ * Returns: %TRUE if the setting was stored in libebook's ESourceList, otherwise %FALSE.
*/
gboolean
e_book_set_default_source (ESource *source, GError **error)
* Populate *addressbook_sources with the list of all sources which have been
* added to Evolution.
*
- * Return value: %TRUE if @addressbook_sources was set, otherwise %FALSE.
+ * Returns: %TRUE if @addressbook_sources was set, otherwise %FALSE.
*/
gboolean
e_book_get_addressbooks (ESourceList **addressbook_sources, GError **error)
* only two operations that are valid on this book at this point:
* e_book_open(), and e_book_remove().
*
- * Return value: a new but unopened #EBook.
+ * Returns: a new but unopened #EBook.
*/
EBook*
e_book_new (ESource *source, GError **error)
* Creates a new #EBook corresponding to the given uri. See the
* documentation for e_book_new for further information.
*
- * Return value: a new but unopened #EBook.
+ * Returns: a new but unopened #EBook.
*/
EBook*
e_book_new_from_uri (const gchar *uri, GError **error)
* addressbook. See the documentation for e_book_new for further
* information.
*
- * Return value: a new but unopened #EBook.
+ * Returns: a new but unopened #EBook.
*/
EBook*
e_book_new_system_addressbook (GError **error)
* addressbook. See the documentation for e_book_new for further
* information.
*
- * Return value: a new but unopened #EBook.
+ * Returns: a new but unopened #EBook.
*/
EBook*
e_book_new_default_addressbook (GError **error)
*
* Creates a new, blank #EContact.
*
- * Return value: A new #EContact.
+ * Returns: A new #EContact.
**/
EContact*
e_contact_new (void)
*
* Creates a new #EContact based on a vcard.
*
- * Return value: A new #EContact.
+ * Returns: A new #EContact.
**/
EContact*
e_contact_new_from_vcard (const gchar *vcard)
*
* Creates a copy of @contact.
*
- * Return value: A new #EContact identical to @contact.
+ * Returns: A new #EContact identical to @contact.
**/
EContact*
e_contact_duplicate (EContact *contact)
*
* Gets the string representation of @field_id.
*
- * Return value: The string representation of @field_id, or %NULL if it doesn't exist.
+ * Returns: The string representation of @field_id, or %NULL if it doesn't exist.
**/
const gchar *
e_contact_field_name (EContactField field_id)
* Gets a human-readable, translated string representation
* of @field_id.
*
- * Return value: The human-readable representation of @field_id, or %NULL if it doesn't exist.
+ * Returns: The human-readable representation of @field_id, or %NULL if it doesn't exist.
**/
const gchar *
e_contact_pretty_name (EContactField field_id)
*
* Gets the vcard attribute corresponding to @field_id, as a string.
*
- * Return value: The vcard attribute corresponding to @field_id, or %NULL if it doesn't exist.
+ * Returns: The vcard attribute corresponding to @field_id, or %NULL if it doesn't exist.
**/
const gchar *
e_contact_vcard_attribute (EContactField field_id)
*
* Gets the #EContactField corresponding to the @field_name.
*
- * Return value: An #EContactField corresponding to @field_name, or %0 if it doesn't exist.
+ * Returns: An #EContactField corresponding to @field_name, or %0 if it doesn't exist.
**/
EContactField
e_contact_field_id (const gchar *field_name)
*
* Gets the #EContactField corresponding to the @vcard_field.
*
- * Return value: An #EContactField corresponding to @vcard_field, or %0 if it doesn't exist.
+ * Returns: An #EContactField corresponding to @vcard_field, or %0 if it doesn't exist.
*
* Since: 2.26
**/
*
* Gets the value of @contact's field specified by @field_id.
*
- * Return value: Depends on the field's type, owned by the caller.
+ * Returns: Depends on the field's type, owned by the caller.
**/
gpointer
e_contact_get (EContact *contact, EContactField field_id)
* Gets the value of @contact's field specified by @field_id, caching
* the result so it can be freed later.
*
- * Return value: Depends on the field's type, owned by the #EContact.
+ * Returns: Depends on the field's type, owned by the #EContact.
**/
gconstpointer
e_contact_get_const (EContact *contact, EContactField field_id)
*
* Gets a list of the vcard attributes for @contact's @field_id.
*
- * Return value: A #GList of pointers to #EVCardAttribute, owned by the caller.
+ * Returns: A #GList of pointers to #EVCardAttribute, owned by the caller.
**/
GList*
e_contact_get_attributes (EContact *contact, EContactField field_id)
*
* Creates a new #EContactName struct.
*
- * Return value: A new #EContactName struct.
+ * Returns: A new #EContactName struct.
**/
EContactName*
e_contact_name_new (void)
*
* Generates a string representation of @name.
*
- * Return value: The string representation of @name.
+ * Returns: The string representation of @name.
**/
gchar *
e_contact_name_to_string(const EContactName *name)
*
* Creates a new #EContactName based on the parsed @name_str.
*
- * Return value: A new #EContactName struct.
+ * Returns: A new #EContactName struct.
**/
EContactName*
e_contact_name_from_string (const gchar *name_str)
*
* Creates a copy of @n.
*
- * Return value: A new #EContactName identical to @n.
+ * Returns: A new #EContactName identical to @n.
**/
EContactName*
e_contact_name_copy (EContactName *n)
*
* Creates a new #EContactDate based on @str.
*
- * Return value: A new #EContactDate struct.
+ * Returns: A new #EContactDate struct.
**/
EContactDate*
e_contact_date_from_string (const gchar *str)
* Generates a date string in the format YYYY-MM-DD based
* on the values of @dt.
*
- * Return value: A date string, owned by the caller.
+ * Returns: A date string, owned by the caller.
**/
gchar *
e_contact_date_to_string (EContactDate *dt)
*
* Checks if @dt1 and @dt2 are the same date.
*
- * Return value: %TRUE if @dt1 and @dt2 are equal, %FALSE otherwise.
+ * Returns: %TRUE if @dt1 and @dt2 are equal, %FALSE otherwise.
**/
gboolean
e_contact_date_equal (EContactDate *dt1, EContactDate *dt2)
*
* Creates a copy of @dt.
*
- * Return value: A new #EContactDate struct identical to @dt.
+ * Returns: A new #EContactDate struct identical to @dt.
**/
static EContactDate *
e_contact_date_copy (EContactDate *dt)
*
* Creates a new #EContactDate struct.
*
- * Return value: A new #EContactDate struct.
+ * Returns: A new #EContactDate struct.
**/
EContactDate*
e_contact_date_new (void)
*
* Creates a copy of @photo.
*
- * Return value: A new #EContactPhoto struct identical to @photo.
+ * Returns: A new #EContactPhoto struct identical to @photo.
**/
static EContactPhoto *
e_contact_photo_copy (EContactPhoto *photo)
*
* Creates a new #EDestination with blank values.
*
- * Return value: A newly created #EDestination.
+ * Returns: A newly created #EDestination.
**/
EDestination *
e_destination_new (void)
*
* Creates a new #EDestination identical to @dest.
*
- * Return value: A newly created #EDestination, identical to @dest.
+ * Returns: A newly created #EDestination, identical to @dest.
*/
EDestination*
e_destination_copy (const EDestination *dest)
*
* Checks if @dest is blank.
*
- * Return value: %TRUE if @dest is empty, %FALSE otherwise.
+ * Returns: %TRUE if @dest is empty, %FALSE otherwise.
*/
gboolean
e_destination_empty (const EDestination *dest)
*
* Checks if @a and @b are equal.
*
- * Return value: %TRUE if the destinations are equal, %FALSE otherwise.
+ * Returns: %TRUE if the destinations are equal, %FALSE otherwise.
**/
gboolean
e_destination_equal (const EDestination *a, const EDestination *b)
* it was not explicitly specified by the user. This can be used
* to hide it from some UI elements.
*
- * Return value: %TRUE if destination is an auto recipient, %FALSE otherwise.
+ * Returns: %TRUE if destination is an auto recipient, %FALSE otherwise.
**/
gboolean
e_destination_is_auto_recipient (const EDestination *dest)
*
* Gets the contact @dest is pointing to, if any.
*
- * Return value: An #EContact, or %NULL if none was set.
+ * Returns: An #EContact, or %NULL if none was set.
**/
EContact *
e_destination_get_contact (const EDestination *dest)
*
* Gets the unique contact ID @dest is pointing to, if any.
*
- * Return value: A unique contact ID, or %NULL if none was set.
+ * Returns: A unique contact ID, or %NULL if none was set.
*/
const gchar *
e_destination_get_contact_uid (const EDestination *dest)
* Gets the unique source ID @dest is pointing to, if any. The source
* ID specifies which address book @dest's contact came from.
*
- * Return value: A unique source ID, or %NULL if none was set.
+ * Returns: A unique source ID, or %NULL if none was set.
*/
const gchar *
e_destination_get_source_uid (const EDestination *dest)
* Gets the index of the e-mail address of the contact that
* @dest is pointing to, if any.
*
- * Return value: The e-mail index, or -1 if none was set.
+ * Returns: The e-mail index, or -1 if none was set.
**/
gint
e_destination_get_email_num (const EDestination *dest)
* Gets the full name of @dest's addressee, or if the addressee is
* a contact list, the name the list was filed under.
*
- * Return value: The full name of the addressee, or %NULL if none was set.
+ * Returns: The full name of the addressee, or %NULL if none was set.
**/
const gchar *
e_destination_get_name (const EDestination *dest)
*
* Check if @dest is to be ignored.
*
- * Return value: #TRUE if this destination should be ignored, else #FALSE.
+ * Returns: #TRUE if this destination should be ignored, else #FALSE.
*/
gboolean
e_destination_is_ignored (const EDestination *dest)
*
* Gets the e-mail address of @dest's addressee.
*
- * Return value: An e-mail address, or an empty string if none was set.
+ * Returns: An e-mail address, or an empty string if none was set.
**/
const gchar *
e_destination_get_email (const EDestination *dest)
* Gets the formatted name and e-mail address, or in the case of
* lists, the formatted list of e-mail addresses, from @dest.
*
- * Return value: A formatted destination string, or %NULL if the destination was empty.
+ * Returns: A formatted destination string, or %NULL if the destination was empty.
**/
const gchar *
e_destination_get_address (const EDestination *dest)
* Generates a textual representation of @dest, suitable for referring
* to the destination during user interaction.
*
- * Return value: A textual representation of the destination.
+ * Returns: A textual representation of the destination.
**/
const gchar *
e_destination_get_textrep (const EDestination *dest, gboolean include_email)
*
* Checks if @dest is a list of addresses.
*
- * Return value: %TRUE if destination is a list, %FALSE if it is an individual.
+ * Returns: %TRUE if destination is a list, %FALSE if it is an individual.
**/
gboolean
e_destination_is_evolution_list (const EDestination *dest)
* If @dest is a list, checks if the addresses in the list
* should be presented to the user during interaction.
*
- * Return value: %TRUE if addresses should be shown, %FALSE otherwise.
+ * Returns: %TRUE if addresses should be shown, %FALSE otherwise.
**/
gboolean
e_destination_list_show_addresses (const EDestination *dest)
* If @dest is a list, gets the list of destinations. The list
* and its elements belong to @dest, and should not be freed.
*
- * Return value: A list of elements of type #EDestination, or %NULL.
+ * Returns: A list of elements of type #EDestination, or %NULL.
**/
const GList *
e_destination_list_get_dests (const EDestination *dest)
*
* Check if @dest wants to get mail formatted as HTML.
*
- * Return value: %TRUE if destination wants HTML, %FALSE if not.
+ * Returns: %TRUE if destination wants HTML, %FALSE if not.
**/
gboolean
e_destination_get_html_mail_pref (const EDestination *dest)
* Generates a joint text representation of all the #EDestination
* elements in @destv.
*
- * Return value: The text representation of @destv.
+ * Returns: The text representation of @destv.
**/
gchar *
e_destination_get_textrepv (EDestination **destv)
*
* Generates an XML tree from @dest.
*
- * Return value: Pointer to the root node of the XML tree.
+ * Returns: Pointer to the root node of the XML tree.
**/
static xmlNodePtr
e_destination_xml_encode (const EDestination *dest)
* Initializes @dest based on the information encoded in the
* XML tree under @node.
*
- * Return value: %TRUE if the XML tree was well-formed, %FALSE otherwise.
+ * Returns: %TRUE if the XML tree was well-formed, %FALSE otherwise.
**/
static gboolean
e_destination_xml_decode (EDestination *dest, xmlNodePtr node)
*
* Exports a destination to an XML document.
*
- * Return value: An XML string, allocated with g_malloc.
+ * Returns: An XML string, allocated with g_malloc.
**/
gchar *
e_destination_export (const EDestination *dest)
*
* Creates an #EDestination from an XML document.
*
- * Return value: An #EDestination, or %NULL if the document was not well-formed.
+ * Returns: An #EDestination, or %NULL if the document was not well-formed.
**/
EDestination *
e_destination_import (const gchar *str)
*
* Exports multiple #EDestination elements to a single XML document.
*
- * Return value: An XML string, allocated with g_malloc.
+ * Returns: An XML string, allocated with g_malloc.
**/
gchar *
e_destination_exportv (EDestination **destv)
* Creates an array of pointers to #EDestination elements
* from an XML document.
*
- * Return value: A %NULL-terminated array of pointers to #EDestination elements.
+ * Returns: A %NULL-terminated array of pointers to #EDestination elements.
**/
EDestination **
e_destination_importv (const gchar *str)
* Parses @full_name and returns an #ENameWestern struct filled with
* the component parts of the name.
*
- * Return value: A new #ENameWestern struct.
+ * Returns: A new #ENameWestern struct.
**/
ENameWestern *
e_name_western_parse (const gchar *full_name)
*
* Escapes a string according to RFC2426, section 5.
*
- * Return value: A newly allocated, escaped string.
+ * Returns: A newly allocated, escaped string.
**/
gchar *
e_vcard_escape_string (const gchar *s)
*
* Unescapes a string according to RFC2426, section 5.
*
- * Return value: A newly allocated, unescaped string.
+ * Returns: A newly allocated, unescaped string.
**/
gchar *
e_vcard_unescape_string (const gchar *s)
*
* Creates a new, blank #EVCard.
*
- * Return value: A new, blank #EVCard.
+ * Returns: A new, blank #EVCard.
**/
EVCard *
e_vcard_new (void)
* Creates a new #EVCard from the passed-in string
* representation.
*
- * Return value: A new #EVCard.
+ * Returns: A new #EVCard.
**/
EVCard *
e_vcard_new_from_string (const gchar *str)
* Exports @evc to a string representation, specified
* by the @format argument.
*
- * Return value: A newly allocated string representing the vcard.
+ * Returns: A newly allocated string representing the vcard.
**/
gchar *
e_vcard_to_string (EVCard *evc, EVCardFormat format)
* Creates a new #EVCardAttribute with the specified group and
* attribute names.
*
- * Return value: A new #EVCardAttribute.
+ * Returns: A new #EVCardAttribute.
**/
EVCardAttribute*
e_vcard_attribute_new (const gchar *attr_group, const gchar *attr_name)
*
* Makes a copy of @attr.
*
- * Return value: A new #EVCardAttribute identical to @attr.
+ * Returns: A new #EVCardAttribute identical to @attr.
**/
EVCardAttribute*
e_vcard_attribute_copy (EVCardAttribute *attr)
*
* Creates a new parameter named @name.
*
- * Return value: A new #EVCardAttributeParam.
+ * Returns: A new #EVCardAttributeParam.
**/
EVCardAttributeParam*
e_vcard_attribute_param_new (const gchar *name)
*
* Makes a copy of @param.
*
- * Return value: a new #EVCardAttributeParam identical to @param.
+ * Returns: a new #EVCardAttributeParam identical to @param.
**/
EVCardAttributeParam*
e_vcard_attribute_param_copy (EVCardAttributeParam *param)
* Gets the list of attributes from @evcard. The list and its
* contents are owned by @evcard, and must not be freed.
*
- * Return value: A list of attributes of type #EVCardAttribute.
+ * Returns: A list of attributes of type #EVCardAttribute.
**/
GList*
e_vcard_get_attributes (EVCard *evcard)
* @evcard and should not be freed. If the attribute does not exist, #NULL is
* returned.
*
- * Return value: An #EVCardAttribute if found, or #NULL.
+ * Returns: An #EVCardAttribute if found, or #NULL.
**/
EVCardAttribute *
e_vcard_get_attribute (EVCard *evc,
*
* Gets the group name of @attr.
*
- * Return value: The attribute's group name.
+ * Returns: The attribute's group name.
**/
const gchar *
e_vcard_attribute_get_group (EVCardAttribute *attr)
*
* Gets the name of @attr.
*
- * Return value: The attribute's name.
+ * Returns: The attribute's name.
**/
const gchar *
e_vcard_attribute_get_name (EVCardAttribute *attr)
* Gets the list of values from @attr. The list and its
* contents are owned by @attr, and must not be freed.
*
- * Return value: A list of string values.
+ * Returns: A list of string values.
**/
GList*
e_vcard_attribute_get_values (EVCardAttribute *attr)
* necessary. The list and its contents are owned by @attr,
* and must not be freed.
*
- * Return value: A list of values of type #GString.
+ * Returns: A list of values of type #GString.
**/
GList*
e_vcard_attribute_get_values_decoded (EVCardAttribute *attr)
*
* Checks if @attr has a single value.
*
- * Return value: %TRUE if the attribute has exactly one value, %FALSE otherwise.
+ * Returns: %TRUE if the attribute has exactly one value, %FALSE otherwise.
**/
gboolean
e_vcard_attribute_is_single_valued (EVCardAttribute *attr)
*
* Gets the value of a single-valued #EVCardAttribute, @attr.
*
- * Return value: A newly allocated string representing the value.
+ * Returns: A newly allocated string representing the value.
**/
gchar *
e_vcard_attribute_get_value (EVCardAttribute *attr)
*
* Note: this function seems currently to be unused. Could be removed.
*
- * Return value: A newly allocated #GString representing the value.
+ * Returns: A newly allocated #GString representing the value.
**/
GString*
e_vcard_attribute_get_value_decoded (EVCardAttribute *attr)
*
* Checks if @attr has an #EVCardAttributeParam of the specified type.
*
- * Return value: %TRUE if such a parameter exists, %FALSE otherwise.
+ * Returns: %TRUE if such a parameter exists, %FALSE otherwise.
**/
gboolean
e_vcard_attribute_has_type (EVCardAttribute *attr, const gchar *typestr)
* Gets the list of parameters from @attr. The list and its
* contents are owned by @attr, and must not be freed.
*
- * Return value: A list of elements of type #EVCardAttributeParam.
+ * Returns: A list of elements of type #EVCardAttributeParam.
**/
GList*
e_vcard_attribute_get_params (EVCardAttribute *attr)
* Gets the list of values for the paramater @name from @attr. The list and its
* contents are owned by @attr, and must not be freed.
*
- * Return value: A list of string elements representing the parameter's values.
+ * Returns: A list of string elements representing the parameter's values.
**/
GList *
e_vcard_attribute_get_param (EVCardAttribute *attr, const gchar *name)
*
* Gets the name of @param.
*
- * Return value: The name of the parameter.
+ * Returns: The name of the parameter.
**/
const gchar *
e_vcard_attribute_param_get_name (EVCardAttributeParam *param)
* Gets the list of values from @param. The list and its
* contents are owned by @param, and must not be freed.
*
- * Return value: A list of string elements representing the parameter's values.
+ * Returns: A list of string elements representing the parameter's values.
**/
GList*
e_vcard_attribute_param_get_values (EVCardAttributeParam *param)
* Creates a new #EBookBackendCache object, which implements a local
* cache of #EContact objects, useful for remote backends.
*
- * Return value: A new #EBookBackendCache.
+ * Returns: A new #EBookBackendCache.
*/
EBookBackendCache *
e_book_backend_cache_new (const gchar *uri)
* newly created, and must be unreffed by the caller when no longer
* needed.
*
- * Return value: A cached #EContact, or %NULL if @uid is not cached.
+ * Returns: A cached #EContact, or %NULL if @uid is not cached.
**/
EContact *
e_book_backend_cache_get_contact (EBookBackendCache *cache, const gchar *uid)
*
* Adds @contact to @cache.
*
- * Return value: %TRUE if the contact was cached successfully, %FALSE otherwise.
+ * Returns: %TRUE if the contact was cached successfully, %FALSE otherwise.
**/
gboolean
e_book_backend_cache_add_contact (EBookBackendCache *cache,
*
* Removes the contact identified by @uid from @cache.
*
- * Return value: %TRUE if the contact was found and removed, %FALSE otherwise.
+ * Returns: %TRUE if the contact was found and removed, %FALSE otherwise.
**/
gboolean
e_book_backend_cache_remove_contact (EBookBackendCache *cache,
*
* Checks if the contact identified by @uid exists in @cache.
*
- * Return value: %TRUE if the cache contains the contact, %FALSE otherwise.
+ * Returns: %TRUE if the cache contains the contact, %FALSE otherwise.
**/
gboolean
e_book_backend_cache_check_contact (EBookBackendCache *cache, const gchar *uid)
* When done with the list, the caller must unref the contacts and
* free the list.
*
- * Return value: A #GList of pointers to #EContact.
+ * Returns: A #GList of pointers to #EContact.
**/
GList *
e_book_backend_cache_get_contacts (EBookBackendCache *cache, const gchar *query)
* in @cache matching @query. When done with the array, the caller must
* free the ID strings and the array.
*
- * Return value: A #GPtrArray of pointers to contact ID strings.
+ * Returns: A #GPtrArray of pointers to contact ID strings.
**/
GPtrArray *
e_book_backend_cache_search (EBookBackendCache *cache, const gchar *query)
*
* Checks if an #EBookBackendCache exists at @uri.
*
- * Return value: %TRUE if cache exists, %FALSE if not.
+ * Returns: %TRUE if cache exists, %FALSE if not.
**/
gboolean
e_book_backend_cache_exists (const gchar *uri)
*
* Checks if @cache is populated.
*
- * Return value: %TRUE if @cache is populated, %FALSE otherwise.
+ * Returns: %TRUE if @cache is populated, %FALSE otherwise.
**/
gboolean
e_book_backend_cache_is_populated (EBookBackendCache *cache)
* newly created, and must be unreffed by the caller when no longer
* needed.
*
- * Return value: A cached #EContact, or %NULL if @uid is not cached.
+ * Returns: A cached #EContact, or %NULL if @uid is not cached.
**/
EContact *
e_book_backend_db_cache_get_contact (DB *db, const gchar *uid)
*
* Adds @contact to @cache.
*
- * Return value: %TRUE if the contact was cached successfully, %FALSE otherwise.
+ * Returns: %TRUE if the contact was cached successfully, %FALSE otherwise.
**/
gboolean
e_book_backend_db_cache_add_contact (DB *db,
*
* Removes the contact identified by @uid from @cache.
*
- * Return value: %TRUE if the contact was found and removed, %FALSE otherwise.
+ * Returns: %TRUE if the contact was found and removed, %FALSE otherwise.
**/
gboolean
e_book_backend_db_cache_remove_contact (DB *db,
*
* Checks if the contact identified by @uid exists in @cache.
*
- * Return value: %TRUE if the cache contains the contact, %FALSE otherwise.
+ * Returns: %TRUE if the cache contains the contact, %FALSE otherwise.
**/
gboolean
e_book_backend_db_cache_check_contact (DB *db, const gchar *uid)
* When done with the list, the caller must unref the contacts and
* free the list.
*
- * Return value: A #GList of pointers to #EContact.
+ * Returns: A #GList of pointers to #EContact.
**/
GList *
e_book_backend_db_cache_get_contacts (DB *db, const gchar *query)
* in @cache matching @query. When done with the array, the caller must
* free the ID strings and the array.
*
- * Return value: A #GPtrArray of pointers to contact ID strings.
+ * Returns: A #GPtrArray of pointers to contact ID strings.
**/
GPtrArray *
e_book_backend_db_cache_search (DB *db, const gchar *query)
*
* Checks if an #EBookBackendCache exists at @uri.
*
- * Return value: %TRUE if cache exists, %FALSE if not.
+ * Returns: %TRUE if cache exists, %FALSE if not.
**/
gboolean
e_book_backend_db_cache_exists (const gchar *uri)
*
* Checks if @cache is populated.
*
- * Return value: %TRUE if @cache is populated, %FALSE otherwise.
+ * Returns: %TRUE if @cache is populated, %FALSE otherwise.
**/
gboolean
e_book_backend_db_cache_is_populated (DB *db)
*
* Gets the protocol that @factory creates backends for.
*
- * Return value: A string representing a protocol.
+ * Returns: A string representing a protocol.
**/
const gchar *
e_book_backend_factory_get_protocol (EBookBackendFactory *factory)
*
* Creates a new #EBookBackend with @factory's protocol.
*
- * Return value: A new #EBookBackend.
+ * Returns: A new #EBookBackend.
**/
EBookBackend*
e_book_backend_factory_new_backend (EBookBackendFactory *factory)
*
* Checks if @contact matches @sexp.
*
- * Return value: %TRUE if the contact matches, %FALSE otherwise.
+ * Returns: %TRUE if the contact matches, %FALSE otherwise.
**/
gboolean
e_book_backend_sexp_match_contact (EBookBackendSExp *sexp, EContact *contact)
*
* Checks if @vcard matches @sexp.
*
- * Return value: %TRUE if the VCard matches, %FALSE otherwise.
+ * Returns: %TRUE if the VCard matches, %FALSE otherwise.
**/
gboolean
e_book_backend_sexp_match_vcard (EBookBackendSExp *sexp, const gchar *vcard)
*
* Creates a new #EBookBackendSExp from @text.
*
- * Return value: A new #EBookBackendSExp.
+ * Returns: A new #EBookBackendSExp.
**/
EBookBackendSExp *
e_book_backend_sexp_new (const gchar *text)
* specifies how much time should elapse, at a minimum, from
* the summary is changed until it is flushed to disk.
*
- * Return value: A new #EBookBackendSummary.
+ * Returns: A new #EBookBackendSummary.
**/
EBookBackendSummary*
e_book_backend_summary_new (const gchar *summary_path, gint flush_timeout_millis)
* the file was located, it was in the correct format, and it was
* not out of date.
*
- * Return value: %TRUE if the load succeeded, %FALSE if it failed.
+ * Returns: %TRUE if the load succeeded, %FALSE if it failed.
**/
gboolean
e_book_backend_summary_load (EBookBackendSummary *summary)
*
* Attempts to save @summary to disk.
*
- * Return value: %TRUE if the save succeeded, %FALSE otherwise.
+ * Returns: %TRUE if the save succeeded, %FALSE otherwise.
**/
gboolean
e_book_backend_summary_save (EBookBackendSummary *summary)
* Checks if a summary of the contact identified by @id
* exists in @summary.
*
- * Return value: %TRUE if the summary exists, %FALSE otherwise.
+ * Returns: %TRUE if the summary exists, %FALSE otherwise.
**/
gboolean
e_book_backend_summary_check_contact (EBookBackendSummary *summary, const gchar *id)
*
* Checks if @summary is more recent than @t.
*
- * Return value: %TRUE if the summary is up to date, %FALSE otherwise.
+ * Returns: %TRUE if the summary is up to date, %FALSE otherwise.
**/
gboolean
e_book_backend_summary_is_up_to_date (EBookBackendSummary *summary, time_t t)
* Checks if @query can be satisfied by searching only the fields
* stored by @summary.
*
- * Return value: %TRUE if the query can be satisfied, %FALSE otherwise.
+ * Returns: %TRUE if the query can be satisfied, %FALSE otherwise.
**/
gboolean
e_book_backend_summary_is_summary_query (EBookBackendSummary *summary, const gchar *query)
*
* Searches @summary for contacts matching @query.
*
- * Return value: A #GPtrArray of pointers to contact ID strings.
+ * Returns: A #GPtrArray of pointers to contact ID strings.
**/
GPtrArray*
e_book_backend_summary_search (EBookBackendSummary *summary, const gchar *query)
* Constructs and returns a VCard from the contact summary specified
* by @id.
*
- * Return value: A new VCard, or %NULL if the contact summary didn't exist.
+ * Returns: A new VCard, or %NULL if the contact summary didn't exist.
**/
gchar *
e_book_backend_summary_get_summary_vcard(EBookBackendSummary *summary, const gchar *id)
*
* Does nothing.
*
- * Return value: %TRUE.
+ * Returns: %TRUE.
**/
gboolean
e_book_backend_sync_construct (EBookBackendSync *backend)
*
* Creates a new contact with the contents of @vcard in @backend.
*
- * Return value: An #EBookBackendSyncStatus indicating the outcome of the operation.
+ * Returns: An #EBookBackendSyncStatus indicating the outcome of the operation.
**/
EBookBackendSyncStatus
e_book_backend_sync_create_contact (EBookBackendSync *backend,
* Remove @book's database and storage overhead from the storage
* medium. This will delete all contacts in @book.
*
- * Return value: An #EBookBackendSyncStatus indicating the outcome of the operation.
+ * Returns: An #EBookBackendSyncStatus indicating the outcome of the operation.
**/
EBookBackendSyncStatus
e_book_backend_sync_remove (EBookBackendSync *backend,
* of removed contacts is in the same format as the passed-in list, and must be
* freed by the caller.
*
- * Return value: An #EBookBackendSyncStatus indicating the outcome of the operation.
+ * Returns: An #EBookBackendSyncStatus indicating the outcome of the operation.
**/
EBookBackendSyncStatus
e_book_backend_sync_remove_contacts (EBookBackendSync *backend,
* Modifies the contact specified by the ID embedded in @vcard, to
* reflect the full contents of @vcard.
*
- * Return value: An #EBookBackendSyncStatus indicating the outcome of the operation.
+ * Returns: An #EBookBackendSyncStatus indicating the outcome of the operation.
**/
EBookBackendSyncStatus
e_book_backend_sync_modify_contact (EBookBackendSync *backend,
*
* Gets a contact from @book.
*
- * Return value: An #EBookBackendSyncStatus indicating the outcome of the operation.
+ * Returns: An #EBookBackendSyncStatus indicating the outcome of the operation.
**/
EBookBackendSyncStatus
e_book_backend_sync_get_contact (EBookBackendSync *backend,
* Gets a list of contacts from @book. The list and its elements must be freed
* by the caller.
*
- * Return value: An #EBookBackendSyncStatus indicating the outcome of the operation.
+ * Returns: An #EBookBackendSyncStatus indicating the outcome of the operation.
**/
EBookBackendSyncStatus
e_book_backend_sync_get_contact_list (EBookBackendSync *backend,
* The returned list will contain items of CORBA type
* #GNOME_Evolution_Addressbook_BookChangeItem.
*
- * Return value: An #EBookBackendSyncStatus indicating the outcome of the operation.
+ * Returns: An #EBookBackendSyncStatus indicating the outcome of the operation.
**/
EBookBackendSyncStatus
e_book_backend_sync_get_changes (EBookBackendSync *backend,
*
* Authenticates @user against @book.
*
- * Return value: An #EBookBackendSyncStatus indicating the outcome of the operation.
+ * Returns: An #EBookBackendSyncStatus indicating the outcome of the operation.
**/
EBookBackendSyncStatus
e_book_backend_sync_authenticate_user (EBookBackendSync *backend,
* fields are represented by strings from #e_contact_field_name. The list
* and its contents must be freed by the caller.
*
- * Return value: An #EBookBackendSyncStatus indicating the outcome of the operation.
+ * Returns: An #EBookBackendSyncStatus indicating the outcome of the operation.
**/
EBookBackendSyncStatus
e_book_backend_sync_get_required_fields (EBookBackendSync *backend,
* may not be stored. The fields are represented by strings from #e_contact_field_name.
* The list and its contents must be freed by the caller.
*
- * Return value: An #EBookBackendSyncStatus indicating the outcome of the operation.
+ * Returns: An #EBookBackendSyncStatus indicating the outcome of the operation.
**/
EBookBackendSyncStatus
e_book_backend_sync_get_supported_fields (EBookBackendSync *backend,
* methods are represented by strings. The list and its contents must
* be freed by the caller.
*
- * Return value: An #EBookBackendSyncStatus indicating the outcome of the operation.
+ * Returns: An #EBookBackendSyncStatus indicating the outcome of the operation.
**/
EBookBackendSyncStatus
e_book_backend_sync_get_supported_auth_methods (EBookBackendSync *backend,
*
* Does nothing.
*
- * Return value: %TRUE.
+ * Returns: %TRUE.
**/
gboolean
e_book_backend_construct (EBookBackend *backend)
*
* Loads @source into @backend.
*
- * Return value: A #GNOME_Evolution_Addressbook_CallStatus indicating the outcome.
+ * Returns: A #GNOME_Evolution_Addressbook_CallStatus indicating the outcome.
**/
GNOME_Evolution_Addressbook_CallStatus
e_book_backend_load_source (EBookBackend *backend,
*
* Queries the source that an addressbook backend is serving.
*
- * Return value: ESource for the backend.
+ * Returns: ESource for the backend.
**/
ESource *
e_book_backend_get_source (EBookBackend *backend)
*
* Cancel @book's running operation on @backend.
*
- * Return value: A GNOME_Evolution_Addressbook_CallStatus indicating the outcome.
+ * Returns: A GNOME_Evolution_Addressbook_CallStatus indicating the outcome.
**/
GNOME_Evolution_Addressbook_CallStatus
e_book_backend_cancel_operation (EBookBackend *backend,
*
* Gets the list of #EDataBookView views running on this backend.
*
- * Return value: An #EList of #EDataBookView objects.
+ * Returns: An #EList of #EDataBookView objects.
**/
EList*
e_book_backend_get_book_views (EBookBackend *backend)
*
* Adds a client to an addressbook backend.
*
- * Return value: TRUE on success, FALSE on failure to add the client.
+ * Returns: TRUE on success, FALSE on failure to add the client.
*/
gboolean
e_book_backend_add_client (EBookBackend *backend,
*
* Checks if @backend has clients running in other system processes.
*
- * Return value: %TRUE if there are clients in other processes, %FALSE otherwise.
+ * Returns: %TRUE if there are clients in other processes, %FALSE otherwise.
**/
gboolean
e_book_backend_has_out_of_proc_clients (EBookBackend *backend)
*
* Gets the capabilities offered by this @backend.
*
- * Return value: A string listing the capabilities.
+ * Returns: A string listing the capabilities.
**/
gchar *
e_book_backend_get_static_capabilities (EBookBackend *backend)
* Checks if @backend's storage has been opened and the backend
* itself is ready for accessing.
*
- * Return value: %TRUE if loaded, %FALSE otherwise.
+ * Returns: %TRUE if loaded, %FALSE otherwise.
**/
gboolean
e_book_backend_is_loaded (EBookBackend *backend)
*
* Checks if we can write to @backend.
*
- * Return value: %TRUE if writeable, %FALSE if not.
+ * Returns: %TRUE if writeable, %FALSE if not.
**/
gboolean
e_book_backend_is_writable (EBookBackend *backend)
*
* Checks if @backend has been removed from its physical storage.
*
- * Return value: %TRUE if @backend has been removed, %FALSE otherwise.
+ * Returns: %TRUE if @backend has been removed, %FALSE otherwise.
**/
gboolean
e_book_backend_is_removed (EBookBackend *backend)
* Creates a new change item indicating @vcard was added.
* Meant to be used by backend implementations.
*
- * Return value: A new #GNOME_Evolution_Addressbook_BookChangeItem.
+ * Returns: A new #GNOME_Evolution_Addressbook_BookChangeItem.
**/
EDataBookChange *
e_book_backend_change_add_new (const gchar *vcard)
* Creates a new change item indicating @vcard was modified.
* Meant to be used by backend implementations.
*
- * Return value: A new #GNOME_Evolution_Addressbook_BookChangeItem.
+ * Returns: A new #GNOME_Evolution_Addressbook_BookChangeItem.
**/
EDataBookChange *
e_book_backend_change_modify_new (const gchar *vcard)
* Creates a new change item indicating @vcard was deleted.
* Meant to be used by backend implementations.
*
- * Return value: A new #GNOME_Evolution_Addressbook_BookChangeItem.
+ * Returns: A new #GNOME_Evolution_Addressbook_BookChangeItem.
**/
EDataBookChange *
e_book_backend_change_delete_new (const gchar *vcard)
* Gets the text representation of the s-expression used
* for matching contacts to @book_view.
*
- * Return value: The textual s-expression used.
+ * Returns: The textual s-expression used.
**/
const gchar *
e_data_book_view_get_card_query (EDataBookView *book_view)
* Gets the s-expression used for matching contacts to
* @book_view.
*
- * Return value: The #EBookBackendSExp used.
+ * Returns: The #EBookBackendSExp used.
**/
EBookBackendSExp*
e_data_book_view_get_card_sexp (EDataBookView *book_view)
* Gets the maximum number of results returned by
* @book_view's query.
*
- * Return value: The maximum number of results returned.
+ * Returns: The maximum number of results returned.
**/
gint
e_data_book_view_get_max_results (EDataBookView *book_view)
*
* Gets the backend that @book_view is querying.
*
- * Return value: The associated #EBookBackend.
+ * Returns: The associated #EBookBackend.
**/
EBookBackend*
e_data_book_view_get_backend (EDataBookView *book_view)
* @handle:
* Call this to Update changes, made to the calendar.
*
- * Return value: TRUE if update is successful FALSE otherwise .
+ * Returns: TRUE if update is successful FALSE otherwise .
**/
gpointer
e_cal_backend_google_utils_update (gpointer handle)
* the TZID. All items referencing the renamed TZID are adapted
* accordingly.
*
- * Return value: TRUE if successful, FALSE otherwise.
+ * Returns: TRUE if successful, FALSE otherwise.
*
* Since: 2.24
*/
*
* Generates a unique identifier suitable for calendar components.
*
- * Return value: A unique identifier string. Every time this function is called
+ * Returns: A unique identifier string. Every time this function is called
* a different string is returned.
**/
gchar *
* existing #icalcomponent structure by using e_cal_component_set_icalcomponent() or with a
* new empty component type by using e_cal_component_set_new_vtype().
*
- * Return value: A newly-created calendar component object.
+ * Returns: A newly-created calendar component object.
**/
ECalComponent *
e_cal_component_new (void)
*
* Creates a new calendar component object from the given iCalendar string.
*
- * Return value: A calendar component representing the given iCalendar string on
+ * Returns: A calendar component representing the given iCalendar string on
* success, NULL if there was an error.
**/
ECalComponent *
* Creates a new calendar component object by copying the information from
* another one.
*
- * Return value: A newly-created calendar component with the same values as the
+ * Returns: A newly-created calendar component with the same values as the
* original one.
**/
ECalComponent *
*
* Supported component types are VEVENT, VTODO, VJOURNAL, VFREEBUSY, and VTIMEZONE.
*
- * Return value: TRUE on success, FALSE if @icalcomp is an unsupported component
+ * Returns: TRUE on success, FALSE if @icalcomp is an unsupported component
* type.
**/
gboolean
* Queries the #icalcomponent structure that a calendar component object is
* wrapping.
*
- * Return value: An #icalcomponent structure, or NULL if the @comp has no
+ * Returns: An #icalcomponent structure, or NULL if the @comp has no
* #icalcomponent set to it.
**/
icalcomponent *
*
* Queries the type of a calendar component object.
*
- * Return value: The type of the component, as defined by RFC 2445.
+ * Returns: The type of the component, as defined by RFC 2445.
**/
ECalComponentVType
e_cal_component_get_vtype (ECalComponent *comp)
* call e_cal_component_commit_sequence() before this function to ensure that the
* component's sequence number is consistent with the state of the object.
*
- * Return value: String representation of the calendar component according to
+ * Returns: String representation of the calendar component according to
* RFC 2445.
**/
gchar *
* Get the ID of the component as a #ECalComponentId. The return value should
* be freed with e_cal_component_free_id() when you have finished with it.
*
- * Return value: the id of the component
+ * Returns: the id of the component
*/
ECalComponentId *
e_cal_component_get_id (ECalComponent *comp)
*
* Queries the component to see if it has attachments.
*
- * Return value: TRUE if there are attachments, FALSE otherwise.
+ * Returns: TRUE if there are attachments, FALSE otherwise.
*/
gboolean
e_cal_component_has_attachments (ECalComponent *comp)
*
* Get the number of attachments to this calendar component object.
*
- * Return value: the number of attachments.
+ * Returns: the number of attachments.
*/
gint
e_cal_component_get_num_attachments (ECalComponent *comp)
* Queries whether a calendar component object has any exception dates defined
* for it.
*
- * Return value: TRUE if the component has exception dates, FALSE otherwise.
+ * Returns: TRUE if the component has exception dates, FALSE otherwise.
**/
gboolean
e_cal_component_has_exdates (ECalComponent *comp)
* Queries whether a calendar component object has any exception rules defined
* for it.
*
- * Return value: TRUE if the component has exception rules, FALSE otherwise.
+ * Returns: TRUE if the component has exception rules, FALSE otherwise.
**/
gboolean
e_cal_component_has_exrules (ECalComponent *comp)
* Queries whether a calendar component object has any exception dates
* or exception rules.
*
- * Return value: TRUE if the component has exceptions, FALSE otherwise.
+ * Returns: TRUE if the component has exceptions, FALSE otherwise.
**/
gboolean
e_cal_component_has_exceptions (ECalComponent *comp)
*
* Check whether a calendar component object has an organizer or not.
*
- * Return value: TRUE if there is an organizer, FALSE otherwise.
+ * Returns: TRUE if there is an organizer, FALSE otherwise.
**/
gboolean
e_cal_component_has_organizer (ECalComponent *comp)
*
* Gets the recurrence ID property as a string.
*
- * Return value: the recurrence ID as a string.
+ * Returns: the recurrence ID as a string.
*/
gchar *
e_cal_component_get_recurid_as_string (ECalComponent *comp)
* Queries whether a calendar component object has any recurrence dates defined
* for it.
*
- * Return value: TRUE if the component has recurrence dates, FALSE otherwise.
+ * Returns: TRUE if the component has recurrence dates, FALSE otherwise.
**/
gboolean
e_cal_component_has_rdates (ECalComponent *comp)
* Queries whether a calendar component object has any recurrence rules defined
* for it.
*
- * Return value: TRUE if the component has recurrence rules, FALSE otherwise.
+ * Returns: TRUE if the component has recurrence rules, FALSE otherwise.
**/
gboolean
e_cal_component_has_rrules (ECalComponent *comp)
* Queries whether a calendar component object has any recurrence dates or
* recurrence rules.
*
- * Return value: TRUE if the component has recurrences, FALSE otherwise.
+ * Returns: TRUE if the component has recurrences, FALSE otherwise.
**/
gboolean
e_cal_component_has_recurrences (ECalComponent *comp)
* Checks whether the given calendar component object has simple recurrence
* rules or more complicated ones.
*
- * Return value: TRUE if it has a simple recurrence rule, FALSE otherwise.
+ * Returns: TRUE if it has a simple recurrence rule, FALSE otherwise.
*/
gboolean
e_cal_component_has_simple_recurrence (ECalComponent *comp)
* Checks whether a calendar component object is an instance of a recurring
* event.
*
- * Return value: TRUE if it is an instance, FALSE if not.
+ * Returns: TRUE if it is an instance, FALSE if not.
*/
gboolean
e_cal_component_is_instance (ECalComponent *comp)
*
* Queries a calendar component object for the existence of attendees.
*
- * Return value: TRUE if there are attendees, FALSE if not.
+ * Returns: TRUE if there are attendees, FALSE if not.
*/
gboolean
e_cal_component_has_attendees (ECalComponent *comp)
*
* Checks whether the component has any alarms.
*
- * Return value: TRUE if the component has any alarms.
+ * Returns: TRUE if the component has any alarms.
**/
gboolean
e_cal_component_has_alarms (ECalComponent *comp)
* Builds a list of the unique identifiers of the alarm subcomponents inside a
* calendar component.
*
- * Return value: List of unique identifiers for alarms. This should be freed
+ * Returns: List of unique identifiers for alarms. This should be freed
* using cal_obj_uid_list_free().
**/
GList *
*
* Queries a particular alarm subcomponent of a calendar component.
*
- * Return value: The alarm subcomponent that corresponds to the specified @auid,
+ * Returns: The alarm subcomponent that corresponds to the specified @auid,
* or #NULL if no alarm exists with that UID. This should be freed using
* e_cal_component_alarm_free().
**/
*
* Create a new alarm object.
*
- * Return value: a new alarm component
+ * Returns: a new alarm component
**/
ECalComponentAlarm *
e_cal_component_alarm_new (void)
*
* Creates a new alarm subcomponent by copying the information from another one.
*
- * Return value: A newly-created alarm subcomponent with the same values as the
+ * Returns: A newly-created alarm subcomponent with the same values as the
* original one. Should be freed with e_cal_component_alarm_free().
**/
ECalComponentAlarm *
*
* Queries the unique identifier of an alarm subcomponent.
*
- * Return value: UID of the alarm.
+ * Returns: UID of the alarm.
**/
const gchar *
e_cal_component_alarm_get_uid (ECalComponentAlarm *alarm)
*
* Queries an alarm to see if it has attendees associated with it.
*
- * Return value: TRUE if there are attendees in the alarm, FALSE if not.
+ * Returns: TRUE if there are attendees in the alarm, FALSE if not.
*/
gboolean
e_cal_component_alarm_has_attendees (ECalComponentAlarm *alarm)
* Converts an #icalproperty to a #ECalRecurrence. This should be
* freed using the e_cal_recur_free() function.
*
- * Return value: #ECalRecurrence structure.
+ * Returns: #ECalRecurrence structure.
**/
static ECalRecurrence *
e_cal_recur_from_icalproperty (icalproperty *prop, gboolean exception,
* to make it valid time, any further calls to time_add_day() will also return
* this hour, which may not be what you want.
*
- * Return value: a time_t value containing @time plus the days added.
+ * Returns: a time_t value containing @time plus the days added.
*/
time_t
time_add_day (time_t time, gint days)
*
* Adds the given number of weeks to a time value.
*
- * Return value: a time_t value containing @time plus the weeks added.
+ * Returns: a time_t value containing @time plus the weeks added.
*/
time_t
time_add_week (time_t time, gint weeks)
*
* Returns the start of the day, according to the local time.
*
- * Return value: the time corresponding to the beginning of the day.
+ * Returns: the time corresponding to the beginning of the day.
*/
time_t
time_day_begin (time_t t)
*
* Returns the end of the day, according to the local time.
*
- * Return value: the time corresponding to the end of the day.
+ * Returns: the time corresponding to the end of the day.
*/
time_t
time_day_end (time_t t)
* functions easier. New code should use icaltimetype values and
* icaltime_adjust() to add or subtract days, hours, minutes & seconds.
*
- * Return value: a time_t value containing @time plus the days added.
+ * Returns: a time_t value containing @time plus the days added.
*/
time_t
time_add_day_with_zone (time_t time, gint days, icaltimezone *zone)
* functions easier. New code should use icaltimetype values and
* icaltime_adjust() to add or subtract days, hours, minutes & seconds.
*
- * Return value: a time_t value containing @time plus the weeks added.
+ * Returns: a time_t value containing @time plus the weeks added.
*/
time_t
time_add_week_with_zone (time_t time, gint weeks, icaltimezone *zone)
* functions easier. New code should use icaltimetype values and
* icaltime_adjust() to add or subtract days, hours, minutes & seconds.
*
- * Return value: a time_t value containing @time plus the months added.
+ * Returns: a time_t value containing @time plus the months added.
*/
time_t
time_add_month_with_zone (time_t time, gint months, icaltimezone *zone)
* functions easier. New code should use icaltimetype values and
* icaltime_adjust() to add or subtract days, hours, minutes & seconds.
*
- * Return value: the beginning of the year.
+ * Returns: the beginning of the year.
*/
time_t
time_year_begin_with_zone (time_t time, icaltimezone *zone)
* functions easier. New code should use icaltimetype values and
* icaltime_adjust() to add or subtract days, hours, minutes & seconds.
*
- * Return value: the beginning of the month.
+ * Returns: the beginning of the month.
*/
time_t
time_month_begin_with_zone (time_t time, icaltimezone *zone)
* functions easier. New code should use icaltimetype values and
* icaltime_adjust() to add or subtract days, hours, minutes & seconds.
*
- * Return value: the beginning of the week.
+ * Returns: the beginning of the week.
*/
time_t
time_week_begin_with_zone (time_t time, gint week_start_day, icaltimezone *zone)
* functions easier. New code should use icaltimetype values and
* icaltime_adjust() to add or subtract days, hours, minutes & seconds.
*
- * Return value: the beginning of the day.
+ * Returns: the beginning of the day.
*/
time_t
time_day_begin_with_zone (time_t time, icaltimezone *zone)
* functions easier. New code should use icaltimetype values and
* icaltime_adjust() to add or subtract days, hours, minutes & seconds.
*
- * Return value: the end of the day.
+ * Returns: the end of the day.
*/
time_t
time_day_end_with_zone (time_t time, icaltimezone *zone)
* Returns the number of days in the month. Year is the normal year, e.g. 2001.
* Month is 0 (Jan) to 11 (Dec).
*
- * Return value: number of days in the given month/year.
+ * Returns: number of days in the given month/year.
*/
gint
time_days_in_month (gint year, gint month)
* Returns the 1-based day number within the year of the specified date.
* Year is the normal year, e.g. 2001. Month is 0 to 11.
*
- * Return value: the day of the year.
+ * Returns: the day of the year.
*/
gint
time_day_of_year (gint day, gint month, gint year)
* For the days that were removed on the Gregorian reformation, it returns
* Thursday. Year is the normal year, e.g. 2001. Month is 0 to 11.
*
- * Return value: the day of the week for the given date.
+ * Returns: the day of the week for the given date.
*/
gint
time_day_of_week (gint day, gint month, gint year)
* Returns whether the specified year is a leap year. Year is the normal year,
* e.g. 2001.
*
- * Return value: TRUE if the year is leap, FALSE if not.
+ * Returns: TRUE if the year is leap, FALSE if not.
*/
gboolean
time_is_leap_year (gint year)
* Returns the number of leap years since year 1 up to (but not including) the
* specified year. Year is the normal year, e.g. 2001.
*
- * Return value: number of leap years.
+ * Returns: number of leap years.
*/
gint
time_leap_years_up_to (gint year)
*
* Creates an ISO 8601 UTC representation from a time value.
*
- * Return value: String with the ISO 8601 representation of the UTC time.
+ * Returns: String with the ISO 8601 representation of the UTC time.
**/
gchar *
isodate_from_time_t (time_t t)
*
* Converts an ISO 8601 UTC time string into a time_t value.
*
- * Return value: Time_t corresponding to the specified ISO string.
+ * Returns: Time_t corresponding to the specified ISO string.
* Note that we only allow UTC times at present.
**/
time_t
*
* Convers an icaltimetype structure into a GLibc's struct tm.
*
- * Return value: The converted time as a struct tm. All fields will be
+ * Returns: The converted time as a struct tm. All fields will be
* set properly except for tm.tm_yday.
*
* Since: 2.22
* Converts a time value from one timezone to another, and returns a struct tm
* representation of the time.
*
- * Return value: The converted time as a struct tm. All fields will be
+ * Returns: The converted time as a struct tm. All fields will be
* set properly except for tm.tm_yday.
*
* Since: 2.22
*
* Converts a struct tm into an icaltimetype.
*
- * Return value: The converted time as an icaltimetype.
+ * Returns: The converted time as an icaltimetype.
*
* Since: 2.22
*/
*
* Creates a new VCALENDAR component.
*
- * Return value: the newly created top level component.
+ * Returns: the newly created top level component.
*/
icalcomponent *
e_cal_util_new_top_level (void)
*
* Creates a new #icalcomponent of the specified kind.
*
- * Return value: the newly created component.
+ * Returns: the newly created component.
*/
icalcomponent *
e_cal_util_new_component (icalcomponent_kind kind)
* string, something that Mozilla used to do and which libical does not
* support.
*
- * Return value: a newly created #icalcomponent or NULL if the string isn't a
+ * Returns: a newly created #icalcomponent or NULL if the string isn't a
* valid iCalendar string.
*/
icalcomponent *
* Parses the given file, and, if it contains a valid iCalendar object,
* parse it and return a new #icalcomponent.
*
- * Return value: a newly created #icalcomponent or NULL if the file doesn't
+ * Returns: a newly created #icalcomponent or NULL if the file doesn't
* contain a valid iCalendar object.
*/
icalcomponent *
* structure, or NULL if no alarm instances occurred in the specified time
* range.
*
- * Return value: a list of all the alarms found for the given component on
+ * Returns: a list of all the alarms found for the given component on
* the given time tange. The list of alarms should be freed by using the
* #e_cal_component_free_alarm_list function.
*/
* Iterates through all the components in the @comps list and generates alarm
* instances for them; putting them in the @comp_alarms list.
*
- * Return value: the number of elements it added to the list.
+ * Returns: the number of elements it added to the list.
*/
gint
e_cal_util_generate_alarms_for_list (GList *comps,
* Converts an iCalendar PRIORITY value to a translated string. Any unknown
* priority value (i.e. not 0-9) will be returned as "" (undefined).
*
- * Return value: a string representing the PRIORITY value. This value is a
+ * Returns: a string representing the PRIORITY value. This value is a
* constant, so it should never be freed.
*/
const gchar *
*
* Converts a translated priority string to an iCalendar priority value.
*
- * Return value: the priority (0-9) or -1 if the priority string is not valid.
+ * Returns: the priority (0-9) or -1 if the priority string is not valid.
*/
gint
e_cal_util_priority_from_string (const gchar *string)
*
* Checks whether an #icalcomponent is an instance of a recurring appointment or not.
*
- * Return value: TRUE if it is an instance, FALSE if not.
+ * Returns: TRUE if it is an instance, FALSE if not.
*/
gboolean
e_cal_util_component_is_instance (icalcomponent *icalcomp)
*
* Checks whether an #icalcomponent has any alarm.
*
- * Return value: TRUE if it has alarms, FALSE otherwise.
+ * Returns: TRUE if it has alarms, FALSE otherwise.
*/
gboolean
e_cal_util_component_has_alarms (icalcomponent *icalcomp)
*
* Checks whether an #icalcomponent has an organizer or not.
*
- * Return value: TRUE if there is an organizer, FALSE if not.
+ * Returns: TRUE if there is an organizer, FALSE if not.
*/
gboolean
e_cal_util_component_has_organizer (icalcomponent *icalcomp)
*
* Checks if an #icalcomponent has any attendees.
*
- * Return value: TRUE if there are attendees, FALSE if not.
+ * Returns: TRUE if there are attendees, FALSE if not.
*/
gboolean
e_cal_util_component_has_attendee (icalcomponent *icalcomp)
*
* Checks if an #icalcomponent has recurrence dates or rules.
*
- * Return value: TRUE if there are recurrence dates/rules, FALSE if not.
+ * Returns: TRUE if there are recurrence dates/rules, FALSE if not.
*/
gboolean
e_cal_util_component_has_recurrences (icalcomponent *icalcomp)
*
* Checks if an #icalcomponent has recurrence dates.
*
- * Return value: TRUE if there are recurrence dates, FALSE if not.
+ * Returns: TRUE if there are recurrence dates, FALSE if not.
*/
gboolean
e_cal_util_component_has_rdates (icalcomponent *icalcomp)
*
* Checks if an #icalcomponent has recurrence rules.
*
- * Return value: TRUE if there are recurrence rules, FALSE if not.
+ * Returns: TRUE if there are recurrence rules, FALSE if not.
*/
gboolean
e_cal_util_component_has_rrules (icalcomponent *icalcomp)
*
* Compare the dates of two #icalcomponent's to check if they match.
*
- * Return value: TRUE if the dates of both components match, FALSE otherwise.
+ * Returns: TRUE if the dates of both components match, FALSE otherwise.
*/
gboolean
e_cal_util_event_dates_match (icalcomponent *icalcomp1, icalcomponent *icalcomp2)
* This checks that @rid indicates a valid recurrence of @icalcomp, and
* if so, generates a copy of @comp containing a RECURRENCE-ID of @rid.
*
- * Return value: the instance, or %NULL.
+ * Returns: the instance, or %NULL.
**/
icalcomponent *
e_cal_util_construct_instance (icalcomponent *icalcomp,
* Creates a new view object by issuing the view creation request to the
* calendar server.
*
- * Return value: A newly-created view object, or NULL if the request failed.
+ * Returns: A newly-created view object, or NULL if the request failed.
**/
ECalView *
_e_cal_view_new (ECal *client, DBusGProxy *view_proxy, GStaticRecMutex *connection_lock)
*
* Get the #ECal associated with this view.
*
- * Return value: the associated client.
+ * Returns: the associated client.
*
* Since: 2.22
*/
*
* Registers the #ECalSourceTypeEnum type with glib.
*
- * Return value: the ID of the #ECalSourceTypeEnum type.
+ * Returns: the ID of the #ECalSourceTypeEnum type.
*/
GType
e_cal_source_type_enum_get_type (void)
*
* Registers the #ECalSetModeStatusEnum type with glib.
*
- * Return value: the ID of the #ECalSetModeStatusEnum type.
+ * Returns: the ID of the #ECalSetModeStatusEnum type.
*/
GType
e_cal_set_mode_status_enum_get_type (void)
*
* Registers the #CalModeEnum type with glib.
*
- * Return value: the ID of the #CalModeEnum type.
+ * Returns: the ID of the #CalModeEnum type.
*/
GType
cal_mode_enum_get_type (void)
* Creates a new calendar client. This does not open the calendar itself,
* for that, #e_cal_open or #e_cal_open_async needs to be called.
*
- * Return value: A newly-created calendar client, or NULL if the client could
+ * Returns: A newly-created calendar client, or NULL if the client could
* not be constructed because it could not contact the calendar server.
**/
ECal *
* Creates a new calendar client. This does not open the calendar itself,
* for that, #e_cal_open or #e_cal_open_async needs to be called.
*
- * Return value: A newly-created calendar client, or NULL if the client could
+ * Returns: A newly-created calendar client, or NULL if the client could
* not be constructed because it could not contact the calendar server.
**/
ECal *
* all Evolution installations. This does not open the calendar itself,
* for that, #e_cal_open or #e_cal_open_async needs to be called.
*
- * Return value: A newly-created calendar client, or NULL if the client could
+ * Returns: A newly-created calendar client, or NULL if the client could
* not be constructed.
*/
ECal *
* all Evolution installations. This does not open the tasks list itself,
* for that, #e_cal_open or #e_cal_open_async needs to be called.
*
- * Return value: A newly-created calendar client, or NULL if the client could
+ * Returns: A newly-created calendar client, or NULL if the client could
* not be constructed.
*/
ECal *
* in all Evolution installations. This does not open the memos itself, for
* that, #e_cal_open or #e_cal_open_async needs to be called.
*
- * Return value: A newly-created calendar client, or NULL if the client could
+ * Returns: A newly-created calendar client, or NULL if the client could
* not be constructed.
*/
ECal *
* client will emit the "cal_opened" signal when the response from the server is
* received.
*
- * Return value: TRUE on success, FALSE on failure to issue the open request.
+ * Returns: TRUE on success, FALSE on failure to issue the open request.
**/
gboolean
e_cal_open (ECal *ecal, gboolean only_if_exists, GError **error)
*
* Invokes refresh on a calendar. See @e_cal_get_refresh_supported.
*
- * Return value: TRUE if calendar supports refresh and it was invoked, FALSE otherwise.
+ * Returns: TRUE if calendar supports refresh and it was invoked, FALSE otherwise.
*
* Since: 2.30
**/
*
* Removes a calendar.
*
- * Return value: TRUE if the calendar was removed, FALSE if there was an error.
+ * Returns: TRUE if the calendar was removed, FALSE if there was an error.
*/
gboolean
e_cal_remove (ECal *ecal, GError **error)
*
* Retrieves a list of all calendar clients for the given mode.
*
- * Return value: list of uris.
+ * Returns: list of uris.
*/
GList *
e_cal_uri_list (ECal *ecal, CalMode mode)
*
* Gets the type of the calendar client.
*
- * Return value: an #ECalSourceType value corresponding to the type
+ * Returns: an #ECalSourceType value corresponding to the type
* of the calendar client.
*/
ECalSourceType
*
* Queries the state of loading of a calendar client.
*
- * Return value: A #ECalLoadState value indicating whether the client has
+ * Returns: A #ECalLoadState value indicating whether the client has
* not been loaded with #e_cal_open yet, whether it is being
* loaded, or whether it is already loaded.
**/
*
* Queries the source that is open in a calendar client.
*
- * Return value: The source of the calendar that is already loaded or is being
+ * Returns: The source of the calendar that is already loaded or is being
* loaded, or NULL if the ecal has not started a load request yet.
**/
ESource *
*
* Queries the URI that is open in a calendar client.
*
- * Return value: The URI of the calendar that is already loaded or is being
+ * Returns: The URI of the calendar that is already loaded or is being
* loaded, or NULL if the client has not started a load request yet.
**/
const gchar *
* unless it specifically uses the attachments for open/sending
* operations.
*
- * Return value: The URL where the attachments are serialized in the
+ * Returns: The URL where the attachments are serialized in the
* local filesystem.
**/
const gchar *
* on the calendar or not. Whether the backend is read only or not
* is specified, on exit, in the @read_only argument.
*
- * Return value: TRUE if the call was successful, FALSE if there was an error.
+ * Returns: TRUE if the call was successful, FALSE if there was an error.
*/
gboolean
e_cal_is_read_only (ECal *ecal, gboolean *read_only, GError **error)
*
* Queries the calendar address associated with a calendar client.
*
- * Return value: TRUE if the operation was successful, FALSE if there
+ * Returns: TRUE if the operation was successful, FALSE if there
* was an error.
**/
gboolean
*
* Queries the address to be used for alarms in a calendar client.
*
- * Return value: TRUE if the operation was successful, FALSE if there was
+ * Returns: TRUE if the operation was successful, FALSE if there was
* an error while contacting the backend.
*/
gboolean
*
* Queries the LDAP attribute for a calendar client.
*
- * Return value: TRUE if the call was successful, FALSE if there was an
+ * Returns: TRUE if the call was successful, FALSE if there was an
* error contacting the backend.
*/
gboolean
*
* Checks if a calendar supports only one alarm per component.
*
- * Return value: TRUE if the calendar allows only one alarm, FALSE otherwise.
+ * Returns: TRUE if the calendar allows only one alarm, FALSE otherwise.
*/
gboolean
e_cal_get_one_alarm_only (ECal *ecal)
*
* Checks if a calendar forces organizers of meetings to be also attendees.
*
- * Return value: TRUE if the calendar forces organizers to attend meetings,
+ * Returns: TRUE if the calendar forces organizers to attend meetings,
* FALSE otherwise.
*/
gboolean
*
* Checks if the calendar has a master object for recurrences.
*
- * Return value: TRUE if the calendar has a master object for recurrences,
+ * Returns: TRUE if the calendar has a master object for recurrences,
* FALSE otherwise.
*/
gboolean
*
* Queries the calendar for static capabilities.
*
- * Return value: TRUE if the capability is supported, FALSE otherwise.
+ * Returns: TRUE if the capability is supported, FALSE otherwise.
*/
gboolean
e_cal_get_static_capability (ECal *ecal, const gchar *cap)
*
* Checks whether the calendar saves schedules.
*
- * Return value: TRUE if it saves schedules, FALSE otherwise.
+ * Returns: TRUE if it saves schedules, FALSE otherwise.
*/
gboolean
e_cal_get_save_schedules (ECal *ecal)
* Checks whether a calendar requires organizer to accept their attendance to
* meetings.
*
- * Return value: TRUE if the calendar requires organizers to accept, FALSE
+ * Returns: TRUE if the calendar requires organizers to accept, FALSE
* otherwise.
*/
gboolean
*
* Checks whether a calendar supports explicit refreshing (see @e_cal_refresh).
*
- * Return value: TRUE if the calendar supports refreshing, FALSE otherwise.
+ * Returns: TRUE if the calendar supports refreshing, FALSE otherwise.
*
* Since: 2.30
*/
*
* Switches online/offline mode on the calendar.
*
- * Return value: TRUE if the switch was successful, FALSE if there was an error.
+ * Returns: TRUE if the switch was successful, FALSE if there was an error.
*/
gboolean
e_cal_set_mode (ECal *ecal, CalMode mode)
* Retrives an #icalcomponent from the backend that contains the default
* values for properties needed.
*
- * Return value: TRUE if the call was successful, FALSE otherwise.
+ * Returns: TRUE if the call was successful, FALSE otherwise.
*/
gboolean
e_cal_get_default_object (ECal *ecal, icalcomponent **icalcomp, GError **error)
* Queries a calendar for a calendar component object based on its unique
* identifier and gets the attachments for the component.
*
- * Return value: TRUE if the call was successful, FALSE otherwise.
+ * Returns: TRUE if the call was successful, FALSE otherwise.
**/
gboolean
e_cal_get_attachments_for_comp (ECal *ecal, const gchar *uid, const gchar *rid, GSList **list, GError **error)
* Queries a calendar for a calendar component object based on its unique
* identifier.
*
- * Return value: TRUE if the call was successful, FALSE otherwise.
+ * Returns: TRUE if the call was successful, FALSE otherwise.
**/
gboolean
e_cal_get_object (ECal *ecal, const gchar *uid, const gchar *rid, icalcomponent **icalcomp, GError **error)
* ID. This will return any recurring event and all its detached recurrences.
* For non-recurring events, it will just return the object with that ID.
*
- * Return value: TRUE if the call was successful, FALSE otherwise.
+ * Returns: TRUE if the call was successful, FALSE otherwise.
**/
gboolean
e_cal_get_objects_for_uid (ECal *ecal, const gchar *uid, GList **objects, GError **error)
*
* Resolves TZIDs for the recurrence generator.
*
- * Return value: The timezone identified by the @tzid argument, or %NULL if
+ * Returns: The timezone identified by the @tzid argument, or %NULL if
* it could not be found.
*/
icaltimezone*
* is identified by the @change_id argument, which is used by the backend to
* compute the changes done.
*
- * Return value: TRUE if the call was successful, FALSE otherwise.
+ * Returns: TRUE if the call was successful, FALSE otherwise.
*/
gboolean
e_cal_get_changes (ECal *ecal, const gchar *change_id, GList **changes, GError **error)
* argument, which is a list of #icalcomponent. When done, this list
* should be freed by using the #e_cal_free_object_list function.
*
- * Return value: TRUE if the operation was successful, FALSE otherwise.
+ * Returns: TRUE if the operation was successful, FALSE otherwise.
**/
gboolean
e_cal_get_object_list (ECal *ecal, const gchar *query, GList **objects, GError **error)
* by the @query argument. The objects will be returned in the @objects
* argument, which is a list of #ECalComponent.
*
- * Return value: TRUE if the operation was successful, FALSE otherwise.
+ * Returns: TRUE if the operation was successful, FALSE otherwise.
*/
gboolean
e_cal_get_object_list_as_comp (ECal *ecal, const gchar *query, GList **objects, GError **error)
* Queries a calendar for the alarms that trigger in the specified range of
* time.
*
- * Return value: A list of #ECalComponentAlarms structures. This should be freed
+ * Returns: A list of #ECalComponentAlarms structures. This should be freed
* using the #e_cal_free_alarms() function, or by freeing each element
* separately with #e_cal_component_alarms_free() and then freeing the list with
* #g_slist_free().
* Queries a calendar for the alarms of a particular object that trigger in the
* specified range of time.
*
- * Return value: TRUE on success, FALSE if the object was not found.
+ * Returns: TRUE on success, FALSE if the object was not found.
**/
gboolean
e_cal_get_alarms_for_object (ECal *ecal, const ECalComponentId *id,
* update internal information about the alarm be discarded, or, like
* the file backend does, ignore the operation.
*
- * Return value: TRUE if the operation was successful, FALSE otherwise.
+ * Returns: TRUE if the operation was successful, FALSE otherwise.
*/
gboolean
e_cal_discard_alarm (ECal *ecal, ECalComponent *comp, const gchar *auid, GError **error)
* Gets a calendar component as an iCalendar string, with a toplevel
* VCALENDAR component and all VTIMEZONEs needed for the component.
*
- * Return value: the component as a complete iCalendar string, or NULL on
+ * Returns: the component as a complete iCalendar string, or NULL on
* failure. The string should be freed after use.
**/
gchar *
* argument. Some backends would assign a specific UID to the newly created object,
* in those cases that UID would be returned in the @uid argument.
*
- * Return value: TRUE if the operation was successful, FALSE otherwise.
+ * Returns: TRUE if the operation was successful, FALSE otherwise.
*/
gboolean
e_cal_create_object (ECal *ecal, icalcomponent *icalcomp, gchar **uid, GError **error)
* or a specific set of instances (CALOBJ_MOD_THISNADPRIOR and
* CALOBJ_MOD_THISANDFUTURE).
*
- * Return value: TRUE if the operation was successful, FALSE otherwise.
+ * Returns: TRUE if the operation was successful, FALSE otherwise.
*/
gboolean
e_cal_modify_object (ECal *ecal, icalcomponent *icalcomp, CalObjModType mod, GError **error)
* signal, while it will get a "obj_removed" signal when all instances
* are removed.
*
- * Return value: TRUE if the operation was successful, FALSE otherwise.
+ * Returns: TRUE if the operation was successful, FALSE otherwise.
*/
gboolean
e_cal_remove_object_with_mod (ECal *ecal, const gchar *uid,
* component, all clients will be notified and they will emit the "obj_removed"
* signal.
*
- * Return value: %TRUE if successful, %FALSE otherwise.
+ * Returns: %TRUE if successful, %FALSE otherwise.
**/
gboolean
e_cal_remove_object (ECal *ecal, const gchar *uid, GError **error)
* @icalcomp argument. This is used for iTIP confirmation/cancellation
* messages for scheduled meetings.
*
- * Return value: %TRUE if successful, %FALSE otherwise.
+ * Returns: %TRUE if successful, %FALSE otherwise.
*/
gboolean
e_cal_receive_objects (ECal *ecal, icalcomponent *icalcomp, GError **error)
* Requests a calendar backend to send meeting information to the specified list
* of users.
*
- * Return value: TRUE if the operation was successful, FALSE otherwise.
+ * Returns: TRUE if the operation was successful, FALSE otherwise.
*/
gboolean
e_cal_send_objects (ECal *ecal, icalcomponent *icalcomp, GList **users, icalcomponent **modified_icalcomp, GError **error)
*
* Retrieves a timezone object from the calendar backend.
*
- * Return value: TRUE if the operation was successful, FALSE otherwise.
+ * Returns: TRUE if the operation was successful, FALSE otherwise.
*/
gboolean
e_cal_get_timezone (ECal *ecal, const gchar *tzid, icaltimezone **zone, GError **error)
*
* Creates a live query object from a loaded calendar.
*
- * Return value: A query object that will emit notification signals as calendar
+ * Returns: A query object that will emit notification signals as calendar
* components are added and removed from the query in the server.
**/
gboolean
* Sets the default timezone on the calendar. This should be called before opening
* the calendar.
*
- * Return value: TRUE if the operation was successful, FALSE otherwise.
+ * Returns: TRUE if the operation was successful, FALSE otherwise.
*/
gboolean
e_cal_set_default_timezone (ECal *ecal, icaltimezone *zone, GError **error)
*
* Opens the default calendar.
*
- * Return value: TRUE if it opened correctly, FALSE otherwise.
+ * Returns: TRUE if it opened correctly, FALSE otherwise.
*/
gboolean
e_cal_open_default (ECal **ecal, ECalSourceType type, ECalAuthFunc func, gpointer data, GError **error)
*
* Sets a calendar as the default one.
*
- * Return value: TRUE if the operation was successful, FALSE otherwise.
+ * Returns: TRUE if the operation was successful, FALSE otherwise.
*/
gboolean
e_cal_set_default (ECal *ecal, GError **error)
*
* Sets the default source for the specified @type.
*
- * Return value: TRUE if the operation was successful, FALSE otherwise.
+ * Returns: TRUE if the operation was successful, FALSE otherwise.
*/
gboolean
e_cal_set_default_source (ESource *source, ECalSourceType type, GError **error)
*
* Gets the list of sources defined in the configuration for the given @type.
*
- * Return value: TRUE if the operation was successful, FALSE otherwise.
+ * Returns: TRUE if the operation was successful, FALSE otherwise.
*/
gboolean
e_cal_get_sources (ESourceList **sources, ECalSourceType type, GError **error)
* Creates a new #ECalBackendCache object, which implements a cache of
* calendar/tasks objects, very useful for remote backends.
*
- * Return value: The newly created object.
+ * Returns: The newly created object.
*/
ECalBackendCache *
e_cal_backend_cache_new (const gchar *uri, ECalSourceType source_type)
*
* Gets a component from the %ECalBackendCache object.
*
- * Return value: The %ECalComponent representing the component found,
+ * Returns: The %ECalComponent representing the component found,
* or %NULL if it was not found in the cache.
*/
ECalComponent *
* the component if it does not exist or replace it if there was a
* previous version of it.
*
- * Return value: TRUE if the operation was successful, FALSE otherwise.
+ * Returns: TRUE if the operation was successful, FALSE otherwise.
*/
gboolean
e_cal_backend_cache_put_component (ECalBackendCache *cache,
*
* Removes a component from the cache.
*
- * Return value: TRUE if the component was removed, FALSE otherwise.
+ * Returns: TRUE if the component was removed, FALSE otherwise.
*/
gboolean
e_cal_backend_cache_remove_component (ECalBackendCache *cache,
*
* Retrieves a list of all the components stored in the cache.
*
- * Return value: A list of all the components. Each item in the list is
+ * Returns: A list of all the components. Each item in the list is
* an #ECalComponent, which should be freed when no longer needed.
*/
GList *
*
* Retrieves a ical components from the cache.
*
- * Return value: The list of calendar components if found, or NULL otherwise.
+ * Returns: The list of calendar components if found, or NULL otherwise.
*/
GSList *
e_cal_backend_cache_get_components_by_uid (ECalBackendCache *cache, const gchar *uid)
*
* Retrieves a timezone component from the cache.
*
- * Return value: The timezone if found, or NULL otherwise.
+ * Returns: The timezone if found, or NULL otherwise.
*/
const icaltimezone *
e_cal_backend_cache_get_timezone (ECalBackendCache *cache, const gchar *tzid)
* Puts the given timezone in the cache, adding it, if it did not exist, or
* replacing it, if there was an older version.
*
- * Return value: TRUE if the timezone was put on the cache, FALSE otherwise.
+ * Returns: TRUE if the timezone was put on the cache, FALSE otherwise.
*/
gboolean
e_cal_backend_cache_put_timezone (ECalBackendCache *cache, const icaltimezone *zone)
*
* Sets the default timezone on the cache.
*
- * Return value: TRUE if the operation was successful, FALSE otherwise.
+ * Returns: TRUE if the operation was successful, FALSE otherwise.
*/
gboolean
e_cal_backend_cache_put_default_timezone (ECalBackendCache *cache, icaltimezone *default_zone)
*
* Retrieves the default timezone from the cache.
*
- * Return value: The default timezone, or NULL if no default timezone
+ * Returns: The default timezone, or NULL if no default timezone
* has been set on the cache.
*/
icaltimezone *
*
* Removes a timezone component from the cache.
*
- * Return value: TRUE if the timezone was removed, FALSE otherwise.
+ * Returns: TRUE if the timezone was removed, FALSE otherwise.
*/
gboolean
e_cal_backend_cache_remove_timezone (ECalBackendCache *cache, const gchar *tzid)
*
* Gets the list of unique keys in the cache file.
*
- * Return value: A list of all the keys. The items in the list are pointers
+ * Returns: A list of all the keys. The items in the list are pointers
* to internal data, so should not be freed, only the list should.
*/
GSList *
* Gets the marker of the cache. If this field is present, it means the
* cache has been populated.
*
- * Return value: The value of the marker or NULL if the cache is still empty.
+ * Returns: The value of the marker or NULL if the cache is still empty.
*/
const gchar *
e_cal_backend_cache_get_marker (ECalBackendCache *cache)
* @cache: An #ECalBackendCache object.
* @utc_str: UTC string.
*
- * Return value: TRUE if the operation was successful, FALSE otherwise.
+ * Returns: TRUE if the operation was successful, FALSE otherwise.
*/
gboolean
e_cal_backend_cache_put_server_utc_time (ECalBackendCache *cache, const gchar *utc_str)
* e_cal_backend_cache_get_server_utc_time:
* @cache: An #ECalBackendCache object.
*
- * Return value: The server's UTC string.
+ * Returns: The server's UTC string.
*/
const gchar *
e_cal_backend_cache_get_server_utc_time (ECalBackendCache *cache)
* @keyp: The Key parameter to identify uniquely.
* @valuep: The value for the keyp parameter.
*
- * Return value: TRUE if the operation was successful, FALSE otherwise.
+ * Returns: TRUE if the operation was successful, FALSE otherwise.
*/
gboolean
e_cal_backend_cache_put_key_value (ECalBackendCache *cache, const gchar *key, const gchar *value)
* e_cal_backend_cache_get_key_value:
* @cache: An #ECalBackendCache object.
*
- * Return value: The value.
+ * Returns: The value.
*/
const gchar *
e_cal_backend_cache_get_key_value (ECalBackendCache *cache, const gchar *key)
*
* Gets the component type of the factory.
*
- * Return value: The kind of factory.
+ * Returns: The kind of factory.
*/
icalcomponent_kind
e_cal_backend_factory_get_kind (ECalBackendFactory *factory)
*
* Gets the protocol used by the factory.
*
- * Return value: The protocol.
+ * Returns: The protocol.
*/
const gchar *
e_cal_backend_factory_get_protocol (ECalBackendFactory *factory)
*
* Creates a new backend for the given @source.
*
- * Return value: The newly created backend, or NULL if there was an error.
+ * Returns: The newly created backend, or NULL if there was an error.
*/
ECalBackend*
e_cal_backend_factory_new_backend (ECalBackendFactory *factory, ESource *source)
*
* Processes the (time-now) sexp expression.
*
- * Return value: The result of the function.
+ * Returns: The result of the function.
*/
ESExpResult *
e_cal_backend_sexp_func_time_now (ESExp *esexp, gint argc, ESExpResult **argv, gpointer data)
*
* Constructs a time_t value for the specified date.
*
- * Return value: The result of the function.
+ * Returns: The result of the function.
*/
ESExpResult *
e_cal_backend_sexp_func_make_time (ESExp *esexp, gint argc, ESExpResult **argv, gpointer data)
* FIXME: TIMEZONES - need to use a timezone or daylight saving changes will
* make the result incorrect.
*
- * Return value: The result of the function.
+ * Returns: The result of the function.
*/
ESExpResult *
e_cal_backend_sexp_func_time_add_day (ESExp *esexp, gint argc, ESExpResult **argv, gpointer data)
*
* FIXME: TIMEZONES - this uses the current Unix timezone.
*
- * Return value: The result of the function.
+ * Returns: The result of the function.
*/
ESExpResult *
e_cal_backend_sexp_func_time_day_begin (ESExp *esexp, gint argc, ESExpResult **argv, gpointer data)
*
* FIXME: TIMEZONES - this uses the current Unix timezone.
*
- * Return value: The result of the function.
+ * Returns: The result of the function.
*/
ESExpResult *
e_cal_backend_sexp_func_time_day_end (ESExp *esexp, gint argc, ESExpResult **argv, gpointer data)
*
* Matches the given ECalComponent against the expression.
*
- * Return value: TRUE if the component matched the expression, FALSE if not.
+ * Returns: TRUE if the component matched the expression, FALSE if not.
*/
gboolean
e_cal_backend_sexp_match_comp (ECalBackendSExp *sexp, ECalComponent *comp, ECalBackend *backend)
*
* Match an iCalendar expression against the expression.
*
- * Return value: TRUE if the object matches the expression, FALSE if not.
+ * Returns: TRUE if the object matches the expression, FALSE if not.
*/
gboolean
e_cal_backend_sexp_match_object (ECalBackendSExp *sexp, const gchar *object, ECalBackend *backend)
*
* Creates a new #EXCalBackendSExp object.
*
- * Return value: The newly created ECalBackendSExp object.
+ * Returns: The newly created ECalBackendSExp object.
*/
ECalBackendSExp *
e_cal_backend_sexp_new (const gchar *text)
*
* Retrieve the text expression for the given ECalBackendSExp object.
*
- * Return value: The text expression.
+ * Returns: The text expression.
*/
const gchar *
e_cal_backend_sexp_text (ECalBackendSExp *sexp)
*
* Calls the is_read_only method on the given backend.
*
- * Return value: Status code.
+ * Returns: Status code.
*/
ECalBackendSyncStatus
e_cal_backend_sync_is_read_only (ECalBackendSync *backend, EDataCal *cal, gboolean *read_only)
*
* Calls the get_cal_address method on the given backend.
*
- * Return value: Status code.
+ * Returns: Status code.
*/
ECalBackendSyncStatus
e_cal_backend_sync_get_cal_address (ECalBackendSync *backend, EDataCal *cal, gchar **address)
*
* Calls the get_alarm_email_address method on the given backend.
*
- * Return value: Status code.
+ * Returns: Status code.
*/
ECalBackendSyncStatus
e_cal_backend_sync_get_alarm_email_address (ECalBackendSync *backend, EDataCal *cal, gchar **address)
*
* Calls the get_ldap_attribute method on the given backend.
*
- * Return value: Status code.
+ * Returns: Status code.
*/
ECalBackendSyncStatus
e_cal_backend_sync_get_ldap_attribute (ECalBackendSync *backend, EDataCal *cal, gchar **attribute)
*
* Calls the get_capabilities method on the given backend.
*
- * Return value: Status code.
+ * Returns: Status code.
*/
ECalBackendSyncStatus
e_cal_backend_sync_get_static_capabilities (ECalBackendSync *backend, EDataCal *cal, gchar **capabilities)
*
* Calls the open method on the given backend.
*
- * Return value: Status code.
+ * Returns: Status code.
*/
ECalBackendSyncStatus
e_cal_backend_sync_open (ECalBackendSync *backend, EDataCal *cal, gboolean only_if_exists,
*
* Calls the remove method on the given backend.
*
- * Return value: Status code.
+ * Returns: Status code.
*/
ECalBackendSyncStatus
e_cal_backend_sync_remove (ECalBackendSync *backend, EDataCal *cal)
*
* Calls the refresh method on the given backend.
*
- * Return value: Status code.
+ * Returns: Status code.
*
* Since: 2.30
*/
*
* Calls the create_object method on the given backend.
*
- * Return value: Status code.
+ * Returns: Status code.
*/
ECalBackendSyncStatus
e_cal_backend_sync_create_object (ECalBackendSync *backend, EDataCal *cal, gchar **calobj, gchar **uid)
*
* Calls the modify_object method on the given backend.
*
- * Return value: Status code.
+ * Returns: Status code.
*/
ECalBackendSyncStatus
e_cal_backend_sync_modify_object (ECalBackendSync *backend, EDataCal *cal, const gchar *calobj,
*
* Calls the remove_object method on the given backend.
*
- * Return value: Status code.
+ * Returns: Status code.
*/
ECalBackendSyncStatus
e_cal_backend_sync_remove_object (ECalBackendSync *backend, EDataCal *cal, const gchar *uid, const gchar *rid,
*
* Calls the discard_alarm method on the given backend.
*
- * Return value: Status code.
+ * Returns: Status code.
*/
ECalBackendSyncStatus
e_cal_backend_sync_discard_alarm (ECalBackendSync *backend, EDataCal *cal, const gchar *uid, const gchar *auid)
*
* Calls the receive_objects method on the given backend.
*
- * Return value: Status code.
+ * Returns: Status code.
*/
ECalBackendSyncStatus
e_cal_backend_sync_receive_objects (ECalBackendSync *backend, EDataCal *cal, const gchar *calobj)
*
* Calls the send_objects method on the given backend.
*
- * Return value: Status code.
+ * Returns: Status code.
*/
ECalBackendSyncStatus
e_cal_backend_sync_send_objects (ECalBackendSync *backend, EDataCal *cal, const gchar *calobj, GList **users,
*
* Calls the get_default_object method on the given backend.
*
- * Return value: Status code.
+ * Returns: Status code.
*/
ECalBackendSyncStatus
e_cal_backend_sync_get_default_object (ECalBackendSync *backend, EDataCal *cal, gchar **object)
*
* Calls the get_object method on the given backend.
*
- * Return value: Status code.
+ * Returns: Status code.
*/
ECalBackendSyncStatus
e_cal_backend_sync_get_object (ECalBackendSync *backend, EDataCal *cal, const gchar *uid, const gchar *rid, gchar **object)
*
* Calls the get_object_list method on the given backend.
*
- * Return value: Status code.
+ * Returns: Status code.
*/
ECalBackendSyncStatus
e_cal_backend_sync_get_object_list (ECalBackendSync *backend, EDataCal *cal, const gchar *sexp, GList **objects)
*
* Calls the get_attachment_list method on the given backend.
*
- * Return value: Status code.
+ * Returns: Status code.
*/
ECalBackendSyncStatus
e_cal_backend_sync_get_attachment_list (ECalBackendSync *backend, EDataCal *cal, const gchar *uid, const gchar *rid, GSList **attachments)
* internal_get_timezone and can skip implementation of
* get_timezone_sync completely.
*
- * Return value: Status code.
+ * Returns: Status code.
*/
ECalBackendSyncStatus
e_cal_backend_sync_get_timezone (ECalBackendSync *backend, EDataCal *cal, const gchar *tzid, gchar **object)
*
* Calls the add_timezone method on the given backend.
*
- * Return value: Status code.
+ * Returns: Status code.
*/
ECalBackendSyncStatus
e_cal_backend_sync_add_timezone (ECalBackendSync *backend, EDataCal *cal, const gchar *tzobj)
*
* Calls the set_default_timezone method on the given backend.
*
- * Return value: Status code.
+ * Returns: Status code.
*/
ECalBackendSyncStatus
e_cal_backend_sync_set_default_zone (ECalBackendSync *backend, EDataCal *cal, const gchar *tz)
*
* Calls the set_default_timezone method on the given backend.
*
- * Return value: Status code.
+ * Returns: Status code.
*/
ECalBackendSyncStatus
e_cal_backend_sync_set_default_timezone (ECalBackendSync *backend, EDataCal *cal, const gchar *tzid)
*
* Calls the get_changes method on the given backend.
*
- * Return value: Status code.
+ * Returns: Status code.
*/
ECalBackendSyncStatus
e_cal_backend_sync_get_changes (ECalBackendSync *backend, EDataCal *cal, const gchar *change_id,
*
* Calls the get_free_busy method on the given backend.
*
- * Return value: Status code.
+ * Returns: Status code.
*/
ECalBackendSyncStatus
e_cal_backend_sync_get_free_busy (ECalBackendSync *backend, EDataCal *cal, GList *users,
*
* Retrieve the default mail account as stored in Evolution configuration.
*
- * Return value: TRUE if there is a default account, FALSE otherwise.
+ * Returns: TRUE if there is a default account, FALSE otherwise.
*/
gboolean
e_cal_backend_mail_account_get_default (gchar **address, gchar **name)
*
* Checks that a mail account is valid, and returns its name.
*
- * Return value: TRUE if the account is valid, FALSE if not.
+ * Returns: TRUE if the account is valid, FALSE if not.
*/
gboolean
e_cal_backend_mail_account_is_valid (gchar *user, gchar **name)
/**
* is_attendee_declined:
- * @param icalcomp Component where to check the attendee list.
- * @param email Attendee's email to look for.
- * @return Whether the required attendee declined or not.
- * It's not necessary to have this attendee in the list.
+ * @icalcomp: Component where to check the attendee list.
+ * @email: Attendee's email to look for.
+ *
+ * Returns: Whether the required attendee declined or not.
+ * It's not necessary to have this attendee in the list.
**/
static gboolean
is_attendee_declined (icalcomponent *icalcomp, const gchar *email)
/**
* e_cal_backend_user_declined:
- * @param icalcomp Component where to check.
- * @return Whether icalcomp contains attendee with a mail same as any of configured
- * enabled mail account and whether this user declined.
+ * @icalcomp: Component where to check.
+ *
+ * Returns: Whether icalcomp contains attendee with a mail same as any of
+ * configured enabled mail account and whether this user declined.
*
* Since: 2.26
**/
*
* Gets the #ESource associated with the given backend.
*
- * Return value: The #ESource for the backend.
+ * Returns: The #ESource for the backend.
*/
ESource *
e_cal_backend_get_source (ECalBackend *backend)
* Queries the URI of a calendar backend, which must already have an open
* calendar.
*
- * Return value: The URI where the calendar is stored.
+ * Returns: The URI where the calendar is stored.
**/
const gchar *
e_cal_backend_get_uri (ECalBackend *backend)
*
* Gets the kind of components the given backend stores.
*
- * Return value: The kind of components for this backend.
+ * Returns: The kind of components for this backend.
*/
icalcomponent_kind
e_cal_backend_get_kind (ECalBackend *backend)
*
* Gets the list of live queries being run on the given backend.
*
- * Return value: The list of live queries.
+ * Returns: The list of live queries.
*/
EList *
e_cal_backend_get_queries (ECalBackend *backend)
*
* Queries whether a calendar backend has been loaded yet.
*
- * Return value: TRUE if the backend has been loaded with data, FALSE
+ * Returns: TRUE if the backend has been loaded with data, FALSE
* otherwise.
*/
gboolean
*
* Queries whether a calendar backend is connected remotely.
*
- * Return value: The current mode the calendar is in
+ * Returns: The current mode the calendar is in
**/
CalMode
e_cal_backend_get_mode (ECalBackend *backend)
*
* Get the expression used for the given query.
*
- * Return value: the query expression used to search.
+ * Returns: the query expression used to search.
*/
const gchar *
e_data_cal_view_get_text (EDataCalView *query)
*
* Get the #ECalBackendSExp object used for the given query.
*
- * Return value: The expression object used to search.
+ * Returns: The expression object used to search.
*/
ECalBackendSExp *
e_data_cal_view_get_object_sexp (EDataCalView *query)
* Compares the given @object to the regular expression used for the
* given query.
*
- * Return value: TRUE if the object matches the expression, FALSE if not.
+ * Returns: TRUE if the object matches the expression, FALSE if not.
*/
gboolean
e_data_cal_view_object_matches (EDataCalView *query, const gchar *object)
*
* Gets the list of objects already matched for the given query.
*
- * Return value: A list of matched objects.
+ * Returns: A list of matched objects.
*/
GList *
e_data_cal_view_get_matched_objects (EDataCalView *query)
*
* Checks whether the given query has already been started.
*
- * Return value: TRUE if the query has already been started, FALSE otherwise.
+ * Returns: TRUE if the query has already been started, FALSE otherwise.
*/
gboolean
e_data_cal_view_is_started (EDataCalView *view)
* changes will be sent. In fact, even after done, notifications will still be sent
* if there are changes in the objects matching the query search expression.
*
- * Return value: TRUE if the query is done, FALSE if still in progress.
+ * Returns: TRUE if the query is done, FALSE if still in progress.
*/
gboolean
e_data_cal_view_is_done (EDataCalView *query)
* Gets the status code obtained when the initial matching of objects was done
* for the given query.
*
- * Return value: The query status.
+ * Returns: The query status.
*/
EDataCalCallStatus
e_data_cal_view_get_done_status (EDataCalView *query)
*
* @block_size is currently ignored and is set to CAMEL_BLOCK_SIZE.
*
- * Return value: The new block file, or NULL if it could not be created.
+ * Returns: The new block file, or NULL if it could not be created.
**/
CamelBlockFile *camel_block_file_new(const gchar *path, gint flags, const gchar version[8], gsize block_size)
{
* Allocate a new block, return a pointer to it. Old blocks
* may be flushed to disk during this call.
*
- * Return value: The block, or NULL if an error occured.
+ * Returns: The block, or NULL if an error occured.
**/
CamelBlock *camel_block_file_new_block(CamelBlockFile *bs)
{
*
* Retreive a block @id.
*
- * Return value: The block, or NULL if blockid is invalid or a file error
+ * Returns: The block, or NULL if blockid is invalid or a file error
* occured.
**/
CamelBlock *camel_block_file_get_block(CamelBlockFile *bs, camel_block_t id)
* Flush a block to disk immediately. The block will only
* be flushed to disk if it is marked as dirty (touched).
*
- * Return value: -1 on io error.
+ * Returns: -1 on io error.
**/
gint camel_block_file_sync_block(CamelBlockFile *bs, CamelBlock *bl)
{
*
* Sync all dirty blocks to disk, including the root block.
*
- * Return value: -1 on io error.
+ * Returns: -1 on io error.
**/
gint camel_block_file_sync(CamelBlockFile *bs)
{
*
* Create a new key file. A linked list of record blocks.
*
- * Return value: A new key file, or NULL if the file could not
+ * Returns: A new key file, or NULL if the file could not
* be opened/created/initialised.
**/
CamelKeyFile *
*
* Write a new list of records to the key file.
*
- * Return value: -1 on io error. The key file will remain unchanged.
+ * Returns: -1 on io error. The key file will remain unchanged.
**/
gint
camel_key_file_write(CamelKeyFile *kf, camel_block_t *parent, gsize len, camel_key_t *records)
* Read the next block of data from the key file. Returns the number of
* records.
*
- * Return value: -1 on io error.
+ * Returns: -1 on io error.
**/
gint
camel_key_file_read(CamelKeyFile *kf, camel_block_t *start, gsize *len, camel_key_t **records)
* This creates a new CamelCipherContext object which is used to sign,
* verify, encrypt and decrypt streams.
*
- * Return value: the new CamelCipherContext
+ * Returns: the new CamelCipherContext
**/
CamelCipherContext *
camel_cipher_context_new (CamelSession *session)
* Converts the (unsigned) part @ipart into a new self-contained mime part @opart.
* This may be a multipart/signed part, or a simple part for enveloped types.
*
- * Return value: 0 for success or -1 for failure.
+ * Returns: 0 for success or -1 for failure.
**/
gint
camel_cipher_sign (CamelCipherContext *context, const gchar *userid, CamelCipherHash hash,
* @sigstream is assumed to be the signature stream and is used to
* verify the integirity of the @istream.
*
- * Return value: a CamelCipherValidity structure containing information
+ * Returns: a CamelCipherValidity structure containing information
* about the integrity of the input stream or %NULL on failure to
* execute at all.
**/
* Encrypts (and optionally signs) the cleartext input stream and
* writes the resulting ciphertext to the output stream.
*
- * Return value: 0 for success or -1 for failure.
+ * Returns: 0 for success or -1 for failure.
**/
gint
camel_cipher_encrypt (CamelCipherContext *context, const gchar *userid, GPtrArray *recipients,
*
* Decrypts @ipart into @opart.
*
- * Return value: A validity/encryption status.
+ * Returns: A validity/encryption status.
**/
CamelCipherValidity *
camel_cipher_decrypt(CamelCipherContext *context, struct _CamelMimePart *ipart, struct _CamelMimePart *opart, CamelException *ex)
*
* The transfer encoding paramaters for the part may be changed by this function.
*
- * Return value: -1 on error;
+ * Returns: -1 on error;
**/
gint
camel_cipher_canonical_to_stream(CamelMimePart *part, guint32 flags, CamelStream *ostream)
*
* Create a new data cache.
*
- * Return value: A new cache object, or NULL if the base path cannot
+ * Returns: A new cache object, or NULL if the base path cannot
* be written to.
**/
CamelDataCache *
* Potentially, expiry processing will be performed while this call
* is executing.
*
- * Return value: A CamelStream (file) opened in read-write mode.
+ * Returns: A CamelStream (file) opened in read-write mode.
* The caller must unref this when finished.
**/
CamelStream *
* multiple callers, so ensure the stream is in a valid state
* through external locking.
*
- * Return value: A cache item, or NULL if the cache item does not exist.
+ * Returns: A cache item, or NULL if the cache item does not exist.
**/
CamelStream *
camel_data_cache_get(CamelDataCache *cdc, const gchar *path, const gchar *key, CamelException *ex)
*
* Lookup the filename for an item in the cache
*
- * Return value: The filename for a cache item
+ * Returns: The filename for a cache item
*
* Since: 2.26
**/
*
* Remove/expire a cache item.
*
- * Return value:
+ * Returns:
**/
gint
camel_data_cache_remove(CamelDataCache *cdc, const gchar *path, const gchar *key, CamelException *ex)
*
* CURRENTLY UNIMPLEMENTED
*
- * Return value: -1 on error.
+ * Returns: -1 on error.
**/
gint camel_data_cache_rename(CamelDataCache *cache,
const gchar *old, const gchar *new, CamelException *ex)
*
* CURRENTLY_UNIMPLEMENTED
*
- * Return value: -1 on error.
+ * Returns: -1 on error.
**/
gint
camel_data_cache_clear(CamelDataCache *cache, const gchar *path, CamelException *ex)
* returns a boolean to indicate if the module or module and target is
* currently activated for debug output.
*
- * Return value:
+ * Returns:
**/
gboolean camel_debug(const gchar *mode)
{
* Start debug output for a given mode, used to make sure debug output
* is output atomically and not interspersed with unrelated stuff.
*
- * Return value: Returns true if mode is set, and in which case, you must
+ * Returns: Returns true if mode is set, and in which case, you must
* call debug_end when finished any screen output.
**/
gboolean
*
* Create a new CamelDigestStore object.
*
- * Return value: A new CamelDigestStore widget.
+ * Returns: A new CamelDigestStore widget.
**/
CamelStore *
camel_digest_store_new (const gchar *url)
* camel_disco_store_status:
* @store: a disconnectable store
*
- * Return value: the current online/offline status of @store.
+ * Returns: the current online/offline status of @store.
**/
CamelDiscoStoreStatus
camel_disco_store_status (CamelDiscoStore *store)
* camel_disco_store_can_work_offline:
* @store: a disconnectable store
*
- * Return value: whether or not @store can be used offline. (Will be
+ * Returns: whether or not @store can be used offline. (Will be
* %FALSE if the store is not caching data to local disk, for example.)
**/
gboolean
* can be used as a simple way to set a generic error message in @ex
* for operations that won't work offline.
*
- * Return value: whether or not @store is online.
+ * Returns: whether or not @store is online.
**/
gboolean
camel_disco_store_check_online (CamelDiscoStore *store, CamelException *ex)
*
* Utility function to save an uint32 to a file.
*
- * Return value: %0 on success, %-1 on error.
+ * Returns: %0 on success, %-1 on error.
**/
gint
camel_file_util_encode_uint32 (FILE *out, guint32 value)
*
* Retrieve an encoded uint32 from a file.
*
- * Return value: %0 on success, %-1 on error. @*dest will contain the
+ * Returns: %0 on success, %-1 on error. @*dest will contain the
* decoded value.
**/
gint
* Encode a gint32, performing no compression, but converting
* to network order.
*
- * Return value: %0 on success, %-1 on error.
+ * Returns: %0 on success, %-1 on error.
**/
gint
camel_file_util_encode_fixed_int32 (FILE *out, gint32 value)
*
* Retrieve a gint32.
*
- * Return value: %0 on success, %-1 on error.
+ * Returns: %0 on success, %-1 on error.
**/
gint
camel_file_util_decode_fixed_int32 (FILE *in, gint32 *dest)
*
* Encode a time_t value to the file.
*
- * Return value: %0 on success, %-1 on error.
+ * Returns: %0 on success, %-1 on error.
**/
CFU_ENCODE_T(time_t)
*
* Decode a time_t value.
*
- * Return value: %0 on success, %-1 on error.
+ * Returns: %0 on success, %-1 on error.
**/
CFU_DECODE_T(time_t)
*
* Encode an off_t type.
*
- * Return value: %0 on success, %-1 on error.
+ * Returns: %0 on success, %-1 on error.
**/
CFU_ENCODE_T(off_t)
*
* Decode an off_t type.
*
- * Return value: %0 on success, %-1 on failure.
+ * Returns: %0 on success, %-1 on failure.
**/
CFU_DECODE_T(off_t)
*
* Encode an gsize type.
*
- * Return value: %0 on success, %-1 on error.
+ * Returns: %0 on success, %-1 on error.
**/
CFU_ENCODE_T(gsize)
*
* Decode an gsize type.
*
- * Return value: %0 on success, %-1 on failure.
+ * Returns: %0 on success, %-1 on failure.
**/
CFU_DECODE_T(gsize)
*
* Encode a normal string and save it in the output file.
*
- * Return value: %0 on success, %-1 on error.
+ * Returns: %0 on success, %-1 on error.
**/
gint
camel_file_util_encode_string (FILE *out, const gchar *str)
*
* Decode a normal string from the input file.
*
- * Return value: %0 on success, %-1 on error.
+ * Returns: %0 on success, %-1 on error.
**/
gint
camel_file_util_decode_string (FILE *in, gchar **str)
* Unlike @camel_file_util_encode_string, it pads the
* @str with "NULL" bytes, if @len is > strlen(str)
*
- * Return value: %0 on success, %-1 on error.
+ * Returns: %0 on success, %-1 on error.
**/
gint
camel_file_util_encode_fixed_string (FILE *out, const gchar *str, gsize len)
*
* Decode a normal string from the input file.
*
- * Return value: %0 on success, %-1 on error.
+ * Returns: %0 on success, %-1 on error.
**/
gint
camel_file_util_decode_fixed_string (FILE *in, gchar **str, gsize len)
* basename of @filename, for instance used in a two-stage commit file
* write.
*
- * Return value: The new pathname. It must be free'd with g_free().
+ * Returns: The new pathname. It must be free'd with g_free().
**/
gchar *
camel_file_util_savename(const gchar *filename)
/**
* camel_filter_driver_new:
*
- * Return value: A new CamelFilterDriver object
+ * Returns: A new CamelFilterDriver object
**/
CamelFilterDriver *
camel_filter_driver_new (CamelSession *session)
* Particular methods may be overriden by an implementation to
* implement a search for any sort of backend.
*
- * Return value: A new CamelFolderSearch widget.
+ * Returns: A new CamelFolderSearch widget.
**/
CamelFolderSearch *
camel_folder_search_new (void)
* TODO: The interface should probably return summary items instead
* (since they are much more useful to any client).
*
- * Return value: A GPtrArray of strings of all matching messages.
+ * Returns: A GPtrArray of strings of all matching messages.
* This must only be freed by camel_folder_search_free_result.
**/
GPtrArray *
* Run a search. Search must have had Folder already set on it, and
* it must implement summaries.
*
- * Return value: Number of messages that match the query.
+ * Returns: Number of messages that match the query.
*
* Since: 2.26
**/
* Run a search. Search must have had Folder already set on it, and
* it must implement summaries.
*
- * Return value:
+ * Returns:
**/
GPtrArray *
camel_folder_search_search(CamelFolderSearch *search, const gchar *expr, GPtrArray *uids, CamelException *ex)
*
* This function is probably to be removed soon.
*
- * Return value: A CamelFolderThread contianing a tree of CamelFolderThreadNode's
+ * Returns: A CamelFolderThread contianing a tree of CamelFolderThreadNode's
* which represent the threaded structure of the messages.
**/
CamelFolderThread *
* life of the CamelFolderThread created by this function, and it is upto the
* caller to ensure this.
*
- * Return value: A CamelFolderThread contianing a tree of CamelFolderThreadNode's
+ * Returns: A CamelFolderThread contianing a tree of CamelFolderThreadNode's
* which represent the threaded structure of the messages.
**/
CamelFolderThread *
*
* Create a new CamelHTMLParser object.
*
- * Return value: A new CamelHTMLParser widget.
+ * Returns: A new CamelHTMLParser widget.
**/
CamelHTMLParser *
camel_html_parser_new (void)
* @session: active session
* @url: URL to act upon
*
- * Return value: a http stream
+ * Returns: a http stream
**/
CamelStream *
camel_http_stream_new (CamelHttpMethod method, struct _CamelSession *session, CamelURL *url)
*
* Add the list node @n to the head (start) of the list @l.
*
- * Return value: @n.
+ * Returns: @n.
**/
CamelDListNode *
camel_dlist_addhead (CamelDList *l, CamelDListNode *n)
*
* Add the list onde @n to the tail (end) of the list @l.
*
- * Return value: @n.
+ * Returns: @n.
**/
CamelDListNode *
camel_dlist_addtail (CamelDList *l, CamelDListNode *n)
*
* Remove @n from the list it's in. @n must belong to a list.
*
- * Return value: @n.
+ * Returns: @n.
**/
CamelDListNode *
camel_dlist_remove (CamelDListNode *n)
*
* Remove the last node in the list.
*
- * Return value: The previously last-node in the list, or NULL if @l
+ * Returns: The previously last-node in the list, or NULL if @l
* is an empty list.
**/
CamelDListNode *
*
* Returns %TRUE if @l is an empty list.
*
- * Return value: %TRUE if @l is an empty list, %FALSE otherwise.
+ * Returns: %TRUE if @l is an empty list, %FALSE otherwise.
**/
gint
camel_dlist_empty (CamelDList *l)
*
* Returns the number of nodes in the list @l.
*
- * Return value: The number of nodes.
+ * Returns: The number of nodes.
**/
gint
camel_dlist_length (CamelDList *l)
* Create an exclusive lock using .lock semantics.
* All locks are equivalent to write locks (exclusive).
*
- * Return value: -1 on error, sets @ex appropriately.
+ * Returns: -1 on error, sets @ex appropriately.
**/
gint
camel_lock_dot(const gchar *path, CamelException *ex)
* @type is CAMEL_LOCK_WRITE or CAMEL_LOCK_READ,
* to create exclusive or shared read locks
*
- * Return value: -1 on error.
+ * Returns: -1 on error.
**/
gint
camel_lock_fcntl(gint fd, CamelLockType type, CamelException *ex)
* @type is CAMEL_LOCK_WRITE or CAMEL_LOCK_READ,
* to create exclusive or shared read locks
*
- * Return value: -1 on error.
+ * Returns: -1 on error.
**/
gint
camel_lock_flock(gint fd, CamelLockType type, CamelException *ex)
* Attempt to lock a folder, multiple attempts will be made using all
* locking strategies available.
*
- * Return value: -1 on error, @ex will describe the locking system that failed.
+ * Returns: -1 on error, @ex will describe the locking system that failed.
**/
gint
camel_lock_folder(const gchar *path, gint fd, CamelLockType type, CamelException *ex)
*
* Create a new CamelMimeParser object.
*
- * Return value: A new CamelMimeParser widget.
+ * Returns: A new CamelMimeParser widget.
**/
CamelMimeParser *
camel_mime_parser_new (void)
* a filter has been set, all content returned by a filter_step() with a state
* of CAMEL_MIME_PARSER_STATE_BODY will have passed through the filter.
*
- * Return value: An id that may be passed to filter_remove() to remove
+ * Returns: An id that may be passed to filter_remove() to remove
* the filter, or -1 if the operation failed.
*
* Since: 2.22
*
* Lookup a header by name.
*
- * Return value: The header value, or NULL if the header is not
+ * Returns: The header value, or NULL if the header is not
* defined.
**/
const gchar *
* current state of the parser. These headers are valid
* until the next call to parser_step(), or parser_drop_step().
*
- * Return value: The raw headers, or NULL if there are no headers
+ * Returns: The raw headers, or NULL if there are no headers
* defined for the current part or state. These are READ ONLY.
*
* Since: 2.22
* Retrieve the preface text for the current multipart.
* Can only be used when the state is CAMEL_MIME_PARSER_STATE_MULTIPART_END.
*
- * Return value: The preface text, or NULL if there wasn't any.
+ * Returns: The preface text, or NULL if there wasn't any.
*
* Since: 2.22
**/
* Only returns valid data when the current state if
* CAMEL_MIME_PARSER_STATE_MULTIPART_END.
*
- * Return value: The postface text, or NULL if there wasn't any.
+ * Returns: The postface text, or NULL if there wasn't any.
*
* Since: 2.22
**/
* The return value will remain valid while in the CAMEL_MIME_PARSER_STATE_FROM
* state, or any deeper state.
*
- * Return value: The From line, or NULL if called out of context.
+ * Returns: The From line, or NULL if called out of context.
*
* Since: 2.22
**/
* descriptor. As a result, seekable descritors should
* be seeked using the parser seek functions.
*
- * Return value: Returns -1 on error.
+ * Returns: Returns -1 on error.
**/
gint
camel_mime_parser_init_with_fd(CamelMimeParser *m, gint fd)
* the stream. As a result, seekable streams should only
* be seeked using the parser seek function.
*
- * Return value: -1 on error.
+ * Returns: -1 on error.
**/
gint
camel_mime_parser_init_with_stream(CamelMimeParser *m, CamelStream *stream)
*
* Get the content type defined in the current part.
*
- * Return value: A content_type structure, or NULL if there
+ * Returns: A content_type structure, or NULL if there
* is no content-type defined for this part of state of the
* parser.
**/
* the states an application is gauranteed to get from the
* scanner.
*
- * Return value: The current new state of the parser
+ * Returns: The current new state of the parser
* is returned.
**/
camel_mime_parser_state_t
* occurs, so no state changes occur, but the seek position
* is updated appropriately.
*
- * Return value: The number of bytes available, or -1 on error.
+ * Returns: The number of bytes available, or -1 on error.
**/
gint
camel_mime_parser_read (CamelMimeParser *parser, const gchar **databuffer, gint len)
* the next section of the scan (the last position + 1 of
* the respective current state).
*
- * Return value: See above.
+ * Returns: See above.
*
* Since: 2.22
**/
* headers started, this is cached by the parser
* at the time.
*
- * Return value: The header start position, or -1 if
+ * Returns: The header start position, or -1 if
* no headers were scanned in the current state.
*
* Since: 2.22
* If the parser is scanning From lines, then this returns
* the position of the start of the From line.
*
- * Return value: The start of the from line, or -1 if there
+ * Returns: The start of the from line, or -1 if there
* was no From line, or From lines are not being scanned.
*
* Since: 2.22
* When parsing a multipart, this returns the start of the last
* boundary.
*
- * Return value: The start of the boundary, or -1 if there
+ * Returns: The start of the boundary, or -1 if there
* was no boundary encountered yet.
*
* Since: 2.22
* is specified (whence != SEEK_CUR), then the seek
* position may not match the desired seek position.
*
- * Return value: The new seek offset, or -1 on
+ * Returns: The new seek offset, or -1 on
* an error (for example, trying to seek on a non-seekable
* stream or file descriptor).
*
*
* Get the current parser state.
*
- * Return value: The current parser state.
+ * Returns: The current parser state.
**/
camel_mime_parser_state_t
camel_mime_parser_state (CamelMimeParser *parser)
* be read from directly (without saving and restoring
* the seek position in between).
*
- * Return value: The stream from _init_with_stream(), or NULL
+ * Returns: The stream from _init_with_stream(), or NULL
* if the parser is reading from a file descriptor or is
* uninitialised.
**/
* or the seek offset can be reset before the next parse
* step.
*
- * Return value: The file descriptor or -1 if the parser
+ * Returns: The file descriptor or -1 if the parser
* is reading from a stream or has not been initialised.
**/
gint
* Allocates a string buffer containing the rfc822 formatted date
* string represented by @time and @tz_offset.
*
- * Return value: a valid string representation of the date.
+ * Returns: a valid string representation of the date.
**/
gchar *
camel_header_format_date (time_t date, gint tz_offset)
*
* Create a new CamelNewsAddress object.
*
- * Return value: A new CamelNewsAddress widget.
+ * Returns: A new CamelNewsAddress widget.
**/
CamelNewsAddress *
camel_news_address_new (void)
*
* Create a new CamelNNTPAddress object.
*
- * Return value: A new CamelNNTPAddress object.
+ * Returns: A new CamelNNTPAddress object.
**/
CamelNNTPAddress *
camel_nntp_address_new (void)
*
* Add a new nntp address to the address object. Duplicates are not added twice.
*
- * Return value: Index of added entry, or existing matching entry.
+ * Returns: Index of added entry, or existing matching entry.
**/
gint
camel_nntp_address_add (CamelNNTPAddress *a, const gchar *name)
*
* Get the address at @index.
*
- * Return value: TRUE if such an address exists, or FALSE otherwise.
+ * Returns: TRUE if such an address exists, or FALSE otherwise.
**/
gboolean
camel_nntp_address_get (const CamelNNTPAddress *a, gint index, const gchar **namep)
*
* Get a meta-data on an object.
*
- * Return value: NULL if the meta-data is not set.
+ * Returns: NULL if the meta-data is not set.
**/
gchar *
camel_object_meta_get(gpointer vo, const gchar * name)
*
* Read persistent object state from object_set(CAMEL_OBJECT_STATE_FILE).
*
- * Return value: -1 on error.
+ * Returns: -1 on error.
**/
gint camel_object_state_read(gpointer vo)
{
*
* Write persistent state to the file as set by object_set(CAMEL_OBJECT_STATE_FILE).
*
- * Return value: -1 on error.
+ * Returns: -1 on error.
**/
gint camel_object_state_write(gpointer vo)
{
* camel-objects which can be updated atomically using transaction
* semantics.
*
- * Return value:
+ * Returns:
**/
CamelObjectBag *
camel_object_bag_new(GHashFunc hash, GEqualFunc equal, CamelCopyFunc keycopy, GFreeFunc keyfree)
* Lookup an object by @key. If the key is currently reserved, then
* wait until the key has been committed before continuing.
*
- * Return value: NULL if the object corresponding to @key is not
+ * Returns: NULL if the object corresponding to @key is not
* in the bag. Otherwise a ref'd object pointer which the caller owns
* the ref to.
**/
* Unlike other 'peek' operations, the object is still reffed if
* found.
*
- * Return value: A referenced object, or NULL if @key is not
+ * Returns: A referenced object, or NULL if @key is not
* present in the bag.
**/
gpointer
* You may reserve multiple keys from the same thread, but they should
* always be reserved in the same order, to avoid deadlocks.
*
- * Return value:
+ * Returns:
**/
gpointer
camel_object_bag_reserve(CamelObjectBag *bag, gconstpointer key)
* operations and to obtain notification messages of the internal
* status of messages.
*
- * Return value: A new operation handle.
+ * Returns: A new operation handle.
**/
CamelOperation *
camel_operation_new (CamelOperationStatusFunc status, gpointer status_data)
* Check if cancellation has been applied to @cc. If @cc is NULL,
* then the CamelOperation registered for the current thread is used.
*
- * Return value: TRUE if the operation has been cancelled.
+ * Returns: TRUE if the operation has been cancelled.
**/
gboolean
camel_operation_cancel_check (CamelOperation *cc)
* Retrieve a file descriptor that can be waited on (select, or poll)
* for read, to asynchronously detect cancellation.
*
- * Return value: The fd, or -1 if cancellation is not available
+ * Returns: The fd, or -1 if cancellation is not available
* (blocked, or has not been registered for this thread).
**/
gint
* Retrieve a file descriptor that can be waited on (select, or poll)
* for read, to asynchronously detect cancellation.
*
- * Return value: The fd, or NULL if cancellation is not available
+ * Returns: The fd, or NULL if cancellation is not available
* (blocked, or has not been registered for this thread).
**/
PRFileDesc *
* is %TRUE, it will first load in all available providers that haven't
* yet been loaded.
*
- * Return value: a GList of providers, which the caller must free.
+ * Returns: a GList of providers, which the caller must free.
**/
GList *
camel_provider_list(gboolean load)
* This returns the CamelProvider that would be used to handle
* @url_string, loading it in from disk if necessary.
*
- * Return value: the provider, or %NULL, in which case @ex will be set.
+ * Returns: the provider, or %NULL, in which case @ex will be set.
**/
CamelProvider *
camel_provider_get(const gchar *url_string, CamelException *ex)
* to the range specified by its lower and upper bounds, and the
* stream's eos state will be updated.
*
- * Return value: new position, %-1 if operation failed.
+ * Returns: new position, %-1 if operation failed.
**/
off_t
camel_seekable_stream_seek (CamelSeekableStream *stream, off_t offset,
* the current position of @parent_stream. After the substream has been
* closed, @parent_stream will stabilize again.
*
- * Return value: the substream
+ * Returns: the substream
**/
CamelStream *
camel_seekable_substream_new(CamelSeekableStream *parent_stream, off_t start, off_t end)
/**
* camel_folder_info_new:
*
- * Return value: a new empty CamelFolderInfo instance
+ * Returns: a new empty CamelFolderInfo instance
*
* Since: 2.22
**/
* If @buf is NULL, then allocate and manage @size bytes
* for all buffering.
*
- * Return value: A new stream with buffering applied.
+ * Returns: A new stream with buffering applied.
**/
CamelStream *
camel_stream_buffer_new_with_vbuf (CamelStream *stream, CamelStreamBufferMode mode, gchar *buf, guint32 size)
*
* Returns a PROCESS stream.
*
- * Return value: the stream
+ * Returns: the stream
**/
CamelStream *
camel_stream_process_new (void)
*
* ASCII to-lower function.
*
- * Return value:
+ * Returns:
**/
gchar camel_tolower(gchar c)
{
*
* ASCII to-upper function.
*
- * Return value:
+ * Returns:
**/
gchar camel_toupper(gchar c)
{
*
* The NULL and empty strings are special cased to constant values.
*
- * Return value: A pointer to an equivalent string of @s. Use
+ * Returns: A pointer to an equivalent string of @s. Use
* camel_pstring_free() when it is no longer needed.
**/
const gchar *
*
* The NULL and empty strings are special cased to constant values.
*
- * Return value: A pointer to an equivalent string of @s. Use
+ * Returns: A pointer to an equivalent string of @s. Use
* camel_pstring_free() when it is no longer needed.
*
* Since: 2.24
*
* The NULL and empty strings are special cased to constant values.
*
- * Return value: A pointer to an equivalent string of @s. Use
+ * Returns: A pointer to an equivalent string of @s. Use
* camel_pstring_free() when it is no longer needed.
**/
const gchar *
* doesn't already exist, the UID cache will be empty. Otherwise, if
* it does exist but can't be read, the function will return %NULL.
*
- * Return value: a new UID cache, or %NULL
+ * Returns: a new UID cache, or %NULL
**/
CamelUIDCache *
camel_uid_cache_new (const gchar *filename)
*
* Attempts to save @cache back to disk.
*
- * Return value: success or failure
+ * Returns: success or failure
**/
gboolean
camel_uid_cache_save (CamelUIDCache *cache)
* Returns an array of UIDs from @uids that are not in @cache, and
* removes UIDs from @cache that aren't in @uids.
*
- * Return value: an array of new UIDs, which must be freed with
+ * Returns: an array of new UIDs, which must be freed with
* camel_uid_cache_free_uids().
**/
GPtrArray *
* to the next character position. Invalid utf8 characters will be
* silently skipped. @ptr should point to a NUL terminated array.
*
- * Return value: The next Unicode character. @ptr will be advanced to
+ * Returns: The next Unicode character. @ptr will be advanced to
* the next character always.
**/
guint32
* returned as a sentinel (Unicode 3.1, section 2.7), and @ptr is not
* advanced.
*
- * Return value: The next utf8 char, or 0xffff.
+ * Returns: The next utf8 char, or 0xffff.
**/
guint32
camel_utf8_getc_limit(const guchar **ptr, const guchar *end)
*
* The IMAP rules [rfc2060] are used in the utf7 encoding.
*
- * Return value: The converted string.
+ * Returns: The converted string.
**/
gchar *
camel_utf7_utf8(const gchar *ptr)
*
* The IMAP rules [rfc2060] are used in the utf7 encoding.
*
- * Return value:
+ * Returns:
**/
gchar *
camel_utf8_utf7(const gchar *ptr)
* Convert a utf8 string into a ucs2 one. The ucs string will be in
* network byte order, and terminated with a 16 bit NULL.
*
- * Return value:
+ * Returns:
**/
gchar *
camel_utf8_ucs2(const gchar *pptr)
* Convert a ucs2 string into a utf8 one. The ucs2 string is treated
* as network byte ordered, and terminated with a 16 bit NUL.
*
- * Return value:
+ * Returns:
**/
gchar *camel_ucs2_utf8(const gchar *ptr)
{
*
* Create a new CamelVeeFolder object.
*
- * Return value: A new CamelVeeFolder widget.
+ * Returns: A new CamelVeeFolder widget.
**/
CamelFolder *
camel_vee_folder_new(CamelStore *parent_store, const gchar *full, guint32 flags)
*
* Find the real folder (and uid)
*
- * Return value:
+ * Returns:
**/
CamelFolder *
camel_vee_folder_get_location(CamelVeeFolder *vf, const CamelVeeMessageInfo *vinfo, gchar **realuid)
* This will create a new CamelVeeSummary object and read in the
* summary data from disk, if it exists.
*
- * Return value: A new CamelVeeSummary object.
+ * Returns: A new CamelVeeSummary object.
**/
CamelFolderSummary *
camel_vee_summary_new(CamelFolder *parent)
* This will create a new CamelGroupwiseSummary object and read in the
* summary data from disk, if it exists.
*
- * Return value: A new CamelGroupwiseSummary object.
+ * Returns: A new CamelGroupwiseSummary object.
**/
CamelFolderSummary *
camel_groupwise_summary_new (struct _CamelFolder *folder, const gchar *filename)
*
* If @prefix is non-%NULL, it will be prepended to the returned path.
*
- * Return value: the expanded path
+ * Returns: the expanded path
**/
gchar *
e_path_to_physical (const gchar *prefix, const gchar *vpath)
* Walks the folder tree starting at @prefix and calls @callback
* on each folder.
*
- * Return value: %TRUE on success, %FALSE if an error occurs at any point
+ * Returns: %TRUE on success, %FALSE if an error occurs at any point
**/
gboolean
e_path_find_folders (const gchar *prefix,
* and attempts to remove its parent "subfolders" directory too
* if it's empty.
*
- * Return value: -1 (with errno set) if it failed to rmdir the
+ * Returns: -1 (with errno set) if it failed to rmdir the
* specified directory. 0 otherwise, whether or not it removed
* the parent directory.
**/
* callers can grab and release it themselves if they need to run
* multiple commands atomically.)
*
- * Return value: %NULL if an error occurred (in which case @ex will
+ * Returns: %NULL if an error occurred (in which case @ex will
* be set). Otherwise, a CamelImapResponse describing the server's
* response, which the caller must free with camel_imap_response_free().
**/
* recursive, so callers can grab and release it themselves if they
* need to run multiple commands atomically.)
*
- * Return value: %TRUE if the command was sent successfully, %FALSE if
+ * Returns: %TRUE if the command was sent successfully, %FALSE if
* an error occurred (in which case @ex will be set).
**/
gboolean
*
* This function assumes you have an exclusive lock on the imap stream.
*
- * Return value: as for camel_imap_command(). On failure, the store's
+ * Returns: as for camel_imap_command(). On failure, the store's
* connect_lock will be released.
**/
CamelImapResponse *
* @store into *@response. The caller must free the string when it is
* done with it.
*
- * Return value: One of %CAMEL_IMAP_RESPONSE_CONTINUATION,
+ * Returns: One of %CAMEL_IMAP_RESPONSE_CONTINUATION,
* %CAMEL_IMAP_RESPONSE_UNTAGGED, %CAMEL_IMAP_RESPONSE_TAGGED, or
* %CAMEL_IMAP_RESPONSE_ERROR. If either of the last two, @store's
* command lock will be unlocked.
* and return %NULL. Either way, @response will be freed and the
* store's connect_lock released.
*
- * Return value: the desired response string, which the caller must free.
+ * Returns: the desired response string, which the caller must free.
**/
gchar *
camel_imap_response_extract (CamelImapStore *store,
* response, the function will set @ex, release @store's connect_lock,
* and return %NULL. Either way, @response will be freed.
*
- * Return value: the desired response string, which the caller must free.
+ * Returns: the desired response string, which the caller must free.
**/
gchar *
camel_imap_response_extract_continuation (CamelImapStore *store,
* @summary: CamelFolderSummary for the folder we are caching
* @ex: a CamelException
*
- * Return value: a new CamelImapMessageCache object using @path for
+ * Returns: a new CamelImapMessageCache object using @path for
* storage. If cache files already exist in @path, then any that do not
* correspond to messages in @summary will be deleted.
* @path is scanned for its contents, which means creating a cache object can be
* camel_imap_message_cache_max_uid:
* @cache: the cache
*
- * Return value: the largest (real) UID in the cache.
+ * Returns: the largest (real) UID in the cache.
**/
guint32
camel_imap_message_cache_max_uid (CamelImapMessageCache *cache)
*
* Caches the provided data into @cache.
*
- * Return value: a CamelStream containing the cached data, which the
+ * Returns: a CamelStream containing the cached data, which the
* caller must unref.
**/
CamelStream *
* @part_spec: the part_spec of the data to get
* @ex: exception
*
- * Return value: the filename of a cache item
+ * Returns: the filename of a cache item
**/
gchar *
camel_imap_message_cache_get_filename (CamelImapMessageCache *cache,
* @part_spec: the part_spec of the data to get
* @ex: exception
*
- * Return value: a CamelStream containing the cached data (which the
+ * Returns: a CamelStream containing the cached data (which the
* caller must unref), or %NULL if that data is not cached.
**/
CamelStream *
/**
* camel_imap_search_new:
*
- * Return value: A new CamelImapSearch widget.
+ * Returns: A new CamelImapSearch widget.
**/
CamelFolderSearch *
camel_imap_search_new (const gchar *cachedir)
*
* Create a new CamelImapStoreSummary object.
*
- * Return value: A new CamelImapStoreSummary widget.
+ * Returns: A new CamelImapStoreSummary widget.
**/
CamelImapStoreSummary *
camel_imap_store_summary_new (void)
* A referenced to the summary item is returned, which may be
* ref'd or free'd as appropriate.
*
- * Return value: The summary item, or NULL if the @full_name name
+ * Returns: The summary item, or NULL if the @full_name name
* is not available.
* It must be freed using camel_store_summary_info_free().
**/
* This will create a new CamelImapSummary object and read in the
* summary data from disk, if it exists.
*
- * Return value: A new CamelImapSummary object.
+ * Returns: A new CamelImapSummary object.
**/
CamelFolderSummary *
camel_imap_summary_new (struct _CamelFolder *folder, const gchar *filename)
* Parses a LIST or LSUB response and returns the desired parts of it.
* If @folder is non-%NULL, its value must be freed by the caller.
*
- * Return value: whether or not the response was successfully parsed.
+ * Returns: whether or not the response was successfully parsed.
**/
gboolean
imap_parse_list_response (CamelImapStore *store, const gchar *buf, gint *flags, gchar *sep, gchar **folder)
* Converts label flag name on server to name used in Evolution or back.
* It will never return NULL, it will return empty string, instead.
*
- * @param flag Flag to rename.
- * @param len Length of the flag name.
- * @param server_to_evo if TRUE, then converting server names to evo's names, if FALSE then opposite.
+ * @flag: Flag to rename.
+ * @len: Length of the flag name.
+ * @server_to_evo: if TRUE, then converting server names to evo's names, if FALSE then opposite.
*/
static const gchar *
rename_label_flag (const gchar *flag, gint len, gboolean server_to_evo)
* camel_imap_command(): that line breaks are indicated by LF rather
* than CRLF.
*
- * Return value: the parsed string, or %NULL if a NIL or no string
+ * Returns: the parsed string, or %NULL if a NIL or no string
* was parsed. (In the former case, *@str_p will be %NULL; in the
* latter, it will point to the character after the NIL.)
**/
* imap_quote_string:
* @str: the string to quote, which must not contain CR or LF
*
- * Return value: an IMAP "quoted" corresponding to the string, which
+ * Returns: an IMAP "quoted" corresponding to the string, which
* the caller must free.
**/
gchar *
*
* Note: @uids MUST be in sorted order for this code to work properly.
*
- * Return value: the set, which the caller must free with g_free()
+ * Returns: the set, which the caller must free with g_free()
**/
gchar *
imap_uid_array_to_set (CamelFolderSummary *summary, GPtrArray *uids, gint uid, gssize maxlen, gint *lastuid)
* of @summary, the function will assume that all of the "missing" UIDs
* do exist.
*
- * Return value: the array of uids, which the caller must free with
+ * Returns: the array of uids, which the caller must free with
* imap_uid_array_free(). (Or %NULL if the uid set can't be parsed.)
**/
GPtrArray *
* Walks the folder tree starting at @prefix and calls @callback
* on each folder.
*
- * Return value: %TRUE on success, %FALSE if an error occurs at any point
+ * Returns: %TRUE on success, %FALSE if an error occurs at any point
**/
gboolean
imap_path_find_folders (const gchar *prefix, IMAPPathFindFoldersCallback callback, gpointer data)
*
* Create a new CamelIMAPXStoreSummary object.
*
- * Return value: A new CamelIMAPXStoreSummary widget.
+ * Returns: A new CamelIMAPXStoreSummary widget.
**/
CamelIMAPXStoreSummary *
camel_imapx_store_summary_new (void)
* A referenced to the summary item is returned, which may be
* ref'd or free'd as appropriate.
*
- * Return value: The summary item, or NULL if the @full_name name
+ * Returns: The summary item, or NULL if the @full_name name
* is not available.
* It must be freed using camel_store_summary_info_free().
**/
* Returns a NULL stream. A null stream is always at eof, and
* always returns success for all reads and writes.
*
- * Return value: the stream
+ * Returns: the stream
**/
CamelStream *
camel_imapx_stream_new(CamelStream *source)
* This will create a new CamelIMAPXSummary object and read in the
* summary data from disk, if it exists.
*
- * Return value: A new CamelIMAPXSummary object.
+ * Returns: A new CamelIMAPXSummary object.
**/
CamelFolderSummary *
camel_imapx_summary_new (struct _CamelFolder *folder, const gchar *filename)
* if the flags does not match returns the original one as it is.
* It will never return NULL, it will return empty string, instead.
*
- * @param flag Flag to rename.
- * @param len Length of the flag name.
- * @param server_to_evo if TRUE, then converting server names to evo's names, if FALSE then opposite.
+ * @flag: Flag to rename.
+ * @len: Length of the flag name.
+ * @server_to_evo: if TRUE, then converting server names to evo's names, if FALSE then opposite.
*/
static const gchar *
rename_label_flag (const gchar *flag, gint len, gboolean server_to_evo)
*
* Create a new CamelIMAPXViewSummary object.
*
- * Return value: A new CamelIMAPXViewSummary widget.
+ * Returns: A new CamelIMAPXViewSummary widget.
**/
CamelIMAPXViewSummary *
camel_imapx_view_summary_new(const gchar *base, CamelException *ex)
* If @status is non NULL, then a Status header line is also written.
* The headers written are termianted with a blank line.
*
- * Return value: -1 on error, otherwise the number of bytes written.
+ * Returns: -1 on error, otherwise the number of bytes written.
**/
gint
camel_local_summary_write_headers(gint fd, struct _camel_header_raw *header, const gchar *xevline, const gchar *status, const gchar *xstatus)
*
* Create a new CamelMaildirSummary object.
*
- * Return value: A new #CamelMaildirSummary object.
+ * Returns: A new #CamelMaildirSummary object.
**/
CamelMaildirSummary
*camel_maildir_summary_new(struct _CamelFolder *folder, const gchar *filename, const gchar *maildirdir, CamelIndex *index)
*
* Create a new CamelMboxSummary object.
*
- * Return value: A new CamelMboxSummary widget.
+ * Returns: A new CamelMboxSummary widget.
**/
CamelMboxSummary *
camel_mbox_summary_new(struct _CamelFolder *folder, const gchar *filename, const gchar *mbox_name, CamelIndex *index)
*
* Create a new CamelMhSummary object.
*
- * Return value: A new #CamelMhSummary object.
+ * Returns: A new #CamelMhSummary object.
**/
CamelMhSummary *camel_mh_summary_new(struct _CamelFolder *folder, const gchar *filename, const gchar *mhdir, CamelIndex *index)
{
*
* Create a new CamelNNTPStoreSummary object.
*
- * Return value: A new CamelNNTPStoreSummary widget.
+ * Returns: A new CamelNNTPStoreSummary widget.
**/
CamelNNTPStoreSummary *
camel_nntp_store_summary_new (void)
* A referenced to the summary item is returned, which may be
* ref'd or free'd as appropriate.
*
- * Return value: The summary item, or NULL if the @full_name name
+ * Returns: The summary item, or NULL if the @full_name name
* is not available.
* It must be freed using camel_store_summary_info_free().
**/
* Returns a NULL stream. A null stream is always at eof, and
* always returns success for all reads and writes.
*
- * Return value: the stream
+ * Returns: the stream
**/
CamelStream *
camel_nntp_stream_new(CamelStream *source)
* Returns a NULL stream. A null stream is always at eof, and
* always returns success for all reads and writes.
*
- * Return value: the stream
+ * Returns: the stream
**/
CamelPOP3Engine *
camel_pop3_engine_new(CamelStream *source, guint32 flags)
* Returns a NULL stream. A null stream is always at eof, and
* always returns success for all reads and writes.
*
- * Return value: the stream
+ * Returns: the stream
**/
CamelStream *
camel_pop3_stream_new(CamelStream *source)
* Creates a new #EFileCache object, which implements a cache of
* objects, very useful for remote backends.
*
- * Return value: The newly created object.
+ * Returns: The newly created object.
*/
EFileCache *
e_file_cache_new (const gchar *filename)
*
* Gets the name of the file where the cache is being stored.
*
- * Return value: The name of the cache.
+ * Returns: The name of the cache.
*/
const gchar *
e_file_cache_get_filename (EFileCache *cache)
* you must call e_account_list_save() to push the changes back to
* GConf.
*
- * Return value: the list of accounts
+ * Returns: the list of accounts
**/
EAccountList *
e_account_list_new (GConfClient *gconf)
* Get the default account. If no default is specified, or the default
* has become stale, then the first account is made the default.
*
- * Return value: The account or NULL if no accounts are defined.
+ * Returns: The account or NULL if no accounts are defined.
**/
const EAccount *
e_account_list_get_default(EAccountList *accounts)
* E_ACCOUNT_FIND_ID_NAME - Find an account by the owner's identity name.
* E_ACCOUNT_FIND_ID_ADDRESS - Find an account by the owner's identity address.
*
- * Return value: The account or NULL if it doesn't exist.
+ * Returns: The account or NULL if it doesn't exist.
**/
const EAccount *
e_account_list_find(EAccountList *accounts, e_account_find_t type, const gchar *key)
/**
* e_account_new:
*
- * Return value: a blank new account which can be filled in and
+ * Returns: a blank new account which can be filled in and
* added to an #EAccountList.
**/
EAccount *
* e_account_new_from_xml:
* @xml: an XML account description
*
- * Return value: a new #EAccount based on the data in @xml, or %NULL
+ * Returns: a new #EAccount based on the data in @xml, or %NULL
* if @xml could not be parsed as valid account data.
**/
EAccount *
*
* Changes @account to match @xml.
*
- * Return value: %TRUE if @account was changed, %FALSE if @account
+ * Returns: %TRUE if @account was changed, %FALSE if @account
* already matched @xml or @xml could not be parsed
**/
gboolean
* e_account_to_xml:
* @account: an #EAccount
*
- * Return value: an XML representation of @account, which the caller
+ * Returns: an XML representation of @account, which the caller
* must free.
**/
gchar *
* e_account_uid_from_xml:
* @xml: an XML account description
*
- * Return value: the permanent UID of the account described by @xml
+ * Returns: the permanent UID of the account described by @xml
* (or %NULL if @xml could not be parsed or did not contain a uid).
* The caller must free this string.
**/
*
* Returns a sorted list of all the category names currently configured.
*
- * Return value: a sorted GList containing the names of the categories. The
+ * Returns: a sorted GList containing the names of the categories. The
* list should be freed using g_list_free, but the names of the categories
* should not be touched at all, they are internal strings.
*/
*
* Checks whether the given category is available in the configuration.
*
- * Return value: %TRUE if the category is available, %FALSE otherwise.
+ * Returns: %TRUE if the category is available, %FALSE otherwise.
*/
gboolean
e_categories_exist (const gchar *category)
*
* Gets the icon file associated with the given category.
*
- * Return value: icon file name.
+ * Returns: icon file name.
*/
const gchar *
e_categories_get_icon_file_for (const gchar *category)
* e_memchunks are effectively the same as gmemchunks, only faster (much), and
* they use less memory overhead for housekeeping.
*
- * Return value: The new header.
+ * Returns: The new header.
**/
MemChunk *e_memchunk_new(gint atomcount, gint atomsize)
{
* However, each allocation cannot be freed individually, only all
* or nothing.
*
- * Return value:
+ * Returns:
**/
MemPool *e_mempool_new(gint blocksize, gint threshold, EMemPoolFlags flags)
{
* change as arrays of this size suffer significant performance
* penalties when looking up strings with high indices.
*
- * Return value:
+ * Returns:
**/
struct _EStrv *
e_strv_new(gint size)
* The memory used by the original @strv is not freed until
* the new strv is packed, or freed itself.
*
- * Return value: A new EStrv if the strv has already
+ * Returns: A new EStrv if the strv has already
* been packed, otherwise @strv.
**/
struct _EStrv *
* is not copied until the strv is packed, and not at
* all if the index is overwritten.
*
- * Return value: @strv if already unpacked, otherwise an packed
+ * Returns: @strv if already unpacked, otherwise an packed
* EStrv.
**/
struct _EStrv *
* If @strv has been packed, then it is unpacked ready
* for more inserts, and should be packed again once finished with.
*
- * Return value: A new EStrv if the strv has already
+ * Returns: A new EStrv if the strv has already
* been packed, otherwise @strv.
**/
struct _EStrv *
* All strings are packed into a single allocated block, separated
* by single \0 characters, together with a count byte.
*
- * Return value:
+ * Returns:
**/
struct _EStrv *
e_strv_pack(struct _EStrv *strv)
* identically on both packed and unpacked strv's, although
* may be much slower on a packed strv.
*
- * Return value:
+ * Returns:
**/
const gchar *
e_strv_get(struct _EStrv *strv, gint index)
* we should probably in the future ref count the strings contained in
* the hash table, but for now let's not.
*
- * Return value: new pooled string vector
+ * Returns: new pooled string vector
**/
EPoolv *
e_poolv_new(guint size)
*
* Copy the contents of a pooled string vector
*
- * Return value: @dest, which may be re-allocated if the strings
+ * Returns: @dest, which may be re-allocated if the strings
* are different lengths.
**/
EPoolv *
* referencing the string, freeit should be TRUE. Otherwise, this
* will duplicate the string if it is not found in the pool.
*
- * Return value: @poolv
+ * Returns: @poolv
**/
EPoolv *
e_poolv_set (EPoolv *poolv, gint index, gchar *str, gint freeit)
* Since the pool is never freed, this string does not need to be
* duplicated, but should not be modified.
*
- * Return value: string at that index.
+ * Returns: string at that index.
**/
const gchar *
e_poolv_get(EPoolv *poolv, gint index)
* Setup a new timeout cache. @nodesize is the size of nodes in the
* cache, and @nodefree will be called to free YOUR content.
*
- * Return value:
+ * Returns:
**/
EMCache *
em_cache_new(time_t timeout, gsize nodesize, GFreeFunc nodefree)
* Lookup a cache node. once you're finished with it, you need to
* unref it.
*
- * Return value:
+ * Returns:
**/
EMCacheNode *
em_cache_lookup(EMCache *emc, const gchar *key)
* Create a new key'd cache node. The node will not be added to the
* cache until you insert it.
*
- * Return value:
+ * Returns:
**/
EMCacheNode *
em_cache_node_new(EMCache *emc, const gchar *key)
*
* Compares if @a is equivalent to @b.
*
- * Return value: %TRUE if @a is equivalent to @b,
+ * Returns: %TRUE if @a is equivalent to @b,
* %FALSE otherwise.
*
* Since: 2.24
*
* Compares if @a is equivalent to @b.
*
- * Return value: %TRUE if @a is equivalent to @b,
+ * Returns: %TRUE if @a is equivalent to @b,
* %FALSE otherwise.
*
* Since: 2.24
*
* Update the ESource properties from @node.
*
- * Return value: %TRUE if the data in @node was recognized and parsed into
+ * Returns: %TRUE if the data in @node was recognized and parsed into
* acceptable values for @source, %FALSE otherwise.
**/
gboolean
* Assuming that @node is a valid ESource specification, retrieve the name of
* the source from it.
*
- * Return value: Name of the source in the specified @node. The caller must
+ * Returns: Name of the source in the specified @node. The caller must
* free the string.
**/
gchar *
* Return the textual representation of the color for @source, or %NULL if it
* has none. The returned string should be parsable by #gdk_color_parse().
*
- * Return value: a string specifying the color
+ * Returns: a string specifying the color
*
* Since: 1.10
**/
*
* If @source has an associated color, return it in *@color_return.
*
- * Return value: %TRUE if the @source has a defined color (and hence
+ * Returns: %TRUE if the @source has a defined color (and hence
* *@color_return was set), %FALSE otherwise.
**/
gboolean
*
* Compares if @a is equivalent to @b.
*
- * Return value: %TRUE if @a is equivalent to @b,
+ * Returns: %TRUE if @a is equivalent to @b,
* %FALSE otherwise.
*
* Since: 2.24
*
* Compares if @a is equivalent to @b.
*
- * Return value: %TRUE if @a is equivalent to @b,
+ * Returns: %TRUE if @a is equivalent to @b,
* %FALSE otherwise.
*
* Since: 2.24
*
* Generate a new unique string for use e.g. in account lists.
*
- * Return value: The newly generated UID. The caller should free the string
+ * Returns: The newly generated UID. The caller should free the string
* when it's done with it.
**/
gchar *
* if it succeeded or not. If you don't care, you can pass %NULL for
* @open_func, and no action will be taken on completion.
*
- * Return value: A new #EBook that is being opened.
+ * Returns: A new #EBook that is being opened.
**/
EBook *
e_load_book_source (ESource *source, EBookCallback open_func, gpointer user_data)
*
* Creates a new #EContactStore.
*
- * Return value: A new #EContactStore.
+ * Returns: A new #EContactStore.
**/
EContactStore *
e_contact_store_new (void)
*
* Gets the #EBook that provided the contact at @iter.
*
- * Return value: An #EBook.
+ * Returns: An #EBook.
**/
EBook *
e_contact_store_get_book (EContactStore *contact_store, GtkTreeIter *iter)
*
* Gets the #EContact at @iter.
*
- * Return value: An #EContact.
+ * Returns: An #EContact.
**/
EContact *
e_contact_store_get_contact (EContactStore *contact_store, GtkTreeIter *iter)
*
* Sets @iter to point to the contact row matching @uid.
*
- * Return value: %TRUE if the contact was found, and @iter was set. %FALSE otherwise.
+ * Returns: %TRUE if the contact was found, and @iter was set. %FALSE otherwise.
**/
gboolean
e_contact_store_find_contact (EContactStore *contact_store, const gchar *uid,
*
* Gets the list of books that provide contacts for @contact_store.
*
- * Return value: A #GList of pointers to #EBook. The caller owns the list,
+ * Returns: A #GList of pointers to #EBook. The caller owns the list,
* but not the books.
**/
GList *
* Gets the query that's being used to fetch contacts from the books
* assigned to @contact_store.
*
- * Return value: The #EBookQuery being used.
+ * Returns: The #EBookQuery being used.
**/
EBookQuery *
e_contact_store_peek_query (EContactStore *contact_store)
*
* Creates a new #EDestinationStore.
*
- * Return value: A new #EDestinationStore.
+ * Returns: A new #EDestinationStore.
**/
EDestinationStore *
e_destination_store_new (void)
*
* Gets the #EDestination from @destination_store at @iter.
*
- * Return value: An #EDestination.
+ * Returns: An #EDestination.
**/
EDestination *
e_destination_store_get_destination (EDestinationStore *destination_store, GtkTreeIter *iter)
*
* Gets a list of all the #EDestinations in @destination_store.
*
- * Return value: A #GList of pointers to #EDestination. The list is owned
+ * Returns: A #GList of pointers to #EDestination. The list is owned
* by the caller, but the #EDestination elements aren't.
**/
GList *
*
* Creates a new #ENameSelectorDialog.
*
- * Return value: A new #ENameSelectorDialog.
+ * Returns: A new #ENameSelectorDialog.
**/
ENameSelectorDialog *
e_name_selector_dialog_new (void)
*
* Gets the #ENameSelectorModel used by @name_selector_model.
*
- * Return value: The #ENameSelectorModel being used.
+ * Returns: The #ENameSelectorModel being used.
**/
ENameSelectorModel *
e_name_selector_dialog_peek_model (ENameSelectorDialog *name_selector_dialog)
*
* Creates a new #ENameSelectorEntry.
*
- * Return value: A new #ENameSelectorEntry.
+ * Returns: A new #ENameSelectorEntry.
**/
ENameSelectorEntry *
e_name_selector_entry_new (void)
*
* Gets the #EContactStore being used by @name_selector_entry.
*
- * Return value: An #EContactStore.
+ * Returns: An #EContactStore.
**/
EContactStore *
e_name_selector_entry_peek_contact_store (ENameSelectorEntry *name_selector_entry)
*
* Gets the #EDestinationStore being used to store @name_selector_entry's destinations.
*
- * Return value: An #EDestinationStore.
+ * Returns: An #EDestinationStore.
**/
EDestinationStore *
e_name_selector_entry_peek_destination_store (ENameSelectorEntry *name_selector_entry)
*
* Creates a new #ENameSelectorModel.
*
- * Return value: A new #ENameSelectorModel.
+ * Returns: A new #ENameSelectorModel.
**/
ENameSelectorModel *
e_name_selector_model_new (void)
*
* Gets the #EContactStore associated with @name_selector_model.
*
- * Return value: An #EContactStore.
+ * Returns: An #EContactStore.
**/
EContactStore *
e_name_selector_model_peek_contact_store (ENameSelectorModel *name_selector_model)
* Gets the #ETreeModelGenerator being used to filter and/or extend the
* list of contacts in @name_selector_model's #EContactStore.
*
- * Return value: An #ETreeModelGenerator.
+ * Returns: An #ETreeModelGenerator.
**/
ETreeModelGenerator *
e_name_selector_model_peek_contact_filter (ENameSelectorModel *name_selector_model)
*
* Gets a list of the destination sections in @name_selector_model.
*
- * Return value: A #GList of pointers to strings. The #GList and the
+ * Returns: A #GList of pointers to strings. The #GList and the
* strings belong to the caller, and must be freed when no longer needed.
**/
GList *
*
* Creates a new #ENameSelector.
*
- * Return value: A new #ENameSelector.
+ * Returns: A new #ENameSelector.
**/
ENameSelector *
e_name_selector_new (void)
*
* Gets the #ENameSelectorModel used by @name_selector.
*
- * Return value: The #ENameSelectorModel used by @name_selector.
+ * Returns: The #ENameSelectorModel used by @name_selector.
**/
ENameSelectorModel *
e_name_selector_peek_model (ENameSelector *name_selector)
*
* Gets the #ENameSelectorDialog used by @name_selector.
*
- * Return value: The #ENameSelectorDialog used by @name_selector.
+ * Returns: The #ENameSelectorDialog used by @name_selector.
**/
ENameSelectorDialog *
e_name_selector_peek_dialog (ENameSelector *name_selector)
*
* Gets the #ENameSelectorEntry for the section specified by @name.
*
- * Return value: The #ENameSelectorEntry for the named section, or %NULL if it
+ * Returns: The #ENameSelectorEntry for the named section, or %NULL if it
* doesn't exist in the #ENameSelectorModel.
**/
ENameSelectorEntry *
*
* Gets the #ENameSelectorList for the section specified by @name.
*
- * Return value: The #ENameSelectorList for the named section, or %NULL if it
+ * Returns: The #ENameSelectorList for the named section, or %NULL if it
* doesn't exist in the #ENameSelectorModel.
**/
* e_passwords_get_password:
* @key: the key
*
- * Return value: the password associated with @key, or %NULL. Caller
+ * Returns: the password associated with @key, or %NULL. Caller
* must free the returned password.
**/
gchar *
*
* Asks the user for a password.
*
- * Return value: the password, which the caller must free, or %NULL if
+ * Returns: the password, which the caller must free, or %NULL if
* the user cancelled the operation. *@remember will be set if the
* return value is non-%NULL and @remember_type is not
* E_PASSWORDS_DO_NOT_REMEMBER.
* Creates a new #ESourceOptionMenu widget that lets the user pick
* an #ESource from the provided #ESourceList.
*
- * Return value: A new #ESourceOptionMenu.
+ * Returns: A new #ESourceOptionMenu.
**/
GtkWidget *
e_source_option_menu_new (ESourceList *source_list)
* e_source_option_menu_peek_selected:
* @menu: an #ESourceOptionMenu
*
- * Return value: The selected #ESource, or %NULL if none was selected.
+ * Returns: The selected #ESource, or %NULL if none was selected.
**/
ESource *
e_source_option_menu_peek_selected (ESourceOptionMenu *menu)
*
* Create a new source selector dialog for the given @list.
*
- * Return value: The newly created widget.
+ * Returns: The newly created widget.
*/
GtkWidget *
e_source_selector_dialog_new (GtkWindow *parent, ESourceList *source_list)
*
* Selects default source in the dialog.
*
- * Return value: Whether found any default source.
+ * Returns: Whether found any default source.
*
* Since: 2.28
**/
*
* Peek the currently selected source in the given @dialog.
*
- * Return value: the selected ESource.
+ * Returns: the selected ESource.
*/
ESource *
e_source_selector_dialog_peek_primary_selection (ESourceSelectorDialog *dialog)
* Create a new view for @list. The view will update automatically when @list
* changes.
*
- * Return value: The newly created widget.
+ * Returns: The newly created widget.
**/
GtkWidget *
e_source_selector_new (ESourceList *list)
* Get the list of selected sources, i.e. those that were enabled through the
* corresponding checkboxes in the tree.
*
- * Return value: A list of the ESources currently selected. The sources will
+ * Returns: A list of the ESources currently selected. The sources will
* be in the same order as they appear on the screen, and the list should be
* freed using e_source_selector_free_selection().
**/
*
* Gets the primary source group associated with the selector.
*
- * Return value: primary_source_group if selector is valid, NULL otherwise.
+ * Returns: primary_source_group if selector is valid, NULL otherwise.
**/
ESourceGroup *
e_source_selector_get_primary_source_group (ESourceSelector *selector)
*
* Check whether the checkboxes in the ESourceSelector are being shown or not.
*
- * Return value: %TRUE if the checkboxes are shown, %FALSE otherwise.
+ * Returns: %TRUE if the checkboxes are shown, %FALSE otherwise.
**/
gboolean
e_source_selector_selection_shown (ESourceSelector *selector)
*
* Check whether @source is selected in @selector.
*
- * Return value: %TRUE if @source is currently selected, %FALSE otherwise.
+ * Returns: %TRUE if @source is currently selected, %FALSE otherwise.
**/
gboolean
e_source_selector_source_is_selected (ESourceSelector *selector,
* to the "normal" selection, which is the set of source whose checkboxes are
* checked).
*
- * Return value: The selected source.
+ * Returns: The selected source.
**/
ESource *
e_source_selector_peek_primary_selection (ESourceSelector *selector)
*
* Creates a new #ETreeModelGenerator wrapping @child_model.
*
- * Return value: A new #ETreeModelGenerator.
+ * Returns: A new #ETreeModelGenerator.
**/
ETreeModelGenerator *
e_tree_model_generator_new (GtkTreeModel *child_model)
*
* Gets the child model being wrapped by @tree_model_generator.
*
- * Return value: A #GtkTreeModel being wrapped.
+ * Returns: A #GtkTreeModel being wrapped.
**/
GtkTreeModel *
e_tree_model_generator_get_model (ETreeModelGenerator *tree_model_generator)
*
* Convert a path to a child row to a path to a @tree_model_generator row.
*
- * Return value: A new GtkTreePath, owned by the caller.
+ * Returns: A new GtkTreePath, owned by the caller.
**/
GtkTreePath *
e_tree_model_generator_convert_child_path_to_path (ETreeModelGenerator *tree_model_generator,
*
* Converts @generator_path to a corresponding #GtkTreePath in the child model.
*
- * Return value: A new #GtkTreePath, owned by the caller.
+ * Returns: A new #GtkTreePath, owned by the caller.
**/
GtkTreePath *
e_tree_model_generator_convert_path_to_child_path (ETreeModelGenerator *tree_model_generator,
* Returns the namespace prefix for @ns_uri (or an empty string if
* @ns_uri is set to the default namespace)
*
- * Return value: The namespace prefix, or %NULL if no namespace exists
+ * Returns: The namespace prefix, or %NULL if no namespace exists
* for the URI given.
*/
const gchar *
* Returns the internal XML representation tree of the
* #SoupSoapMessage pointed to by @msg.
*
- * Return value: the #xmlDocPtr representing the SOAP message.
+ * Returns: the #xmlDocPtr representing the SOAP message.
*/
xmlDocPtr
soup_soap_message_get_xml_doc (SoupSoapMessage *msg)
*
* Parses the response returned by the server.
*
- * Return value: a #SoupSoapResponse representing the response from
+ * Returns: a #SoupSoapResponse representing the response from
* the server, or %NULL if there was an error.
*/
SoupSoapResponse *
* Create a new empty #SoupSoapResponse object, which can be modified
* with the accessor functions provided with this class.
*
- * Return value: the new #SoupSoapResponse (or %NULL if there was an
+ * Returns: the new #SoupSoapResponse (or %NULL if there was an
* error).
*/
SoupSoapResponse *
* Create a new #SoupSoapResponse object from the XML string contained
* in @xmlstr.
*
- * Return value: the new #SoupSoapResponse (or %NULL if there was an
+ * Returns: the new #SoupSoapResponse (or %NULL if there was an
* error).
*/
SoupSoapResponse *
* Parses the string contained in @xmlstr and sets all properties from
* it in the @response object.
*
- * Return value: %TRUE if successful, %FALSE otherwise.
+ * Returns: %TRUE if successful, %FALSE otherwise.
*/
gboolean
soup_soap_response_from_string (SoupSoapResponse *response, const gchar *xmlstr)
*
* Gets the method name from the SOAP response.
*
- * Return value: the method name.
+ * Returns: the method name.
*/
const gchar *
soup_soap_response_get_method_name (SoupSoapResponse *response)
*
* Returns the parameter name.
*
- * Return value: the parameter name.
+ * Returns: the parameter name.
*/
const gchar *
soup_soap_parameter_get_name (SoupSoapParameter *param)
*
* Returns the parameter's (integer) value.
*
- * Return value: the parameter value as an integer
+ * Returns: the parameter value as an integer
*/
gint
soup_soap_parameter_get_int_value (SoupSoapParameter *param)
*
* Returns the parameter's value.
*
- * Return value: the parameter value as a string, which must be freed
+ * Returns: the parameter value as a string, which must be freed
* by the caller.
*/
gchar *
* for compound data types, which can contain several parameters
* themselves.
*
- * Return value: the first child or %NULL if there are no children.
+ * Returns: the first child or %NULL if there are no children.
*/
SoupSoapParameter *
soup_soap_parameter_get_first_child (SoupSoapParameter *param)
* Gets the first child of the given #SoupSoapParameter whose name is
* @name.
*
- * Return value: the first child with the given name or %NULL if there
+ * Returns: the first child with the given name or %NULL if there
* are no children.
*/
SoupSoapParameter *
*
* FIXME: the name of this method is wrong
*
- * Return value: the next sibling, or %NULL if there are no more
+ * Returns: the next sibling, or %NULL if there are no more
* siblings.
*/
SoupSoapParameter *
*
* FIXME: the name of this method is wrong
*
- * Return value: the next sibling with the given name, or %NULL
+ * Returns: the next sibling with the given name, or %NULL
*/
SoupSoapParameter *
soup_soap_parameter_get_next_child_by_name (SoupSoapParameter *param,
*
* Returns the named property of @param.
*
- * Return value: the property, which must be freed by the caller.
+ * Returns: the property, which must be freed by the caller.
*/
gchar *
soup_soap_parameter_get_property (SoupSoapParameter *param, const gchar *prop_name)
*
* Returns the list of parameters received in the SOAP response.
*
- * Return value: a list of #SoupSoapParameter
+ * Returns: a list of #SoupSoapParameter
*/
const GList *
soup_soap_response_get_parameters (SoupSoapResponse *response)
*
* Retrieves the first parameter contained in the SOAP response.
*
- * Return value: a #SoupSoapParameter representing the first
+ * Returns: a #SoupSoapParameter representing the first
* parameter, or %NULL if there are no parameters.
*/
SoupSoapParameter *
* Retrieves the first parameter contained in the SOAP response whose
* name is @name.
*
- * Return value: a #SoupSoapParameter representing the first parameter
+ * Returns: a #SoupSoapParameter representing the first parameter
* with the given name, or %NULL.
*/
SoupSoapParameter *
* Retrieves the parameter following @from in the #SoupSoapResponse
* object.
*
- * Return value: a #SoupSoapParameter representing the parameter.
+ * Returns: a #SoupSoapParameter representing the parameter.
*/
SoupSoapParameter *
soup_soap_response_get_next_parameter (SoupSoapResponse *response,
* Retrieves the first parameter following @from in the
* #SoupSoapResponse object whose name matches @name.
*
- * Return value: a #SoupSoapParameter representing the parameter.
+ * Returns: a #SoupSoapParameter representing the parameter.
*/
SoupSoapParameter *
soup_soap_response_get_next_parameter_by_name (SoupSoapResponse *response,