mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2024-11-10 03:16:17 +01:00
Documentation updates
svn path=/trunk/; revision=6336
This commit is contained in:
Matthias Clasen
parent
88266aae90
commit
d16037e0e7
@ -1,3 +1,7 @@
|
||||
2008-01-20 Matthias Clasen <mclasen@redhat.com>
|
||||
|
||||
* gio/gio-sections.txt: Additions
|
||||
|
||||
2008-01-14 Matthias Clasen <mclasen@redhat.com>
|
||||
|
||||
* === Released 2.15.2 ===
|
||||
|
||||
@ -67,8 +67,11 @@ g_file_replace_finish
|
||||
g_file_query_info
|
||||
g_file_query_info_async
|
||||
g_file_query_info_finish
|
||||
g_file_query_exists
|
||||
g_file_query_filesystem_info
|
||||
g_file_find_enclosing_mount
|
||||
g_file_find_enclosing_mount_async
|
||||
g_file_find_enclosing_mount_finish
|
||||
g_file_enumerate_children
|
||||
g_file_enumerate_children_async
|
||||
g_file_enumerate_children_finish
|
||||
@ -349,6 +352,7 @@ g_icon_get_type
|
||||
GThemedIcon
|
||||
g_themed_icon_new
|
||||
g_themed_icon_new_from_names
|
||||
g_themed_icon_new_with_default_fallbacks
|
||||
<SUBSECTION Standard>
|
||||
GThemedIconClass
|
||||
G_THEMED_ICON
|
||||
@ -672,6 +676,7 @@ GBufferedOutputStreamPrivate
|
||||
<SECTION>
|
||||
<FILE>gmemoryoutputstream</FILE>
|
||||
<TITLE>GMemoryOutputStream</TITLE>
|
||||
GReallocFunc
|
||||
GMemoryOutputStream
|
||||
g_memory_output_stream_new
|
||||
g_memory_output_stream_get_data
|
||||
@ -1030,6 +1035,7 @@ GAppLaunchContextPrivate
|
||||
GAskPasswordFlags
|
||||
GPasswordSave
|
||||
GMountOperation
|
||||
GMountOperationResult
|
||||
g_mount_operation_new
|
||||
g_mount_operation_get_username
|
||||
g_mount_operation_set_username
|
||||
@ -1094,6 +1100,7 @@ g_unix_mount_is_system_internal
|
||||
g_unix_mount_guess_icon
|
||||
g_unix_mount_guess_name
|
||||
g_unix_mount_guess_can_eject
|
||||
g_unix_mount_guess_should_display
|
||||
g_unix_mount_point_free
|
||||
g_unix_mount_point_compare
|
||||
g_unix_mount_point_get_mount_path
|
||||
|
||||
@ -1,3 +1,12 @@
|
||||
2008-01-20 Matthias Clasen <mclasen@redhat.com>
|
||||
|
||||
* gfile.c:
|
||||
* gfilemonitor.[hc]:
|
||||
* gmemoryinputstream.c:
|
||||
* gmemoryoutputstream.c:
|
||||
* gmountoperation.c:
|
||||
* gthemedicon.c: Documentation updates
|
||||
|
||||
2008-01-20 Murray Cumming <murrayc@murrayc.com>
|
||||
|
||||
* gfile.c: documentation: Fixed more minor
|
||||
|
||||
35
gio/gfile.c
35
gio/gfile.c
@ -1108,7 +1108,23 @@ g_file_find_enclosing_mount (GFile *file,
|
||||
|
||||
return (* iface->find_enclosing_mount) (file, cancellable, error);
|
||||
}
|
||||
|
||||
/**
|
||||
* g_file_find_enclosing_mount_async:
|
||||
* @file: a #GFile
|
||||
* @io_priority: the <link linkend="io-priority">I/O priority</link>
|
||||
* of the request.
|
||||
* @cancellable: optional #GCancellable object, %NULL to ignore.
|
||||
* @callback: a #GAsyncReadyCallback to call when the request is satisfied
|
||||
* @user_data: the data to pass to callback function
|
||||
*
|
||||
* Asynchronously gets the mount for the file.
|
||||
*
|
||||
* For more details, see g_file_find_enclosing_mount() which is
|
||||
* the synchronous version of this call.
|
||||
*
|
||||
* When the operation is finished, @callback will be called. You can then call
|
||||
* g_file_find_enclosing_mount_finish() to get the result of the operation.
|
||||
*/
|
||||
void
|
||||
g_file_find_enclosing_mount_async (GFile *file,
|
||||
int io_priority,
|
||||
@ -1128,10 +1144,21 @@ g_file_find_enclosing_mount_async (GFile *file,
|
||||
user_data);
|
||||
}
|
||||
|
||||
/**
|
||||
* g_file_find_enclosing_mount_finish:
|
||||
* @file: a #GFile
|
||||
* @res: a #GAsyncResult
|
||||
* @error: a #GError
|
||||
*
|
||||
* Finishes an asynchronous find mount request.
|
||||
* See g_file_find_enclosing_mount_async().
|
||||
*
|
||||
* Returns: #GMount for given @file or %NULL on error.
|
||||
**/
|
||||
GMount *
|
||||
g_file_find_enclosing_mount_finish (GFile *file,
|
||||
GAsyncResult *res,
|
||||
GError **error)
|
||||
g_file_find_enclosing_mount_finish (GFile *file,
|
||||
GAsyncResult *res,
|
||||
GError **error)
|
||||
{
|
||||
GFileIface *iface;
|
||||
|
||||
|
||||
@ -519,10 +519,10 @@ update_rate_limiter_timeout (GFileMonitor *monitor,
|
||||
* implementations only.
|
||||
**/
|
||||
void
|
||||
g_file_monitor_emit_event (GFileMonitor *monitor,
|
||||
GFile *child,
|
||||
GFile *other_file,
|
||||
GFileMonitorEvent event_type)
|
||||
g_file_monitor_emit_event (GFileMonitor *monitor,
|
||||
GFile *child,
|
||||
GFile *other_file,
|
||||
GFileMonitorEvent event_type)
|
||||
{
|
||||
guint32 time_now, since_last;
|
||||
gboolean emit_now;
|
||||
|
||||
@ -109,7 +109,7 @@ void g_file_monitor_set_rate_limit (GFileMonitor *monitor,
|
||||
|
||||
/* For implementations */
|
||||
void g_file_monitor_emit_event (GFileMonitor *monitor,
|
||||
GFile *file,
|
||||
GFile *child,
|
||||
GFile *other_file,
|
||||
GFileMonitorEvent event_type);
|
||||
|
||||
|
||||
@ -185,6 +185,13 @@ g_memory_input_stream_init (GMemoryInputStream *stream)
|
||||
GMemoryInputStreamPrivate);
|
||||
}
|
||||
|
||||
/**
|
||||
* g_memory_input_stream_new:
|
||||
*
|
||||
* Creates a new empty #GMemoryInputStream.
|
||||
*
|
||||
* Returns: a new #GInputStream
|
||||
*/
|
||||
GInputStream *
|
||||
g_memory_input_stream_new (void)
|
||||
{
|
||||
@ -220,6 +227,15 @@ g_memory_input_stream_new_from_data (const void *data,
|
||||
return stream;
|
||||
}
|
||||
|
||||
/**
|
||||
* g_memory_input_stream_add_data:
|
||||
* @stream: a #GMemoryInputStream
|
||||
* @data: input data
|
||||
* @len: length of the data, may be -1 if @data is a nul-terminated string
|
||||
* @destroy: function that is called to free @data, or %NULL
|
||||
*
|
||||
* Appends @data to data that can be read from the input stream
|
||||
*/
|
||||
void
|
||||
g_memory_input_stream_add_data (GMemoryInputStream *stream,
|
||||
const void *data,
|
||||
|
||||
@ -69,6 +69,18 @@ struct _GMemoryOutputStreamClass
|
||||
void (*_g_reserved5) (void);
|
||||
};
|
||||
|
||||
/**
|
||||
* GReallocFunc:
|
||||
* @data: memory block to reallocate
|
||||
* @size: size to reallocate @data to
|
||||
*
|
||||
* Changes the size of the memory block pointed to by @data to
|
||||
* @size bytes.
|
||||
*
|
||||
* The function should have the same semantics as realloc().
|
||||
*
|
||||
* Returns: a pointer to the reallocated memory
|
||||
*/
|
||||
typedef gpointer (*GReallocFunc) (gpointer data, gsize size);
|
||||
|
||||
GType g_memory_output_stream_get_type (void) G_GNUC_CONST;
|
||||
|
||||
@ -620,8 +620,8 @@ g_mount_operation_set_choice (GMountOperation *op,
|
||||
|
||||
/**
|
||||
* g_mount_operation_reply:
|
||||
* @op: a #GMountOperation.
|
||||
* @abort: boolean.
|
||||
* @op: a #GMountOperation
|
||||
* @result: a #GMountOperationResult
|
||||
*
|
||||
* Emits the #GMountOperation::reply signal.
|
||||
**/
|
||||
|
||||
@ -143,6 +143,28 @@ g_themed_icon_new_from_names (char **iconnames,
|
||||
return G_ICON (themed);
|
||||
}
|
||||
|
||||
/**
|
||||
* g_themed_icon_new_with_default_fallbacks:
|
||||
* @iconname: a string containing an icon name
|
||||
*
|
||||
* Creates a new themed icon for @iconname, and all the names
|
||||
* that can be created by shortening @iconname at '-' characters.
|
||||
*
|
||||
* In the following example, @icon1 and @icon2 are equivalent:
|
||||
* |[
|
||||
* const char *names[] = {
|
||||
* "gnome-dev-cdrom-audio",
|
||||
* "gnome-dev-cdrom",
|
||||
* "gnome-dev",
|
||||
* "gnome"
|
||||
* };
|
||||
*
|
||||
* icon1 = g_themed_icon_new_from_names (names, 4);
|
||||
* icon2 = g_themed_icon_new_with_default_fallbacks ("gnome-dev-cdrom-audio");
|
||||
* ]|
|
||||
*
|
||||
* Returns: a new #GThemedIcon.
|
||||
*/
|
||||
GIcon *
|
||||
g_themed_icon_new_with_default_fallbacks (const char *iconname)
|
||||
{
|
||||
|
||||
Loading…
Reference in New Issue
Block a user