[PATCH 2/4] doc: Update documentation about Windows platforms support

[Jon TURNEY]

On 23/10/2012 17:13, Colin Harrison wrote:
>> Jon Turney wrote:  +Windows-dependent code assumes at least NT 5.0.
> 
> Window 2000 and earlier are <1% of global OS use and it reached the end of
> its lifecycle in 2010
> Can't we make this NT 5.1?
> I can't test XP properly either...but that is used by ~44% so still worth
> the trouble to try.

Yes, this is probably more sensible.  I do test with XP, but nothing earlier,
so while I don't think any interfaces not in Window 2000 are used, I don't
know for sure.

Updated patch attached.

-------------- next part --------------
>From f61882dbfb659124aa20471ecc007c1ad48ab617 Mon Sep 17 00:00:00 2001
From: Jon TURNEY <jon.turney at dronecode.org.uk>
Date: Tue, 1 May 2012 20:08:41 +0100
Subject: [PATCH] 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 <jon.turney at dronecode.org.uk>
---
 doc/c-extensions |   19 +++++++++++++------
 1 files changed, 13 insertions(+), 6 deletions(-)

diff --git a/doc/c-extensions b/doc/c-extensions
index eb33e27..4a90061 100644
--- a/doc/c-extensions
+++ b/doc/c-extensions
@@ -35,7 +35,7 @@ The server will not build if your toolchain does not support these extensions.
     * interleaved code and declarations: { foo = TRUE; int bar; do_stuff(); }
 
 
-Use of OS and library facilities throughout the X server tree
+Use of library facilities throughout the X server tree
 -------------------------------------------------------------
 
 Non-OS-dependent code can assume facilities at least as good as
@@ -44,6 +44,17 @@ 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.
 
@@ -51,11 +62,7 @@ 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.
+Windows-dependent code assumes at least NT 5.1.
 
 OSX support is generally limited to the most recent version.  Currently
 that means 10.5.
-- 
1.7.9