elput: Fix @brief's in docs

Summary:
It is not necessary to specify @brief since the first line will
automatically be used, but if it is used it should be only for the brief
description, not the detailed description.

Also reformat other docs in this file to follow convention for the brief
docs.

Reviewers: cedric

Subscribers: jpeg

Differential Revision: https://phab.enlightenment.org/D5101

Elm Examples: Fix undefined function references.

They were renamed by 599bb616ec5

Signed-off-by: Jean-Philippe Andre <jp.andre@samsung.com>

evas: Fix auto-show of EO objects

Objects show should happen as early as possible during the render cycle,
as it affects smart objects calculation and everything else.

Thanks @JackDanielZ for the report!

Fixes T5880

ui.box: add aspect ratio support

Adding support for aspect ratio.

ref T5487

ui.box: Add handling for weight + align

Issue: If the item has weight and non-filled align, item is not resized.
This patch fixes this issue.
Test: elementary_test -> ui.box -> Equal weight. Buttons Btn1, BtnA, B, C
do not resize when resize the window.

ref T5487

evas: Fix crash with filters

Since the EO APIs are defined as weak symbols, invalid definitions of
EAPI lead to runtime crashes on non-public APIs. This is a fix following
a series of changes wrt. EAPI definitions.

value size is stored in type, no need to manually specify them.

ector: fix EAPI on Windows

Signed-off-by: Cedric BAIL <cedric@osg.samsung.com>

eina: remove tests and benchmark for long dead mempool.

eina: add tests for from.

eina: add support for from in pass through

eina: add support for from in one big.

eina: add support for from in chained mempool.

eina: add an API to check if a pointer is a valid element of a mempool.

eio: fix correct stat structure on Windows 32 bits

Signed-off-by: Cedric BAIL <cedric@osg.samsung.com>

build: don't pass -fPIC on Windows

Signed-off-by: Cedric BAIL <cedric@osg.samsung.com>

ecore_evas: win32 module - fix possibly uninitialized variables

Signed-off-by: Cedric BAIL <cedric@osg.samsung.com>

evas: move EAPI undef to the correct place

Signed-off-by: Cedric BAIL <cedric@osg.samsung.com>

evas: undef EAPI properly.

Signed-off-by: Cedric BAIL <cedric@osg.samsung.com>

evas GDI engine: improve speed

expedite mean value goes from ~125 to ~205

Signed-off-by: Cedric BAIL <cedric@osg.samsung.com>

wayland: bump wayland protocol version requirement

We need a newer version for recent dmabuf changes.

efl: add EFL_VERSION_1_21

indicate that features from this version can be used

Efl.ui.panes: move legacy APIs at bottom of file

Revert "evas: we should be able to access this data during an object being destroyed."

This reverts commit 207cab086f290878cd584e6c61b3cd2696c5fd88.

Better make efl_data_scope_safe_get work during EFL_EVENT_DEL.

eo: only return NULL when the object is destructed.

There is a problem with the previous version. The object can still be
alive due to the use of manual_free in evas. So you wouldn't be able
for example to remove a callback from an object that hasn't been
destroyed yet. If that callback is triggered by the destruction
of the object, you would end up with an unexpected and impossible to
prevent effect of access after free on a callback that you had removed.

Not sure if that still solve the original problem that the code was
trying to prevent in Ecore_Evas.

ecore_evas: define the predefine for wl2 instead of wayland

ecore_imf/wayland: Check the return value of memory allocation function

efl-wl: max size of 0x0 from shell is -1x-1 in efl

efl-wl: initialize seat keymap fd to -1

@fix

ecore: always set delete_me before removing fd from poll

ensure bad fds don't immediately get re-added to polling

@fix

efl-wl: handle case where eglBindWaylandDisplay fails

@fix

efl-wl: always dismiss popups on hide

@fix

elm_widget: do not reparent subobjs to top widget for non-elm objects

this breaks handling of non-elm objects and makes it impossible to safely manage
object lifetimes

ref D3957
ref 62cf70034de38b17f2025e08f81b5758b3d6d6e3

@fix

efl-wl: use correct accessor method for keyboard resource hash

@fix

wayland: set min/max size hints to surface before show

with deferred surface creation the first canvas change of hints may not
be able to trigger protocol methods for size hints, so ensure that hints are
set

efl-wl: add functionality for extracting surfaces for external use

@feature

efl-wl: add EFL_WL_DEBUG env variable for enabling wayland debug

@feature

wayland: remove xdg5 support

this has not been used or tested since last year and there are no major
compositors which lack xdg6 support

wayland: fix xdg-shell popup windows

@fix

ecore_evas_drm: Tick from the animator registration callback

If we're not ticking already when a new animator is started then we have
to wait for a vblank to get a tick.  That's not great.

If we can, use the time of the last vblank to generate an immediate tick
to avoid this latency.

ecore_evas_drm: Let ecore_drm2 track pending page flips

Since the engines can call the flip functions, we need to protect the
ticker from missing those flips.  Thus, we let ecore_drm2, which obviously
sees all flips, track them.

ecore_drm2: Add query for pending pageflip

