Commit 54e52e09 authored by Matthias Clasen's avatar Matthias Clasen

More trivial doc fixes

svn path=/trunk/; revision=5968
parent 82d1ac18
2007-11-27 Matthias Clasen <mclasen@redhat.com>
* gcontenttype.c: Move doc comments to the unix section.
* *.[hc]: More trivial doc corrections.
2007-11-27 Matthias Clasen <mclasen@redhat.com>
* gpollfilemonitor.c:
......
......@@ -307,7 +307,7 @@ g_app_info_add_supports_type (GAppInfo *appinfo,
/**
* g_app_info_can_remove_support_type:
* g_app_info_can_remove_supports_type:
* @appinfo: a #GAppInfo.
*
* Checks if a supported content type can be removed from an application.
......
......@@ -28,11 +28,6 @@
#include "gcontenttypeprivate.h"
#include "glibintl.h"
/* This really sucks. GTK-Doc isn't smart enough to realize there are two
* different versions of the functions within this file, based on the platform.
* I can move the definitions out of this file, but that's ugly.
*/
/**
* SECTION:gcontenttype
* @short_description: platform specific content typing
......@@ -82,16 +77,6 @@ get_registry_classes_key (const char *subdir,
return value_utf8;
}
/**
* g_content_type_equals:
* @type1: a content type string.
* @type2: a content type string.
*
* Compares two content types for equality.
*
* Returns: %TRUE if the two strings are identical or equivalent,
* %FALSE otherwise.
**/
gboolean
g_content_type_equals (const char *type1,
const char *type2)
......@@ -117,16 +102,6 @@ g_content_type_equals (const char *type1,
return res;
}
/**
* g_content_type_is_a:
* @type: a content type string.
* @supertype: a string.
*
* Determines if @type is a subset of @supertype.
*
* Returns: %TRUE if @type is a kind of @supertype,
* %FALSE otherwise.
**/
gboolean
g_content_type_is_a (const char *type,
const char *supertype)
......@@ -149,14 +124,6 @@ g_content_type_is_a (const char *type,
return res;
}
/**
* g_content_type_is_unknown:
* @type: a content type string.
*
* Checks if the content type is known by GIO.
*
* Returns: %TRUE if the type is unknown.
**/
gboolean
g_content_type_is_unknown (const char *type)
{
......@@ -165,14 +132,6 @@ g_content_type_is_unknown (const char *type)
return strcmp ("*", type) == 0;
}
/**
* g_content_type_get_description:
* @type: a content type string.
*
* Gets the human readable description of the content type.
*
* Returns: a short description of the content type @type.
**/
char *
g_content_type_get_description (const char *type)
{
......@@ -196,14 +155,6 @@ g_content_type_get_description (const char *type)
return g_strdup_printf (_("%s filetype"), type);
}
/**
* g_content_type_get_mime_type:
* @type: a content type string.
*
* Gets the mime-type for the content type.
*
* Returns: the registered mime-type for the given @type.
**/
char *
g_content_type_get_mime_type (const char *type)
{
......@@ -223,14 +174,6 @@ g_content_type_get_mime_type (const char *type)
return g_strdup ("application/octet-stream");
}
/**
* g_content_type_get_icon:
* @type: a content type string.
*
* Gets the icon for a content type.
*
* Returns: #GIcon corresponding to the content type.
**/
GIcon *
g_content_type_get_icon (const char *type)
{
......@@ -246,16 +189,6 @@ g_content_type_get_icon (const char *type)
return NULL;
}
/**
* g_content_type_can_be_executable:
* @type: a content type string.
*
* Checks if a content type can be executable. Note that for instance
* things like text files can be executables (i.e. scripts and batch files).
*
* Returns: %TRUE if the file type corresponds to a type that
* can be executable, %FALSE otherwise.
**/
gboolean
g_content_type_can_be_executable (const char *type)
{
......@@ -282,20 +215,6 @@ looks_like_text (const guchar *data, gsize data_size)
return TRUE;
}
/**
* g_content_type_guess:
* @filename: a string.
* @data: a stream of data.
* @data_size: the size of @data.
* @result_uncertain: a flag indicating the certainty of the
* result.
*
* Guesses the content type based on example data. If the function is
* uncertain, @result_uncertain will be set to %TRUE.
*
* Returns: a string indicating a guessed content type for the
* given data.
**/
char *
g_content_type_guess (const char *filename,
const guchar *data,
......@@ -326,14 +245,6 @@ g_content_type_guess (const char *filename,
return g_strdup ("*");
}
/**
* g_content_types_get_registered:
*
* Gets a list of strings containing the registered content types on
* the system.
*
* Returns: #GList of the registered content types.
**/
GList *
g_content_types_get_registered (void)
{
......@@ -428,6 +339,16 @@ _g_unix_content_type_get_parents (const char *type)
return (char **)g_ptr_array_free (array, FALSE);
}
/**
* g_content_type_equals:
* @type1: a content type string.
* @type2: a content type string.
*
* Compares two content types for equality.
*
* Returns: %TRUE if the two strings are identical or equivalent,
* %FALSE otherwise.
**/
gboolean
g_content_type_equals (const char *type1,
const char *type2)
......@@ -444,6 +365,16 @@ g_content_type_equals (const char *type1,
return res;
}
/**
* g_content_type_is_a:
* @type: a content type string.
* @supertype: a string.
*
* Determines if @type is a subset of @supertype.
*
* Returns: %TRUE if @type is a kind of @supertype,
* %FALSE otherwise.
**/
gboolean
g_content_type_is_a (const char *type,
const char *supertype)
......@@ -460,6 +391,14 @@ g_content_type_is_a (const char *type,
return res;
}
/**
* g_content_type_is_unknown:
* @type: a content type string.
*
* Checks if the content type is known by GIO.
*
* Returns: %TRUE if the type is unknown.
**/
gboolean
g_content_type_is_unknown (const char *type)
{
......@@ -624,6 +563,14 @@ load_comment_for_mime (const char *mimetype)
return g_strdup_printf (_("%s type"), mimetype);
}
/**
* g_content_type_get_description:
* @type: a content type string.
*
* Gets the human readable description of the content type.
*
* Returns: a short description of the content type @type.
**/
char *
g_content_type_get_description (const char *type)
{
......@@ -654,6 +601,14 @@ g_content_type_get_description (const char *type)
return comment;
}
/**
* g_content_type_get_mime_type:
* @type: a content type string.
*
* Gets the mime-type for the content type.
*
* Returns: the registered mime-type for the given @type.
**/
char *
g_content_type_get_mime_type (const char *type)
{
......@@ -662,6 +617,14 @@ g_content_type_get_mime_type (const char *type)
return g_strdup (type);
}
/**
* g_content_type_get_icon:
* @type: a content type string.
*
* Gets the icon for a content type.
*
* Returns: #GIcon corresponding to the content type.
**/
GIcon *
g_content_type_get_icon (const char *type)
{
......@@ -675,9 +638,11 @@ g_content_type_get_icon (const char *type)
* g_content_type_can_be_executable:
* @type: a content type string.
*
* Returns: %TRUE if the file type corresponds to something that
* can be executable, %FALSE otherwise. Note that for instance
* things like textfiles can be executables (i.e. scripts)
* Checks if a content type can be executable. Note that for instance
* things like text files can be executables (i.e. scripts and batch files).
*
* Returns: %TRUE if the file type corresponds to a type that
* can be executable, %FALSE otherwise.
**/
gboolean
g_content_type_can_be_executable (const char *type)
......@@ -703,6 +668,20 @@ looks_like_text (const guchar *data, gsize data_size)
return TRUE;
}
/**
* g_content_type_guess:
* @filename: a string.
* @data: a stream of data.
* @data_size: the size of @data.
* @result_uncertain: a flag indicating the certainty of the
* result.
*
* Guesses the content type based on example data. If the function is
* uncertain, @result_uncertain will be set to %TRUE.
*
* Returns: a string indicating a guessed content type for the
* given data.
**/
char *
g_content_type_guess (const char *filename,
const guchar *data,
......@@ -857,6 +836,14 @@ enumerate_mimetypes_dir (const char *dir, GHashTable *mimetypes)
g_free (mimedir);
}
/**
* g_content_types_get_registered:
*
* Gets a list of strings containing the registered content types on
* the system.
*
* Returns: #GList of the registered content types.
**/
GList *
g_content_types_get_registered (void)
{
......
......@@ -1336,11 +1336,13 @@ g_desktop_app_info_remove_supports_type (GAppInfo *appinfo,
/**
* g_app_info_create_from_commandline:
* @commandline:
* @application_name:
* @flags:
* @error: a #GError location to store the error occuring, or %NULL to
* ignore.
* @commandline: the commandline to use
* @application_name: the application name, or %NULL to use @commandline
* @flags: flags that can specify details of the created #GAppInfo
* @error: a #GError location to store the error occuring, %NULL to ignore.
*
* Creates a new #GAppInfo from the given information.
*
* Returns: new #GAppInfo for given command.
**/
GAppInfo *
......@@ -1484,7 +1486,7 @@ app_info_in_list (GAppInfo *info, GList *l)
/**
* g_app_info_get_all_for_type:
* @content_type:
* @content_type: the content type to find a #GAppInfo for
*
* Gets a list of all #GAppInfo s for a given content type.
*
......@@ -1523,12 +1525,11 @@ g_app_info_get_all_for_type (const char *content_type)
/**
* g_app_info_get_default_for_type:
* @content_type:
* @must_support_uris:
* @content_type: the content type to find a #GAppInfo for
* @must_support_uris: if %TRUE, the #GAppInfo is expected to
* support URIs
*
* Gets the #GAppInfo that correspond to a given content type.
* If @must_support_uris is true, the #GAppInfo is expected to
* support URIs.
*
* Returns: #GAppInfo for given @content_type.
**/
......
......@@ -105,9 +105,10 @@ g_drive_base_init (gpointer g_class)
* g_drive_get_name:
* @drive: a #GDrive.
*
* Returns: string containing @drive's name.
* Gets the name of @drive.
*
* The returned string should be freed when no longer needed.
* Returns: a string containing @drive's name. The returned
* string should be freed when no longer needed.
**/
char *
g_drive_get_name (GDrive *drive)
......
......@@ -354,7 +354,7 @@ g_file_get_uri (GFile *file)
}
/**
* g_file_parse_name:
* g_file_get_parse_name:
* @file: input #GFile.
*
* Gets the parsed name for the #GFile.
......@@ -943,7 +943,7 @@ g_file_find_enclosing_volume (GFile *file,
* g_file_read:
* @file: #GFile to read.
* @cancellable: a #GCancellable
* @error: a #GError.
* @error: a #GError, or %NULL
*
* Reads a whole file into a #GFileInputStream. Fails returning %NULL if
* given #GFile points to a directory.
......@@ -987,6 +987,7 @@ g_file_read (GFile *file,
* @file: input #GFile.
* @flags: a set of #GFileCreateFlags.
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @error: a #GError, or %NULL
*
* If the #GFileIface for @file does not support appending to files, then
* @error will be set to %G_IO_ERROR_NOT_SUPPORTED and %NULL will be returned.
......@@ -1028,7 +1029,7 @@ g_file_append_to (GFile *file,
* @file: input #GFile.
* @flags: a set of #GFileCreateFlags.
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* If the #GFileIface for @file does not support creating files, then
* @error will be set to %G_IO_ERROR_NOT_SUPPORTED and %NULL will be returned.
......@@ -1073,6 +1074,7 @@ g_file_create (GFile *file,
* @make_backup: a #gboolean.
* @flags: a set of #GFileCreateFlags.
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @error: a #GError, or %NULL
*
* If the #GFileIface for @file does not support streaming operations, then
* @error will be set to %G_IO_ERROR_NOT_SUPPORTED and %NULL will be returned.
......@@ -1154,7 +1156,7 @@ g_file_read_async (GFile *file,
* g_file_read_finish:
* @file: input #GFile.
* @res: a #GAsyncResult.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* Finishes an asynchronous file read operation started with
* g_file_read_async().
......@@ -1232,7 +1234,7 @@ g_file_append_to_async (GFile *file,
* g_file_append_to_finish:
* @file: input #GFile.
* @res: #GAsyncResult
* @error: a #GError.
* @error: a #GError, or #NULL
*
* Finishes appending to a file started with g_file_append_to_async().
*
......@@ -1301,7 +1303,7 @@ g_file_create_async (GFile *file,
* g_file_create_finish:
* @file: input #GFile.
* @res: a #GAsyncResult.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* Finishes creating a file started with g_file_create_async().
*
......@@ -1377,7 +1379,7 @@ g_file_replace_async (GFile *file,
* g_file_replace_finish:
* @file: input #GFile.
* @res: a #GAsyncResult.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* Finishes replacing the contents of the file started by
* g_file_replace_async(). This is typically called within
......@@ -1811,7 +1813,7 @@ file_copy_fallback (GFile *source,
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @progress_callback: function to callback with progress information
* @progress_callback_data: userdata to pass to @progress_callback
* @error: #GError to set on error
* @error: #GError to set on error, or %NULL
*
* <!-- Source Friendly Version
* List of possible errors resulting from g_file_copy():
......@@ -1914,7 +1916,7 @@ g_file_copy (GFile *source,
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @progress_callback: GFileProgressCallback function for updates.
* @progress_callback_data: gpointer to user data for the callback function.
* @error: #GError for returning error conditions.
* @error: #GError for returning error conditions, or %NULL
*
* List of possible returns from g_file_move() with given source,
* destination, and flags:
......@@ -2012,7 +2014,7 @@ g_file_move (GFile *source,
* g_file_make_directory
* @file: input #GFile.
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* If @cancellable is not %NULL, then the operation can be cancelled by
* triggering the cancellable object from another thread. If the operation
......@@ -2097,7 +2099,7 @@ g_file_make_symbolic_link (GFile *file,
* g_file_delete:
* @file: input #GFile.
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* Deletes a file.
*
......@@ -2136,7 +2138,7 @@ g_file_delete (GFile *file,
* g_file_trash:
* @file: #GFile to send to trash.
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* Sends @file to the virtual file system "Trash" location. If the
* virtual file system does not have support having a "Trash" location,
......@@ -2178,7 +2180,7 @@ g_file_trash (GFile *file,
* @file: input #GFile.
* @display_name: a string.
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* Sets the display name for @file. If the display name contains invalid
* characters, @error will be set to %G_IO_ERROR_INVALID_ARGUMENT. For the
......@@ -2262,7 +2264,7 @@ g_file_set_display_name_async (GFile *file,
* g_file_set_display_name_finish:
* @file: input #GFile.
* @res: a #GAsyncResult.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* Finishes setting a display name started with g_file_set_display_name_async().
*
......@@ -2293,7 +2295,7 @@ g_file_set_display_name_finish (GFile *file,
* g_file_query_settable_attributes:
* @file: input #GFile.
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* If @cancellable is not %NULL, then the operation can be cancelled by
* triggering the cancellable object from another thread. If the operation
......@@ -2344,7 +2346,7 @@ g_file_query_settable_attributes (GFile *file,
* g_file_query_writable_namespaces:
* @file: input #GFile.
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* If @cancellable is not %NULL, then the operation can be cancelled by
* triggering the cancellable object from another thread. If the operation
......@@ -2397,7 +2399,7 @@ g_file_query_writable_namespaces (GFile *file,
* @value: a set of #GFileAttributeValue.
* @flags: a set of #GFileQueryInfoFlags.
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* Sets an attribute in the file with attribute name @attribute to @value.
* If setting attributes is not suppored by the #GFileIface for @file,
......@@ -2444,7 +2446,7 @@ g_file_set_attribute (GFile *file,
* @info: a #GFileInfo.
* @flags: #GFileQueryInfoFlags
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* Tries to set all attributes in the #GFileInfo on the target values, not stopping
* on the first error.
......@@ -2561,7 +2563,7 @@ g_file_set_attributes_async (GFile *file,
* @file: input #GFile.
* @result: a #GAsyncResult.
* @info: a #GFileInfo.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* Finishes setting an attribute started in g_file_set_attributes_async().
*
......@@ -2592,7 +2594,7 @@ g_file_set_attributes_finish (GFile *file,
* @value: a string containing the attribute's value.
* @flags: #GFileQueryInfoFlags.
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_STRING to @value. If
* @attribute is of a different type, this operation will fail.
......@@ -2625,7 +2627,7 @@ g_file_set_attribute_string (GFile *file,
* @value: a string containing the attribute's new value.
* @flags: a #GFileQueryInfoFlags.
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING to @value. If
* @attribute is of a different type, this operation will fail, returning %FALSE.
......@@ -2659,7 +2661,7 @@ g_file_set_attribute_byte_string (GFile *file,
* @value: a #guint32 containing the attribute's new value.
* @flags: a #GFileQueryInfoFlags.
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_UINT32 to @value. If
* @attribute is of a different type, this operation will fail.
......@@ -2693,7 +2695,7 @@ g_file_set_attribute_uint32 (GFile *file,
* @value: a #gint32 containing the attribute's new value.
* @flags: a #GFileQueryInfoFlags.
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_INT32 to @value. If
* @attribute is of a different type, this operation will fail.
......@@ -2727,7 +2729,7 @@ g_file_set_attribute_int32 (GFile *file,
* @value: a #guint64 containing the attribute's new value.
* @flags: a #GFileQueryInfoFlags.
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_UINT64 to @value. If
* @attribute is of a different type, this operation will fail.
......@@ -2761,7 +2763,7 @@ g_file_set_attribute_uint64 (GFile *file,
* @value: a #guint64 containing the attribute's new value.
* @flags: a #GFileQueryInfoFlags.
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_INT64 to @value. If
* @attribute is of a different type, this operation will fail.
......@@ -2838,7 +2840,7 @@ g_file_mount_mountable (GFile *file,
* g_file_mount_mountable_finish:
* @file: input #GFile.
* @result: a #GAsyncResult.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* Returns: a #GFile or %NULL on error.
**/
......@@ -2907,7 +2909,7 @@ g_file_unmount_mountable (GFile *file,
* g_file_unmount_mountable_finish:
* @file: input #GFile.
* @result: a #GAsyncResult.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* Returns: %TRUE if the operation finished successfully. %FALSE
* otherwise.
......@@ -2982,7 +2984,7 @@ g_file_eject_mountable (GFile *file,
* g_file_eject_mountable_finish:
* @file: input #GFile.
* @result: a #GAsyncResult.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* Finishes an asynchronous eject operation started by
* g_file_eject_mountable().
......@@ -3828,7 +3830,7 @@ g_mount_for_location (GFile *location,
* g_mount_for_location_finish:
* @location: input #GFile.
* @result: a #GAsyncResult.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* Finishes a mount operation started by g_mount_for_location().
*
......@@ -3871,7 +3873,7 @@ g_mount_for_location_finish (GFile *location,
* @contents: a location to place the contents of the file.
* @length: a location to place the length of the contents of the file.
* @etag_out: a location to place the current entity tag for the file.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* If @cancellable is not %NULL, then the operation can be cancelled by
* triggering the cancellable object from another thread. If the operation
......@@ -4168,7 +4170,7 @@ g_file_load_partial_contents_async (GFile *file,
* @contents: a location to place the contents of the file.
* @length: a location to place the length of the contents of the file.
* @etag_out: a location to place the current entity tag for the file.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* Returns: %TRUE if the load was successful. If %FALSE and @error is
* present, it will be set appropriately.
......@@ -4264,7 +4266,7 @@ g_file_load_contents_async (GFile *file,
* @contents: a location to place the contents of the file.
* @length: a location to place the length of the contents of the file.
* @etag_out: a location to place the current entity tag for the file.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* Finishes an asynchronous load of the @file's contents. The contents
* are placed in @contents, and @length is set to the size of the @contents
......@@ -4301,7 +4303,7 @@ g_file_load_contents_finish (GFile *file,
* @flags: a set of #GFileCreateFlags.
* @new_etag: a location to a new entity tag for the document.
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* Replaces the contents of @file with @contents of @length bytes. The old
* @etag will be replaced with the @new_etag. If @make_backup is %TRUE,
......@@ -4333,12 +4335,7 @@ g_file_replace_contents (GFile *file,
g_return_val_if_fail (G_IS_FILE (file), FALSE);
g_return_val_if_fail (contents != NULL, FALSE);
out = g_file_replace (file,
etag,
make_backup,
flags,
cancellable,
error);
out = g_file_replace (file, etag, make_backup, flags, cancellable, error);
if (out == NULL)
return FALSE;
......@@ -4568,7 +4565,7 @@ g_file_replace_contents_async (GFile *file,
* @file: input #GFile.
* @res: a #GAsyncResult.
* @new_etag: a location of a new entity tag for the document.
* @error: a #GError.
* @error: a #GError, or %NULL
*
* Finishes an asynchronous replace of the given @file. Sets
* @new_etag to the new entity tag for the document, if present.
......
......@@ -846,6 +846,8 @@ g_file_attribute_info_list_bsearch (GFileAttributeInfoList *list,
* @list: a #GFileAttributeInfoList.
* @name: the name of the attribute to lookup.
*
* Gets the file attribute with the name @name from @list.
*
* Returns: a #GFileAttributeInfo for the @name, or %NULL if an
* attribute isn't found.
**/
......@@ -875,7 +877,6 @@ g_file_attribute_info_list_lookup (GFileAttributeInfoList *list,
*
* Adds a new attribute with @name to the @list, setting
* its @type and @flags.
*
**/
void
g_file_attribute_info_list_add (GFileAttributeInfoList *list,
......
......@@ -590,7 +590,7 @@ typedef enum {
**/
#define G_FILE_ATTRIBUTE_THUMBNAIL_PATH "thumbnail:path" /* bytestring */
/**
* G_FILE_ATTRIBUTE_THUMBNAIL_THUMNAILING_FAILED:
* G_FILE_ATTRIBUTE_THUMBNAILING_FAILED:
*
* A key in the "thumbnail" namespace for checking if thumbnailing failed.
* This attribute is %TRUE if thumbnailing failed. Corresponding
......
......@@ -145,8 +145,10 @@ g_file_monitor_init (GFileMonitor *monitor)
/**
* g_file_monitor_is_cancelled:
* @monitor:
* @monitor: a #GFileMonitor
*
* Returns whether the monitor is canceled.
*
* Returns: %TRUE if monitor is canceled. %FALSE otherwise.
**/
gboolean
......
......@@ -403,9 +403,12 @@ init_completion (GFilenameCompleter *completer,
* g_filename_completer_get_completion_suffix:
* @completer: the filename completer.
* @initial_text: text to be completed.
*
* Returns: a completed string. This string is not owned by GIO, so
* remember to g_free() it when finished.
*
* Obtains a completion for @initial_text from @completer.
*
* Returns: a completed string, or %NULL if no completion exists.
* This string is not owned by GIO, so remember to g_free() it
* when finished.
**/
char *
g_filename_completer_get_completion_suffix (GFilenameCompleter *completer,
......
......@@ -196,6 +196,8 @@ g_filter_input_stream_init (GFilterInputStream *stream)
* g_filter_input_stream_get_base_stream:
* @stream: a #GFilterInputStream.
*
* Gets the base stream for the filter stream.
*
* Returns: a #GInputStream.
**/
GInputStream *
......
......@@ -195,6 +195,14 @@ g_filter_output_stream_init (GFilterOutputStream *stream)
{
}
/**
* g_filter_output_stream_get_base_stream:
* @stream: a #GFilterOutputStream.
*
* Gets the base stream for the filter stream.
*
* Returns: a #GOutputStream.
**/
GOutputStream *
g_filter_output_stream_get_base_stream (GFilterOutputStream *stream)
{
......
......@@ -968,11 +968,12 @@ g_output_stream_flush_finish (GOutputStream *stream,
/**
* g_output_stream_close_async:
* @stream: A #GOutputStream.
* @io_priority: the io priority of the request.
* @callback: callback to call when the request is satisfied
* @user_data: the data to pass to callback function
* @cancellable: optional cancellable object
*
* Requests an asynchronous closes of the stream, releasing resources related to it.
* Requests an asynchronous close of the stream, releasing resources related to it.
* When the operation is finished @callback will be called, giving the results.
*
* For behaviour details see g_output_stream_close().
......
......@@ -53,37 +53,46 @@
* by the operation; all of the simple return cases are covered.
*
* Most of the time, an application will not need to know of the details
* of this API; it is handled transparently, and any necessary operations are handled by