user-controls: Add some missing documentation comments

The annotations in these fix some GIR warnings.

Signed-off-by: Philip Withnall <withnall@endlessm.com>
This commit is contained in:
Philip Withnall 2020-02-06 12:07:58 +00:00
parent 7dfd03907d
commit e4fbb570af
1 changed files with 44 additions and 2 deletions

View File

@ -772,6 +772,16 @@ mct_user_controls_init (MctUserControls *self)
G_BINDING_DEFAULT); G_BINDING_DEFAULT);
} }
/**
* mct_user_controls_get_user:
* @self: an #MctUserControls
*
* Get the value of #MctUserControls:user.
*
* Returns: (transfer none) (nullable): the user the controls are configured for,
* or %NULL if unknown
* Since: 0.5.0
*/
ActUser * ActUser *
mct_user_controls_get_user (MctUserControls *self) mct_user_controls_get_user (MctUserControls *self)
{ {
@ -780,6 +790,16 @@ mct_user_controls_get_user (MctUserControls *self)
return self->user; return self->user;
} }
/**
* mct_user_controls_set_user:
* @self: an #MctUserControls
* @user: (nullable) (transfer none): the user to configure the controls for,
* or %NULL if unknown
*
* Set the value of #MctUserControls:user.
*
* Since: 0.5.0
*/
void void
mct_user_controls_set_user (MctUserControls *self, mct_user_controls_set_user (MctUserControls *self,
ActUser *user) ActUser *user)
@ -811,7 +831,18 @@ on_permission_allowed_cb (GObject *obj,
setup_parental_control_settings (self); setup_parental_control_settings (self);
} }
GPermission * /* (nullable) */ /**
* mct_user_controls_get_permission:
* @self: an #MctUserControls
*
* Get the value of #MctUserControls:permission.
*
* Returns: (transfer none) (nullable): a #GPermission indicating whether the
* current user has permission to view or change parental controls, or %NULL
* if permission is not allowed or is unknown
* Since: 0.5.0
*/
GPermission *
mct_user_controls_get_permission (MctUserControls *self) mct_user_controls_get_permission (MctUserControls *self)
{ {
g_return_val_if_fail (MCT_IS_USER_CONTROLS (self), NULL); g_return_val_if_fail (MCT_IS_USER_CONTROLS (self), NULL);
@ -819,9 +850,20 @@ mct_user_controls_get_permission (MctUserControls *self)
return self->permission; return self->permission;
} }
/**
* mct_user_controls_set_permission:
* @self: an #MctUserControls
* @permission: (nullable) (transfer none): the #GPermission indicating whether
* the current user has permission to view or change parental controls, or
* %NULL if permission is not allowed or is unknown
*
* Set the value of #MctUserControls:permission.
*
* Since: 0.5.0
*/
void void
mct_user_controls_set_permission (MctUserControls *self, mct_user_controls_set_permission (MctUserControls *self,
GPermission *permission /* (nullable) */) GPermission *permission)
{ {
g_return_if_fail (MCT_IS_USER_CONTROLS (self)); g_return_if_fail (MCT_IS_USER_CONTROLS (self));
g_return_if_fail (permission == NULL || G_IS_PERMISSION (permission)); g_return_if_fail (permission == NULL || G_IS_PERMISSION (permission));