We've been tracking this in ecore_evas, but ecore_evas isn't the only
caller, and it doesn't know about flips initiated by the evas engines.

makefile_evas: fix includes when openjpeg 1.5 and 2.0 are installed.

Reviewers: vtorri

Subscribers: ManMower, cedric, jpeg

Differential Revision: https://phab.enlightenment.org/D5084

evas: we should be able to access this data during an object being destroyed.

So, this is maybe not the best fix. The question is should we be able to
get efl_data_scope_safe_get return the object private data, when we are
currently executing the object EFL_EVENT_DEL callbacks. Right now we don't
and this lead to bug where we wouldn't have been able to destroy a callback
and get that callback triggered later on destroyed data (I had a crash in
terminology). I have switched back to the not _safe_ version which doesn't
enforce this, but that might not be the only place that need a fix.

evas tests - add Jpeg2000 tests

add tests for loading jp2k files correctly and the images

efl_ui_focus_manager_calc: fix the class check of the redirect

this came up with a huge load of errors, i havent noticed them last
night. Sorry.

Efl.Ui.Panes: rename min_split_ratio to split_ratio_min

Efl.Ui.Panes: rename allow_user_size_hints to hint_min_allow

thanks to raster for suggestion.

common3d: correct converting number to float

elm_scroller: focus_direction should not be called when scroller focusable and no focusable child

Summary:
when scroller can have focus and scroller's child can't have focus,
there is a problem that scroller is always selected to next focus object.
In this case, it should not enter into _elm_scroller_elm_widget_focus_direction()

Reviewers: woohyun

Subscribers: cedric, jpeg

Differential Revision: https://phab.enlightenment.org/D5085

Cast to double before division during region/coord calculation.

Summary:
int var devided by int is cast to double after devision.
This might cause wrong calculation result.

Reviewers: cedric, jpeg, Jaehyun_Cho

Reviewed By: Jaehyun_Cho

Differential Revision: https://phab.enlightenment.org/D5079

win: Prevent crash inside ecore evas callbacks

