Skip to content

Commit 748be9d

Browse files
committed
doc: Update documentation about Windows platforms support a bit
Update what c-extensions says about Windows platforms support a bit: - Document that MinGW Win32 gets let off being POSIX-compilant - Document the minimum Windows version supported Signed-off-by: Jon TURNEY <[email protected]> Reviewed-by: Colin Harrison <[email protected]>
1 parent cc1d8fa commit 748be9d

File tree

1 file changed

+13
-6
lines changed

1 file changed

+13
-6
lines changed

doc/c-extensions

+13-6
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ The server will not build if your toolchain does not support these extensions.
3535
* interleaved code and declarations: { foo = TRUE; int bar; do_stuff(); }
3636

3737

38-
Use of OS and library facilities throughout the X server tree
38+
Use of library facilities throughout the X server tree
3939
-------------------------------------------------------------
4040

4141
Non-OS-dependent code can assume facilities at least as good as
@@ -44,18 +44,25 @@ be C99, but even gcc+glibc doesn't implement that yet.
4444

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

47+
Note that there are two Windows ports, Cygwin and MinGW:
48+
- Cygwin is more or less like Linux.
49+
- MinGW is more restrictive. Windows does not provide the required
50+
POSIX facilities, so some non-OS-dependent code is stubbed out or
51+
has an alternate implementation if WIN32 is defined. Code that
52+
needs to be portable to Windows should be careful to, well, be portable.
53+
54+
55+
Required OS facilities
56+
-------------------------------------------------------------
57+
4758
Linux systems must be at least 2.4 or later. As a practical matter
4859
though, 2.4 kernels never receive any testing. Use 2.6 already.
4960

5061
TODO: Solaris.
5162

5263
TODO: *BSD.
5364

54-
Code that needs to be portable to Windows should be careful to,
55-
well, be portable. Note that there are two Windows ports, cygwin and
56-
mingw. Cygwin is more or less like Linux, but mingw is a bit more
57-
restrictive. TODO: document which versions of Windows we actually care
58-
about.
65+
Windows-dependent code assumes at least NT 5.1.
5966

6067
OSX support is generally limited to the most recent version. Currently
6168
that means 10.5.

0 commit comments

Comments
 (0)