summaryrefslogtreecommitdiff
AgeCommit message (Collapse)AuthorFilesLines
2013-04-18protocol: revert hotspot_x/y in set_cursor back to int1.1Peter Hutterer1-2/+2
copy/paste error introduced in 9c0357af6ee42c318ce37b458ae7bdb7d51316cb Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-18protocol: Make it clear that returned "one-shot" objects are destroyedRob Bradford1-0/+8
The objects returned by the frame and sync request are destroyed by the compositor after the "done" event on the wl_callback interface is fired.
2013-04-15configure.ac: Bump version to 1.1.0Kristian Høgsberg1-2/+2
2013-04-15docs: Create html-pdf directories tooKristian Høgsberg1-0/+3
Fixes make dist here.
2013-04-04doc: use a dynamic list of man pagesPeter Hutterer1-51/+6
This requires that doxygen is run before the man target so find can actually find the man pages. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-04doc: Improve "Library" and "Compositors" chapterPeter Hutterer2-1/+35
Originally written Tiago Vignatti <tiago.vignatti@intel.com> Some modifications to adjust for previously merged conflicting patches and link to the sections (instead of <emphasis>). Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-04doc: create a fake make target to de-duplicate the xml merging processPeter Hutterer1-21/+16
The only difference between the server and client xml files is the directories and files being named *server* and *client*, respectively. Add a new make target to get that process done to avoid duplication Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-04doc: generate server documentation from XML tooPeter Hutterer5-22/+50
Same as WaylandClientAPI.xml we now also generate WaylandServerAPI.xml for publication. Most of this hunk is just adding a client/ or server/ into the xml path to keep the two separate. The change in wayland.doxygen now causes a standard doxygen call to not generate anything - what is generated is specified through the options passed by make. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-04doc: Capitalize all Wayland occurrencesTiago Vignatti5-19/+19
Signed-off-by: Tiago Vignatti <tiago.vignatti@intel.com> Reviewed-by: Peter Hutterer <peter.hutterer@who-t.net> [re-run of search/replace after rebasing] Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-04protocol: input documentation fixesPeter Hutterer1-4/+4
Fix summary for wl_touch::motion, extend summary for wl_touch::down to match up/motion a bit better. Fix a typo in wl_touch, and claim that it's zero or more update events, not one or more. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-04wayland-client: Avoid null dereference when handling deletionRob Bradford1-1/+5
If an unknown id is deleted then the lookup in the map will return NULL and so we should avoid dereferencing that. As this is unexpected behaviour log a message about the problem too.
2013-04-03docs: Use MIT for documentation licenseKristian Høgsberg1-1/+33
2013-04-03configure.ac: Fix publican version checkKristian Høgsberg1-1/+1
This sure is ugly - we feed output of publican -v into bc to compare against minimum required version, 2.8. That's bad enough, but when publican suddenly report 3.0.0, bc starts complaining... Use sed to filter out 3.0 from the 'version=3.0.0' output from publican instead. Seem a little more robust, but it's just a matter of time before something else breaks this flaky setup. Hey, publican, how about shipping .pc files?
2013-04-03doc: rename "Wayland" to "publican"Peter Hutterer24-2/+2
This directory was called Wayland during my early tries with publican where the source layout was different and it needed to be set to the same name as the publican output directory. This reason doesn't exist anymore, so re-name it to publican to make it more obvious what's hiding in here. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-03doc: generate man pages from doxygenPeter Hutterer2-5/+72
Create client-side and server-side man pages from doxygen. The doxygen config options are virtually the same as for the XML output, but we do pass in the specific options via stdin. WL_EXPORT is predefined to the empty string, it makes the man page look confusing and provides no value here anyway. This applies for both xml and man output. JAVADOC_AUTOBRIEF is disabled for man pages, the formatting in the resulting man page is IMO hard to read. Most of the server man pages are virtually empty, there's just not enough documentation in the source files. Interesting issue: the usage of @code in the protocol to reference the parameter breaks the expansion of WL_EXPORT, thus leaving us with WL_EXPORT in all the man pages. Presumably this is an issue with doxygen interpreting this as a @code command, but I already wasted enough time narrowing this down. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-03protocol: fix two protocol description 'typos'Peter Hutterer1-4/+4
Remove "mice, for example", it's described in the wl_pointer interface in detail. And remove space before the full stop. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-03protocol: document wl_pointer, wl_keyboard, wl_touchPeter Hutterer1-21/+27
Most of this should be clear, but let's spell a few things out. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-03protocol: use "summary", not "description" for xkb_v1 formatPeter Hutterer1-1/+1
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-03doc: don't start a variable list if we have no sub-elementsPeter Hutterer1-5/+7
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-03doc: improve formatting of client-side documentationPeter Hutterer1-3/+92
A bunch of changes to the xsl transformation stylesheet to make Chapter 4 (Client API) look nicer and more readable. Main changes: - function synopsis listed - lists for parameters and return values - long function descriptions - misc other hooks for "see also", "note", etc The long description is a sore point. doxygen xml output is difficult to parse with the output being in the form of <detailed description> <para> <parameterlist> .... </parameterlist> <simplesect kind="return">... </simplesect> First paragraph of long description </para> <para> Second paragraph of long <sometag>description</sometag> </para> </detaileddescription> So we need to ignore parameterlist and simplesect, but extract the text from everything else. Any improvements on that welcome. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-03doc: change wording in section introductionPeter Hutterer1-1/+1
If we don't have descriptions of classes, the "And" is awkward. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-03doc: add wayland.doxygen as target dependencyPeter Hutterer1-1/+1
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-03Rename en_US to sourcesPeter Hutterer17-20/+20
The reason this directory exists is because we need to copy it into $builddir so we can combine it with generated sources (we can't pass multiple source paths into publican). So instead of having en_US, renamed to en-US stop the confusion and rename the sources to "sources". That gets copied to en-US which will then contain the actual output. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-03doc: explain the publican build processPeter Hutterer1-0/+17
This makefile is a bit hard to read due to some publican requirements and the need to generate some files through XSLT. Explain the lot, so that those looking at this roughly know what will hit them. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-03doc: clarify how ClientAPI.xml is builtPeter Hutterer1-3/+6
I found the comment a bit confusing and it's quite hard to read. re-explain with a simple step-by-step list Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-03doc: Format Chapter 4 paragraphs correctlyTiago Vignatti1-2/+3
Signed-off-by: Tiago Vignatti <tiago.vignatti@intel.com>
2013-04-03doc: minor title wording fixPeter Hutterer1-1/+1
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-03doc: Change chapter title to a more descriptive oneTiago Vignatti1-1/+1
Signed-off-by: Tiago Vignatti <tiago.vignatti@intel.com> Reviewed-by: Peter Hutterer <peter.hutterer@who-t.net> Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-03doc: Rename Overview.xml to Introduction.xmlTiago Vignatti3-6/+6
Rename Overview.xml to Introduction.xml, reflecting the previous commit. Organize also Wayland.xml order of the includes. Signed-off-by: Tiago Vignatti <tiago.vignatti@intel.com> Reviewed-by: Peter Hutterer <peter.hutterer@who-t.net> Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-03doc: Improve the first chapter text and definitionsTiago Vignatti1-22/+9
In the beginning of the chapter, it was defined what is the so called "X" thing and was removed the "Wayland" and "Weston" definitions cause we're defining later at 1.2 anyway. "Introduction", "Motivation" and "Compositing manager as the display server" names sound better a bit than "Overview", "Replacing X11" and "Make the compositing manager the display server" respectively. That was changed also. Signed-off-by: Tiago Vignatti <tiago.vignatti@intel.com> Reviewed-by: Peter Hutterer <peter.hutterer@who-t.net> Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-03doc: Set book edition number to the "1"Tiago Vignatti1-1/+1
"1" sounds better when we mention about the "first" edition or say the "publishing" edition. If needed, we might want to increase the edition numbers automatically later, for instance based on the micro version of the protocol or something like that. Signed-off-by: Tiago Vignatti <tiago.vignatti@intel.com> Reviewed-by: Peter Hutterer <peter.hutterer@who-t.net> Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-03doc: Add a Foreword and a PrefaceTiago Vignatti4-0/+53
In particular, the preface defines the scope of this document we're building -- is the definition there enough with respect to what we want with this? Signed-off-by: Tiago Vignatti <tiago.vignatti@intel.com> Reviewed-by: Peter Hutterer <peter.hutterer@who-t.net> Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-03doc: don't add a para for an empty summaryPeter Hutterer1-3/+5
Removes enough empty lines to cut the PDF down by 4 pages. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-03utils: const-ify some function argumentsGiulio Camuffo2-4/+4
2013-04-03wayland-server: Listen for pointer current surface destructionRob Bradford2-0/+28
Add a destroy listener so that when the current surface associated with the pointer is destroyed we can reset the pointer to the current surface. In order to achieve this add a wl_pointer_set_current() which handles assigning the surface and creating the listener. This resolves a use-after-free error triggered with nested popup surfaces Fixes: https://bugzilla.gnome.org/show_bug.cgi?id=696946
2013-04-02docs: Document non-blocking behaviour of wl_display_flush()Kristian Høgsberg1-1/+6
2013-04-02server: use void* instead of function pointer for wl_object.implementationGiulio Camuffo1-1/+1
This is needed to make C++ programs that include wayland-server.h build: C++ does not allow conversions from data pointers to function pointers.
2013-04-02server: use the right function pointer type in wl_signal_getGiulio Camuffo1-1/+1
use the wl_notify_func type, and not void *, or else wl_signal_get will not be usable by a c++ plugin because it will not cast void * to a function pointer.
2013-04-01docs: Add information about serials and timestampsMatthias Clasen1-0/+16
Add some information about serials, timestamps and their uses to the Input section in the protocol overview.
2013-04-01docs: Document granularity of timestampsMatthias Clasen1-8/+12
This information is necessary to make any use of these fields.
2013-04-01docs: Remove mention of touch focusfd-lockKristian Høgsberg1-2/+1
There is no focused surface for a touch screen.
2013-04-01docs: Add details about grabsMatthias Clasen1-0/+8
Mention implicit grabs, (lack of) explicit grabs, and popup windows.
2013-04-01docs: Add details about surfacesMatthias Clasen1-0/+2
Mention some of the characteristic differences to X: no global positions, no access to foreign windows.
2013-04-01docs: Improve wl_region protocol docsMatthias Clasen1-4/+7
Just cosmetic changes, a few missing periods, and ID was not capitalized.
2013-04-01docs: Improve the wl_output protocol docsMatthias Clasen1-6/+18
Some descriptions were missing.
2013-04-01docs: Improve wl_touch protocol docsMatthias Clasen1-9/+27
Some descriptions were missing here.
2013-04-01docs: Improve wl_keyboard protocol docsMatthias Clasen1-6/+19
Some descriptions were missing here.
2013-04-01docs: Improve wl_pointer protocol docsMatthias Clasen1-10/+33
Some descriptions were missing here.
2013-04-01docs: Improve the wl_seat protocol docsMatthias Clasen1-13/+22
Expand the main description and tell if requests don't have an effect.
2013-04-01docs: Improve wl_surface protocol docsMatthias Clasen1-54/+69
Use NULL consistently. And add some more information in a few places.
generated by cgit v1.2.3 (git 2.39.1) at 2024-06-09 14:05:00 +0000