After any complex call on the window, a foreign evas/efl callback may be
triggered that could delete the window object. This leads to crashes in
queued jobs or even immediately after said callback (right now EO
prevents immediate memory free using eina_freeq or eina_trash so the
effects aren't immediate).

Funnily enough, this was a known issue according to some comments, but
no one bothered fixing it...

In this particular instance, a focus_out job was crashing while trying
to access now-invalid sd data.

I believe some uses of ELM_WIN_DATA_GET() may still be slightly unsafe
but most look like they should be the result of an EO call on the object
(eg. a call to efl_event_callback_call), which ensures the object is
alive.

Fixes T5869

eo: Check refs in efl_data_scope_safe_get

This makes sure the object is actually still alive and kicking before
returning any data. Otherwise the "safe" word is a bit of an abuse...

Ref T5869

@fix

Efl.Ui.Panes: don't use edje restrict cal to calculate min size

efl_ui_focus_manager: make focus a property

efl_ui_focus_manager: split this of tinto a class and a interface

it turns out to be very handy to have a interface for the moving and
border elements, that is unconnected to the way of how widgets are
registering themself.

This for example enables us to get a simple focus manager that just
redirects the call into a internal 2 dimensional data struct

eolian-cxx: Add workaround for clang removing const from parameters

efl_wl: Update to latest dmabuf protocol version

Weston's dmabuf code continues to be modular enough that we can pull
it in with little change.

This updates us to version 3 of the protocol.

Currently only contains stubs for format queries.

eolian cxx: fix the remaining type errors

eolian cxx: fix build after eolian type api change

ecore, ecore_con: fix const on Eina.Slice

Fixes TODOs from dd5cdda64b5fd3966718af62d417117942e2f323
after fixing T5024.

eolian: fix tests

eolian: implement proper return type serialization

This accounts for const so that you can't generate functions
that return const values, as that makes no sense.

@fix T5024

elua: update eolian bindings with c type serialization change

eolian: change C type serialization API to account for returns

This will allow proper handling of const.

elm test: rename efl.ui.panes test case

Efl.Ui.Image: use internal func to detect legacy usage

Efl.Ui.Panes: use internal func to detect legacy usage

Ref T5359

Efl.Ui.Panes: set dir to EFL_UI_DIR_VERTICAL

Efl.Ui.Panes: switch to Efl.Ui.Dir (EO)

Ref T5870

Efl.Ui.Panes: rename left/right_size_set to split_ratio

This name makes more sense and one api does the job of two.
We never needed two apis at first place though.
Mark left/right_size_set as legacy apis too.
This patch also implements min_split_ratio on parts.

@feature

refer T5359

Efl.Ui.Panes: implement allow_user_size_hints on parts

This allows user to set size hints to be respected and
request panes to ignore combined min size.
If this flag is set, the minimum size set by efl_gfx_size_hint_min_set()
is respected forcefully.

@feature

refer T5359

Efl.Ui.Panes: allow panes to respect the min size of its content

refer T5359

ctxpopup: Remove use of Orientation API (EO)

ctxpopup belongs to legacy, some work is ongoing to provide a cleaner EO
based API for popups, etc... See T5326

Revert "ctxpopup: implement Efl.Orientation interface functions"

This reverts commit 736fb9d4980a7dee83ca0721d8b9b58c6c12a39d.

Ref T5870

elm_ctxpopup: Implemented elm_widget_item_part_content_unset for elm_ctxpopup_item

Summary:
ctxpopup item have elm_list item internally.
item_part_content_unset need to pass on content part to elm_list item.

Test Plan:
1. launch elementary_test - ctxpopup
2. click Ctxpopup with part text & content function
3. press "Icon Set" and press "Icon Unset"

Reviewers: jpeg, woohyun, herb, Blackmole

Subscribers: cedric, jpeg

Differential Revision: https://phab.enlightenment.org/D5018

elm_ctxpopup: Add APIs to insert before/after item to a ctxpopup object.

Summary:
There were only 2 APIs (item_append, item_prepend) for ctxpopup item add.
Added more item add APIs (item_insert_before and item_insert_after) for convenience.

Test Plan:
1. launch elementary_test - ctxpopup
2. click Ctxpopup with callback function sample
3. check whether there are 3 items on ctxpopup

Reviewers: woohyun, Jaehyun, jpeg, cedric

Reviewed By: jpeg

Subscribers: cedric, jpeg

Differential Revision: https://phab.enlightenment.org/D5004

elm_ctxpopup: Implemented elm_widget_item_del_pre for elm_ctxpopup_item

Summary:
ctxpopup item have elm_list item internally.
But when elm_ctxpopup item was deleted, elm_list item was not deleted.
elm_list item in elm_ctxpopup item should be deleted in del_pre
when elm_ctxpopup item is deleted by elm_wdg_item_del()

Test Plan:
1. launch elementary_test - ctxpopup
2. click Ctxpopup with label only
3. "Never Show" item should not shown in ctxpopup

Reviewers: jpeg, cedric, woohyun

Subscribers: cedric, jpeg

Differential Revision: https://phab.enlightenment.org/D5044

toolbar: Switch to Efl.Ui.Dir (EO)

Ref T5870

separator: Remove orientation API use (EO)

Revert "Separtor: use orientation APIs"

This reverts commit f043c3be617f7257001b9fc779b64cebf4370781.
Separator is not part of EO API so no need to use Orientation or
Direction API here.

Ref T5870

index: Switch to Efl.Ui.Dir (EO)

Ref T5870

slider: Switch to Efl.Ui.Dir (EO)

Ref T5870

progressbar: Switch to Efl.Ui.Dir (EO)

Ref T5870

grid: Switch to Efl.Ui.Dir (EO)

Ref T5870

flip: Switch to Efl.Ui.Dir (EO)

Ref T5870

efl.ui.box: Switch to Efl.Ui.Dir (EO)

This makes the default box vertical, just like in legacy.
The flow box is horizontal by default.

Ref T5870

evas: Modify wheel events direction to bool (EO)

The orientation was overkill here. We only want a bool.

Ref T5870

elm_test: Fix some test cases to use legacy

Legacy test cases should keep using the legacy API, not the EO API.

Ref T5870

efl: Introduce Efl.Ui.Direction interface

This introduces, but doesn't make any use of, two types:
 - EO interface Efl.Ui.Direction
 - Enum Efl.Ui.Dir

This is to clean up inconsistencies with Efl.Orient values when used
with widgets.

Ref T5870

@feature

Efl.Ui.Panes: add first and second as content aliases

'first' and 'second' are more meaningful than
'left'/'right' & 'up'/'down' names.

refer T5359

update po files

evas: Fix crash in E

Somehow starting VirtualBox would crash E when trying to upload invalid
data. I believe checking for NULL data here is all we need to do in
order to keep the image data consistent and valid.

I have to admit I'm not 100% sure what is happening here.

Fixes T5868

@fix

ecore_drm2: Remove ecore_drm2_output_resolution_get()

No local callers.  Superseded by ecore_drm2_output_info_get()

ecore_drm2: Remove ecore_drm2_output_crtc_size_get()

Replaced with ecore_drm2_output_info_get()

ecore_drm2: Remove ecore_drm2_output_geometry_get()

Replaced with ecore_drm2_output_info_get()

ecore_drm2: Add ecore_drm2_output_info_get

We've got too many ways to query output information, so let's add more.
(this will soon replace all of them)

ecore_drm2: Remove useless safety checks

Now that the device is opened and found in one operation it's impossible
to have fd == -1, so we can stop testing for it.

ecore_drm2: Merge ecore_drm2_device_free and _close

There's no reason to have them be separate, all callers must do them
back to back, so let's just combine them.

ecore_drm2: Merge ecore_drm2_device_find and ecore_drm2_device_open

There's never a reason to find a device and not open it, so all callers
end up calling these two functions back to back.

ecore_drm2: Remove connector bitfield

This is unreliable - there's no reason to expect these connector ids
will be low enough to sensibly store in a bit field.

ecore_drm2: remove unused crtc bitfield

We'll need something like this when multi-head works, but it can't
be implemented this way anyway.  There's no guarantee that crtc
ids will be low enough to fit sensibly in a bitfield.