From 2465c18e5354f39e4ff8cdaa6616149c8e100ace Mon Sep 17 00:00:00 2001 From: Rico Tzschichholz Date: Wed, 11 Sep 2013 16:30:14 +0200 Subject: Update annotations from glib git --- gir/gio-2.0.c | 74 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ gir/glib-2.0.c | 2 +- 2 files changed, 75 insertions(+), 1 deletion(-) diff --git a/gir/gio-2.0.c b/gir/gio-2.0.c index 036ddb7f..49d519ee 100644 --- a/gir/gio-2.0.c +++ b/gir/gio-2.0.c @@ -20679,6 +20679,80 @@ */ +/** + * g_file_measure_disk_usage: + * @file: a #GFile + * @flags: #GFileMeasureFlags + * @cancellable: (allow-none): optional #GCancellable + * @progress_callback: (allow-none): a #GFileMeasureProgressCallback + * @progress_data: user_data for @progress_callback + * @disk_usage: (allow-none) (out): the number of bytes of disk space used + * @num_dirs: (allow-none) (out): the number of directories encountered + * @num_files: (allow-none) (out): the number of non-directories encountered + * @error: (allow-none): %NULL, or a pointer to a %NULL #GError pointer + * + * Recursively measures the disk usage of @file. + * + * This is essentially an analog of the 'du' command, + * but it also reports the number of directories and non-directory files + * encountered (including things like symbolic links). + * + * By default, errors are only reported against the toplevel file + * itself. Errors found while recursing are silently ignored, unless + * %G_FILE_DISK_USAGE_REPORT_ALL_ERRORS is given in @flags. + * + * The returned size, @disk_usage, is in bytes and should be formatted + * with g_format_size() in order to get something reasonable for showing + * in a user interface. + * + * @progress_callback and @progress_data can be given to request + * periodic progress updates while scanning. See the documentation for + * #GFileMeasureProgressCallback for information about when and how the + * callback will be invoked. + * + * Returns: %TRUE if successful, with the out parameters set. %FALSE otherwise, with @error set. + * Since: 2.38 + */ + + +/** + * g_file_measure_disk_usage_async: + * @file: a #GFile + * @flags: #GFileMeasureFlags + * @io_priority: the I/O priority of the request + * @cancellable: (allow-none): optional #GCancellable + * @progress_callback: (allow-none): a #GFileMeasureProgressCallback + * @progress_data: user_data for @progress_callback + * @callback: (allow-none): a #GAsyncReadyCallback to call when complete + * @user_data: the data to pass to callback function + * + * Recursively measures the disk usage of @file. + * + * This is the asynchronous version of g_file_measure_disk_usage(). See + * there for more information. + * + * Since: 2.38 + */ + + +/** + * g_file_measure_disk_usage_finish: + * @file: a #GFile + * @result: the #GAsyncResult passed to your #GAsyncReadyCallback + * @disk_usage: (allow-none) (out): the number of bytes of disk space used + * @num_dirs: (allow-none) (out): the number of directories encountered + * @num_files: (allow-none) (out): the number of non-directories encountered + * @error: (allow-none): %NULL, or a pointer to a %NULL #GError pointer + * + * Collects the results from an earlier call to + * g_file_measure_disk_usage_async(). See g_file_measure_disk_usage() for + * more information. + * + * Returns: %TRUE if successful, with the out parameters set. %FALSE otherwise, with @error set. + * Since: 2.38 + */ + + /** * g_file_monitor: * @file: input #GFile diff --git a/gir/glib-2.0.c b/gir/glib-2.0.c index b69ff335..37ec6c7d 100644 --- a/gir/glib-2.0.c +++ b/gir/glib-2.0.c @@ -26662,7 +26662,7 @@ * Compares two strings for equality, returning %TRUE if they are equal. * For use with #GHashTable. * - * Returns: %TRUE if they strings are the same length and contain the same bytes + * Returns: %TRUE if the strings are the same length and contain the same bytes */ -- cgit v1.2.1