xserver mesa xkbcomp git update 5 nov 2012

xserver: a194630f7f7b287cb4ea4a459df0745f4c0d4c1a
mesa: ccbfe3dde94cd50a4e6468cfeabf95c79c9d8072
xkbcomp: a68c5b7b29eb1433b1be73b50c4248e10eab8e64

1 files changed, 68 insertions, 61 deletions

diff --git a/xorg-server/doc/c-extensions b/xorg-server/doc/c-extensions
index 984022333..4a9006150 100644
--- a/xorg-server/doc/c-extensions
+++ b/xorg-server/doc/c-extensions
@@ -1,61 +1,68 @@
-First of all: C89 or better.  If you don't have that, port gcc first.

-

-Use of C language extensions throughout the X server tree

----------------------------------------------------------

-

-Optional extensions:

-The server will still build if your toolchain does not support these

-extensions, although the results may not be optimal.

-

-    * _X_SENTINEL(x): member x of the passed structure must be NULL, e.g.:

-                      void parseOptions(Option *options _X_SENTINEL(0));

-                      parseOptions("foo", "bar", NULL); /* this is OK */

-                      parseOptions("foo", "bar", "baz"); /* this is not */

-                      This definition comes from Xfuncproto.h in the core

-                      protocol headers.

-    * _X_ATTRIBUTE_PRINTF(x, y): This function has printf-like semantics;

-                                 check the format string when built with

-                                 -Wformat (gcc) or similar.

-    * _X_EXPORT: this function should appear in symbol tables.

-    * _X_HIDDEN: this function should not appear in the _dynamic_ symbol

-                 table.

-    * _X_INTERNAL: like _X_HIDDEN, but attempt to ensure that this function

-                   is never called from another module.

-    * _X_INLINE: inline this functon if possible (generally obeyed unless

-                 disabling optimisations).

-    * _X_DEPRECATED: warn on use of this function.

-

-Mandatory extensions:

-The server will not build if your toolchain does not support these extensions.

-

-    * named initialisers: explicitly initialising structure members, e.g.:

-                          struct foo bar = { .baz = quux, .brian = "dog" };

-    * variadic macros: macros with a variable number of arguments, e.g.:

-                       #define DebugF(x, ...) /**/

-    * interleaved code and declarations: { foo = TRUE; int bar; do_stuff(); }

-

-

-Use of OS and library facilities throughout the X server tree

--------------------------------------------------------------

-

-Non-OS-dependent code can assume facilities at least as good as

-the non-OS-facility parts of POSIX-1.2001.  Ideally this would

-be C99, but even gcc+glibc doesn't implement that yet.

-

-Unix-like systems are assumed to be at least as good as UNIX03.

-

-Linux systems must be at least 2.4 or later.  As a practical matter

-though, 2.4 kernels never receive any testing.  Use 2.6 already.

-

-TODO: Solaris.

-

-TODO: *BSD.

-

-Code that needs to be portable to Windows should be careful to,

-well, be portable.  Note that there are two Windows ports, cygwin and

-mingw.  Cygwin is more or less like Linux, but mingw is a bit more

-restrictive.  TODO: document which versions of Windows we actually care

-about.

-

-OSX support is generally limited to the most recent version.  Currently

-that means 10.5.

+First of all: C89 or better.  If you don't have that, port gcc first.
+
+Use of C language extensions throughout the X server tree
+---------------------------------------------------------
+
+Optional extensions:
+The server will still build if your toolchain does not support these
+extensions, although the results may not be optimal.
+
+    * _X_SENTINEL(x): member x of the passed structure must be NULL, e.g.:
+                      void parseOptions(Option *options _X_SENTINEL(0));
+                      parseOptions("foo", "bar", NULL); /* this is OK */
+                      parseOptions("foo", "bar", "baz"); /* this is not */
+                      This definition comes from Xfuncproto.h in the core
+                      protocol headers.
+    * _X_ATTRIBUTE_PRINTF(x, y): This function has printf-like semantics;
+                                 check the format string when built with
+                                 -Wformat (gcc) or similar.
+    * _X_EXPORT: this function should appear in symbol tables.
+    * _X_HIDDEN: this function should not appear in the _dynamic_ symbol
+                 table.
+    * _X_INTERNAL: like _X_HIDDEN, but attempt to ensure that this function
+                   is never called from another module.
+    * _X_INLINE: inline this functon if possible (generally obeyed unless
+                 disabling optimisations).
+    * _X_DEPRECATED: warn on use of this function.
+
+Mandatory extensions:
+The server will not build if your toolchain does not support these extensions.
+
+    * named initialisers: explicitly initialising structure members, e.g.:
+                          struct foo bar = { .baz = quux, .brian = "dog" };
+    * variadic macros: macros with a variable number of arguments, e.g.:
+                       #define DebugF(x, ...) /**/
+    * interleaved code and declarations: { foo = TRUE; int bar; do_stuff(); }
+
+
+Use of library facilities throughout the X server tree
+-------------------------------------------------------------
+
+Non-OS-dependent code can assume facilities at least as good as
+the non-OS-facility parts of POSIX-1.2001.  Ideally this would
+be C99, but even gcc+glibc doesn't implement that yet.
+
+Unix-like systems are assumed to be at least as good as UNIX03.
+
+Note that there are two Windows ports, Cygwin and MinGW:
+- Cygwin is more or less like Linux.
+- MinGW is more restrictive. Windows does not provide the required
+POSIX facilities, so some non-OS-dependent code is stubbed out or
+has an alternate implementation if WIN32 is defined.  Code that
+needs to be portable to Windows should be careful to, well, be portable.
+
+
+Required OS facilities
+-------------------------------------------------------------
+
+Linux systems must be at least 2.4 or later.  As a practical matter
+though, 2.4 kernels never receive any testing.  Use 2.6 already.
+
+TODO: Solaris.
+
+TODO: *BSD.
+
+Windows-dependent code assumes at least NT 5.1.
+
+OSX support is generally limited to the most recent version.  Currently
+that means 10.5.