summaryrefslogtreecommitdiff
AgeCommit message (Collapse)AuthorFilesLines
2016-11-21build: Fix scanner path in uninstalled pkg-config fileDerek Foreman1-1/+1
this was generating a pkg-config file that said wayland-scanner was wayland/src/wayland-scanner when it's actually wayland/wayland-scanner Signed-off-by: Derek Foreman <derekf@osg.samsung.com> Acked-by: Bryce Harrington <bryce@osg.samsung.com> Reviewed-by: Daniel Stone <daniels@collabora.com>
2016-11-21util: Improve documentation of wl_iterator_resultYong Bakos1-2/+4
Use declarative voice, remove the unnecessary doxygen \enum tag, and add two see-also's. This keeps the output the same but makes the comment voice consistent, a little more readable, and refers to documented functions that use this enum type. Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Peter Hutterer <peter.hutterer@who-t.net>
2016-11-21protocol: spell out that we're using linux/input-event-codes.h button codesPeter Hutterer1-0/+8
Because we already rely on it in the callers anyway. This is a retrofit, which is not ideal but I'm not sure any compositor out there uses anything else. Might as well define it. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Jonas Ådahl <jadahl@gmail.com> Reviewed-by: Daniel Stone <daniels@collabora.com>
2016-11-21cursor: Remove "weston" from anonymous shm filenamesDerek Foreman1-1/+1
This mildly confused me during some debugging, so I guess it wouldn't hurt to make the filename more indicative of where it was actually created. Signed-off-by: Derek Foreman <derekf@osg.samsung.com> Reviewed-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Giulio Camuffo <giuliocamuffo@gmail.com> Reviewed-by: Daniel Stone <daniels@collabora.com>
2016-11-18util: Improve documentation of wl_argumentYong Bakos1-13/+16
Standardize the doxygen comment format, add clarity to the writing, decouple the description from specifics of usage, add see-also's, and massage the union member type comments. Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
2016-11-18tests: Add nullable check to wl_message_count_arraysYong Bakos1-2/+4
Array argument symbols in a wl_message may be nullable, but the test for wl_message_count_arrays did not test this. Add one more wl_message with nullable array arguments. Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
2016-11-18tests: Test wl_interface_equalYong Bakos2-0/+53
The test suite did not cover wl_interface_equal, so add one test that specifically tests this method. Add the new test to Makefile.am. Signed-off-by: Yong Bakos <ybakos@humanoriented.com> [Pekka: add assert(&wl_registry_interface != &copy);] Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
2016-11-18util: Document wl_interfaceYong Bakos1-0/+52
Add doxygen comments for wl_interface. Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
2016-11-17Makefile: build also test programs during a normal buildPekka Paalanen1-5/+3
Put also test programs into noinst_PROGRAMS so that they get always built. In check_PROGRAMS they are built for 'make check' but not for 'make'. This makes it harder to accidentally break the test programs. v2: also change check_LTLIBRARIES to noinst_LTLIBRARIES Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk> Reviewed-by: Daniel Stone <daniels@collabora.com>
2016-11-16doc: Fix a typo in the client documentationMoritz Kiefer1-1/+1
Signed-off-by: Moritz Kiefer <moritz.kiefer@purelyfunctional.org> Reviewed-by: Yong Bakos <ybakos@humanoriented.com>
2016-11-16protocol: Extend wl_touch with touchpoint shape and orientationDennis Kempin1-5/+77
This CL updates the wl_touch interface with a shape and orientation event. The shape/orientation of a touch point is not relevant for most UI applications, but allows a better experience in some cases such as drawing apps. The events are used by the compositor to inform the client about changes in the shape and orientation of a touchpoint, which is approximated by an ellipse and it's angle to the y-axis. The event is optional and only sent when compositor and the touch device support this type of information. The client is responsible for making a reasonable assumption about the touch shape if no shape is reported. Signed-off-by: Dennis Kempin <denniskempin@google.com> Reviewed-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Daniel Stone <daniels@collabora.com>
2016-11-16util: Document wl_fixed_tYong Bakos1-0/+36
Add doxygen comments for wl_fixed_t and its methods. Although wl_fixed_t can be thought of as an opaque struct, it is a typedef. As such, doxygen does not provide an elegant means of documenting it as both a 'class' with members and as a typedef. In other words, documenting it as a class gives us a nice doxygen page for wl_fixed_t and its related methods, but this leaves the typedef documentation blank in the documentation for wayland-util, and does not provide a link to the documentation for wl_fixed_t. Hence, this patch does not treat wl_fixed_t as a class/struct, resulting in the typedef being documented and keeping the functions listed in wayland-util, rather than a separate unlinked page devoted to just wl_fixed_t. Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Daniel Stone <daniels@collabora.com>
2016-11-16util: Remove stray space from function signatureYong Bakos1-1/+1
wl_fixed_to_double had a stray space before the parameter list. Remove this space. Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Daniel Stone <daniels@collabora.com>
2016-11-16scanner: Fixed doxygen group name for _add_listenerBill Spitzak1-1/+1
Signed-off-by: Bill Spitzak <spitzak@gmail.com> Acked-by: Yong Bakos <ybakos@humanoriented.com>
2016-11-16Makefile: do not put TESTS into check_PROGRAMSPekka Paalanen1-3/+5
If you assign TESTS into check_PROGRAMS, you cannot add a test that is not built from source files. Instead, use a temporary variable built_test_programs to hold the names that are both programs built from source files and tests to execute. This change is required by the following patch adding wayland-scanner test script. Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk> Reviewed-by: Emilio Pozuelo Monfort <emilio.pozuelo@collabora.co.uk> Reviewed-by: Peter Hutterer <peter.hutterer@who-t.net>
2016-11-10tests: Test wl_message_count_arraysYong Bakos3-1/+41
message-test.c did not cover wl_message_count_arrays, so add one test that specifically tests this method. Note that this exposes wl_message_count_arrays in a private header (wayland-private.h), and removes the `static` modifier of the implementation. Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
2016-11-10protocol: Remove inconsistent line breaksYong Bakos1-33/+0
Enum entries and message arguments are sometimes preceded by a blank line, but often aren't. Standardize the format of the protocol specification by removing blank lines preceding a list of message arguments and enum entries. Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
2016-11-10util: Document wl_messageYong Bakos1-0/+68
Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
2016-11-10scanner: Remove return doxygen annotationYong Bakos1-1/+1
Replace \returns with just Returns, as this is not a doxygen comment block. (Avoids differing with the existing convention of \return for return values.) Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Bryce Harrington <bryce@osg.samsung.com> Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
2016-11-10tests: Use unique XDG_RUNTIME_DIRDaniel Stone1-1/+2
Rather than using a hardcoded 'wayland-tests' directory under the existing XDG_RUNTIME_DIR to use as the new runtime dir, use mkdtemp to guarantee uniqueness. This fixes make -jN check, as well as just happening to run 'make check' twice from the same session. Signed-off-by: Daniel Stone <daniels@collabora.com> Reported-by: Pekka Paalanen <pekka.paalanen@collabora.com> Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk> Tested-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
2016-11-10protocol: Use singleton global consistentlyYong Bakos1-1/+1
The protocol describes wl_shm as a "global singleton" rather than "singleton global," which is the order used throughout other protocol object descriptions. Re-order the terms for consistency. Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
2016-11-10protocol: Describe wl_registry as singletonYong Bakos1-2/+2
Other singleton objects in the protocol are described as such. Add a singleton adjective to the wl_registry description, making it similar to other descriptions. Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
2016-11-10shm: Make shm_pool_interface static constYong Bakos1-1/+1
Add static const modifiers to the shm_pool_interface definition, making it consistent with the other wl_*_interface definitions and mundanely safer. Note that this does not affect the ABI, according to abi-dumper and abi-compliance-checker[1]; and weston and its shm-backed clients still run as expected. [1]: http://lvc.github.io/abi-compliance-checker/ Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Tested-by: Yong Bakos <ybakos@humanoriented.com> Acked-by: Bryce Harrington <bryce@osg.samsung.com> Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
2016-10-18util: Document GCC attributesYong Bakos1-3/+10
Add doxygen comment blocks so these annotations are documented in the html documentation. Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
2016-10-18array-test: Include wayland-util.h and simplify init testYong Bakos1-11/+9
Include wayland-util.h in addition to wayland-private.h, to be more explicit about where wl_array is defined. Remove the useless repeated testing of wl_array_init, because if it fails once out of thousands of iterations we're all doomed anyway. Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Eric Engestrom <eric.engestrom@imgtec.com> [Pekka: add the memset] Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
2016-10-18tests: Test wl_array_releaseYong Bakos1-0/+14
array-test.c did not cover wl_array_release, so add one test that specifically tests this method. Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Eric Engestrom <eric.engestrom@imgtec.com> [Pekka: do not overwrite array.data] Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
2016-10-18wl_array: Set data to invalid address after freeYong Bakos2-0/+4
Explicitly set the data member to an invalid memory address during wl_array_release, such that re-using a freed wl_array without re-initializing causes a crash. In addition, this pointer assignment makes wl_array_release testable. Define a constant for the invalid memory address, and add documentation about this behavior, starting at libwayland version 1.13. See https://lists.freedesktop.org/archives/wayland-devel/2016-September/031116.html Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Eric Engestrom <eric.engestrom@imgtec.com> [Pekka: remove the doc about crashing] Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
2016-10-18util: Document wl_arrayYong Bakos1-5/+68
Add doxygen comments for wl_array and its methods. Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Eric Engestrom <eric.engestrom@imgtec.com> Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
2016-09-26util: Document wl_list methodsYong Bakos1-40/+184
Add doxygen comment blocks to all wl_list methods. Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Bryce Harrington <bryce@osg.samsung.com> [Pekka: removed "itself" as suggested by Bryce] Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
2016-09-22configure.ac: bump version to 1.12.90 for open developmentBryce Harrington1-1/+1
Signed-off-by: Bryce Harrington <bryce@osg.samsung.com>
2016-09-20configure.ac: bump to version 1.12.0 for the official releaseBryce Harrington1-2/+2
2016-09-13configure.ac: bump to version 1.11.94 for the RC2 releaseBryce Harrington1-1/+1
2016-09-13server: Document display parameterYong Bakos1-0/+1
Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Bryce Harrington <bryce@osg.samsung.com> Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
2016-09-13protocol: Replace '#defines' with 'macros'Yong Bakos1-1/+1
The use of # within a description causes the documentation generator to mistake C syntax with a documentation link. Remove the # from the documentation, suppressing the warning. Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Bryce Harrington <bryce@osg.samsung.com> Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
2016-09-06configure.ac: bump to version 1.11.93 for the RC1 releaseBryce Harrington1-1/+1
2016-09-05tests: Add test for wl_list_lengthYong Bakos1-0/+13
list-test.c did not cover wl_list_length, so add one test that specifically tests this method. Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Eric Engestrom <eric.engestrom@imgtec.com> Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
2016-09-05doc: Correct docbook titleYong Bakos1-1/+1
The docbook title was "The Wayland display server," which is inaccurate. Change the title to "The Wayland Protocol". Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
2016-08-30configure.ac: bump to version 1.11.92 for the beta releaseBryce Harrington1-1/+1
2016-08-16configure.ac: bump to version 1.11.91 for the alpha releaseBryce Harrington1-1/+1
2016-08-12protocol: Specify upper left corner of damage rectangleYong Bakos1-2/+4
Specify x and y args as the upper left corner of the surface / buffer damage rectangle. Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Bryce Harrington <bryce@osg.samsung.com>
2016-08-12protocol: Describe serial as serial numberYong Bakos1-5/+5
Change "serial" to "serial number" in arg summaries, for consistency and clarity. Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Bryce Harrington <bryce@osg.samsung.com>
2016-08-12protocol: Remove wl_ prefix from summary descriptionsYong Bakos1-4/+4
Summary attributes sometime describe objects using their wl-prefixed type, but more often don't. Remove the wl_ prefix from summary descriptions, since they tend to describe concepts. Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Bryce Harrington <bryce@osg.samsung.com>
2016-08-12protocol: Correct description indentationYong Bakos1-5/+5
Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Bryce Harrington <bryce@osg.samsung.com>
2016-08-12protocol: Add missing line breakYong Bakos1-0/+1
Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Bryce Harrington <bryce@osg.samsung.com>
2016-08-12protocol: Capitalize ID for consistencyYong Bakos1-1/+1
Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Bryce Harrington <bryce@osg.samsung.com>
2016-08-12protocol: Hyphenate subsurfaceYong Bakos1-1/+1
Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Bryce Harrington <bryce@osg.samsung.com>
2016-08-12protocol: Add summary attributes to request params and enum entriesYong Bakos1-168/+179
Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Bryce Harrington <bryce@osg.samsung.com>
2016-08-12server: Add doxygen comment for wl_client_for_eachYong Bakos1-0/+1
Commit 596024f728b0a1292ee69a80dd72a85167870936 includes a doc comment with a link to the wl_client_for_each macro, causing an error when generating documentation. Add a doc comment to wl_client_for_each, enabling the hyperlink and removing the error. Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Bryce Harrington <bryce@osg.samsung.com>
2016-08-12Add API to install protocol loggers on the server wl_displayGiulio Camuffo4-7/+272
The new wl_display_add_protocol_logger allows to set a function as a logger, which will get called when a new request is received or an event is sent. This is akin to setting WAYLAND_DEBUG=1, but more powerful because it can be enabled at run time and allows to show the log e.g. in a UI view. A test is added for the new functionality. Signed-off-by: Giulio Camuffo <giulio.camuffo@kdab.com> Reviewed-by: Jonas Ådahl <jadahl@gmail.com> Reviewed-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
2016-08-12Add API to retrieve and iterate over the resources list of a clientGiulio Camuffo5-7/+85
To complement on the new resource created signal, this allows to iterate over the existing resources of a client. Signed-off-by: Giulio Camuffo <giulio.camuffo@kdab.com> Reviewed-by: Jonas Ådahl <jadahl@gmail.com> [Pekka: added empty lines, init ret in for_each_helper()] Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>