luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-08-21 08:28:53 +02:00
Code Issues Packages Projects Releases Wiki Activity

Clarify docs

Browse Source 
svn path=/trunk/; revision=7923
This commit is contained in:
Matthias Clasen
2009-02-27 21:02:19 +00:00
parent 24440f7c86
commit 474db07f6a
2 changed files with 22 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
gio/ChangeLog
View File

@@ -1,3 +1,10 @@
2009-02-27 Matthias Clasen <mclasen@redhat.com>
Bug 573421 – Clarify message format in GMountOperation
* gmountoperation.c: Document that the first line of a
multi-line message should be interpreted as a heading.
2009-02-27 David Zeuthen <davidz@redhat.com> 2009-02-27 David Zeuthen <davidz@redhat.com>
Bug 573462 – GEmblemedIcon leak Bug 573462 – GEmblemedIcon leak

22
gio/gmountoperation.c
View File

@@ -248,8 +248,12 @@ g_mount_operation_class_init (GMountOperationClass *klass)
* @default_user: string containing the default user name. * @default_user: string containing the default user name.
* @default_domain: string containing the default domain. * @default_domain: string containing the default domain.
* @flags: a set of #GAskPasswordFlags. * @flags: a set of #GAskPasswordFlags.
* *
* Emitted when a mount operation asks the user for a password. * Emitted when a mount operation asks the user for a password.
*
* If the message contains a line break, the first line should be
* presented as a heading. For example, it may be used as the
* primary text in a #GtkMessageDialog.
*/ */
signals[ASK_PASSWORD] = signals[ASK_PASSWORD] =
g_signal_new (I_("ask-password"), g_signal_new (I_("ask-password"),
@@ -266,9 +270,13 @@ g_mount_operation_class_init (GMountOperationClass *klass)
* @op: a #GMountOperation asking a question. * @op: a #GMountOperation asking a question.
* @message: string containing a message to display to the user. * @message: string containing a message to display to the user.
* @choices: an array of strings for each possible choice. * @choices: an array of strings for each possible choice.
* *
* Emitted when asking the user a question and gives a list of * Emitted when asking the user a question and gives a list of
* choices for the user to choose from. * choices for the user to choose from.
*
* If the message contains a line break, the first line should be
* presented as a heading. For example, it may be used as the
* primary text in a #GtkMessageDialog.
*/ */
signals[ASK_QUESTION] = signals[ASK_QUESTION] =
g_signal_new (I_("ask-question"), g_signal_new (I_("ask-question"),
@@ -284,7 +292,7 @@ g_mount_operation_class_init (GMountOperationClass *klass)
* GMountOperation::reply: * GMountOperation::reply:
* @op: a #GMountOperation. * @op: a #GMountOperation.
* @result: a #GMountOperationResult indicating how the request was handled * @result: a #GMountOperationResult indicating how the request was handled
* *
* Emitted when the user has replied to the mount operation. * Emitted when the user has replied to the mount operation.
*/ */
signals[REPLY] = signals[REPLY] =
@@ -301,14 +309,14 @@ g_mount_operation_class_init (GMountOperationClass *klass)
* GMountOperation::aborted: * GMountOperation::aborted:
* *
* Emitted by the backend when e.g. a device becomes unavailable * Emitted by the backend when e.g. a device becomes unavailable
* while a mount operation is in progress. * while a mount operation is in progress.
* *
* Implementations of GMountOperation should handle this signal * Implementations of GMountOperation should handle this signal
* by dismissing open password dialogs. * by dismissing open password dialogs.
* *
* Since: 2.20 * Since: 2.20
*/ */
signals[ABORTED] = signals[ABORTED] =
g_signal_new (I_("aborted"), g_signal_new (I_("aborted"),
G_TYPE_FROM_CLASS (object_class), G_TYPE_FROM_CLASS (object_class),
G_SIGNAL_RUN_LAST, G_SIGNAL_RUN_LAST,