doc/coding: Improve section "Portability" a bit
authorMarkus Armbruster <armbru@pond.sub.org>
Wed, 30 Dec 2020 17:01:25 +0000 (18:01 +0100)
committerMarkus Armbruster <armbru@pond.sub.org>
Sat, 23 Jan 2021 07:39:13 +0000 (08:39 +0100)
Signed-off-by: Markus Armbruster <armbru@pond.sub.org>
doc/coding

index 7dcee436ceeb6267cb74b462f4fe10cbdba0841a..afb11e598312437d6037767b9abc3b703992144e 100644 (file)
@@ -360,7 +360,18 @@ it's as relevant as ever:
 Portability
 -----------
 
-FIXME C99, POSIX
+Code for IEEE Std 1003.1-2001 (POSIX.1-2001) with the X/Open System
+Interfaces Extension.  This standard includes ISO/IEC 9899:1999 (C99)
+by reference.
+
+Some systems may have flaws that require work-arounds.  Use Autoconf
+to detect the flaws, and isolate the system-specific code, e.g. by
+providing a replacement function when the system's function is flawed.
+
+Keeping the Windows build working may require extending src/lib/w32/.
+
+Keep the client as portable as practical.  In particular, stick to
+C89.
 
 FIXME sizes, printf formats