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

gtlspassword.c: indentation fixes and doc clarifications

Browse Source
This commit is contained in:
Dan Winship
2012-01-30 09:00:15 -05:00
parent 46aaad1b2c
commit 18cb864d12
1 changed files with 46 additions and 29 deletions
Download Patch File Download Diff File Expand all files Collapse all files

49
gio/gtlspassword.c
View File

@@ -198,17 +198,29 @@ g_tls_password_class_init (GTlsPasswordClass *klass)
g_type_class_add_private (klass, sizeof (GTlsPasswordPrivate));
g_object_class_install_property (gobject_class, PROP_FLAGS,
g_param_spec_flags ("flags", "Flags", "Flags about the password",
G_TYPE_TLS_PASSWORD_FLAGS, G_TLS_PASSWORD_NONE,
G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
g_param_spec_flags ("flags",
P_("Flags"),
P_("Flags about the password"),
G_TYPE_TLS_PASSWORD_FLAGS,
G_TLS_PASSWORD_NONE,
G_PARAM_READWRITE |
G_PARAM_STATIC_STRINGS));
g_object_class_install_property (gobject_class, PROP_DESCRIPTION,
g_param_spec_string ("description", "Description", "Description of what the password is for",
"", G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
g_param_spec_string ("description",
P_("Description"),
P_("Description of what the password is for"),
"",
G_PARAM_READWRITE |
G_PARAM_STATIC_STRINGS));
g_object_class_install_property (gobject_class, PROP_WARNING,
g_param_spec_string ("warning", "Warning", "Warning about the password",
"", G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
g_param_spec_string ("warning",
P_("Warning"),
P_("Warning about the password"),
"",
G_PARAM_READWRITE |
G_PARAM_STATIC_STRINGS));
}
@@ -236,10 +248,13 @@ g_tls_password_new (GTlsPasswordFlags flags,
* @password: a #GTlsPassword object
* @length: (allow-none): location to place the length of the password.
*
* Get the password value. If @length is not %NULL then it will be filled
* in with the length of the password value.
* Get the password value. If @length is not %NULL then it will be
* filled in with the length of the password value. (Note that the
* password value is not nul-terminated, so you can only pass %NULL
* for @length in contexts where you know the password will have a
* certain fixed length.)
*
* Returns: The password value owned by the password object.
* Returns: The password value (owned by the password object).
*
* Since: 2.30
*/
@@ -260,9 +275,10 @@ g_tls_password_get_value (GTlsPassword *password,
* Set the value for this password. The @value will be copied by the password
* object.
*
* Specify the @length, for a non-null-terminated password. Pass -1 as
* @length if using a null-terminated password, and @length will be calculated
* automatically.
* Specify the @length, for a non-nul-terminated password. Pass -1 as
* @length if using a nul-terminated password, and @length will be
* calculated automatically. (Note that the terminating nul is not
* considered part of the password in this case.)
*
* Since: 2.30
*/
@@ -291,9 +307,10 @@ g_tls_password_set_value (GTlsPassword *password,
* The @value will be owned by the password object, and later freed using
* the @destroy function callback.
*
* Specify the @length, for a non-null-terminated password. Pass -1 as
* @length if using a null-terminated password, and @length will be calculated
* automatically.
* Specify the @length, for a non-nul-terminated password. Pass -1 as
* @length if using a nul-terminated password, and @length will be
* calculated automatically. (Note that the terminating nul is not
* considered part of the password in this case.)
*
* Virtual: set_value
* Since: 2.30