doc: improve single line descriptions

Summary: this patch improves single line descriptions described on T7717

Reviewers: woohyun, Hermet, myoungwoon, cedric

Reviewed By: cedric

Subscribers: cedric, #reviewers, #committers

Tags: #efl

Differential Revision: https://phab.enlightenment.org/D9795
This commit is contained in:
Myoungwoon Roy, Kim 2019-09-13 14:04:46 +02:00 committed by Xavi Artigas
parent 5f263e003e
commit c6dd9d2a64
2 changed files with 16 additions and 12 deletions

View File

@ -1,25 +1,29 @@
class @beta Efl.Boolean_Model extends Efl.Composite_Model
{
[[Efl boolean model class]]
[[@Efl.Model that efficiently stores boolean properties (they can only be $true or $false).
Internally the values are stored in a compact bit buffer, taking up minimum memory.
An example usage is @Efl.Ui.Select_Model.
]]
methods {
boolean_add {
[[Add a new named boolean property with a defined default value.]]
[[Adds a new named boolean property with a default value.]]
params {
@in name: string;
@in default_value: bool;
@in name: string; [[The name of the new boolean property.]]
@in default_value: bool; [[Default value for new boolean property.]]
}
}
boolean_del {
[[Delete an existing named boolean property]]
[[Deletes an existing named boolean property.]]
params {
@in name: string;
@in name: string; [[Name of the property to be deleted.]]
}
}
boolean_iterator_get {
[[Get an iterator that will quickly find all the index with the requested value for a specific boolean.]]
[[Gets an iterator that will quickly find all the indices with the requested value for a specific property.]]
params {
@in name: string;
@in request: bool;
@in name: string; [[The name of the property to examine.]]
@in request: bool; [[The value to look for.]]
}
return: iterator<ptr(uint64)>; [[The iterator that is valid until any change is made on the model.]]
}

View File

@ -3,19 +3,19 @@ class @beta Efl.Ui.Select_Model extends Efl.Boolean_Model
[[Efl ui select model class]]
methods {
selected_get {
[[Get an iterator of all the selected child of this model.
[[Gets an iterator of all the selected child of this model.
]]
return: iterator<uint64>; [[The iterator gives indices of selected children.
It is valid until any change is made on the model.]]
}
unselected_get {
[[Get an iterator of all the child of this model that are not selected.
[[Gets an iterator of all the child of this model that are not selected.
]]
return: iterator<uint64>; [[The iterator gives indices of unselected children.
It is valid until any change is made on the model.]]
}
@property single_selection {
[[Define if we support only one exclusive selection at a time when set to $true.
[[Defines if we support only one exclusive selection at a time when set to $true.
If disable with $false, it will have the behavior of a multi select mode.
]]