aboutsummaryrefslogtreecommitdiff
path: root/xorg-server/doc/c-extensions
blob: 4a90061508ddfb3be18a484020b3870d80807edf (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
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 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.