From: Markus Armbruster <armbru@pond.sub.org>
Date: Wed, 30 Dec 2020 17:01:25 +0000 (+0100)
Subject: doc/coding: Improve section "Portability" a bit
X-Git-Tag: v4.4.1~46
X-Git-Url: http://git.pond.sub.org/?p=empserver;a=commitdiff_plain;h=7714a8cb82eda6fb99e3c70d94843fba70c1ffb4

doc/coding: Improve section "Portability" a bit

Signed-off-by: Markus Armbruster <armbru@pond.sub.org>
---

diff --git a/doc/coding b/doc/coding
index 7dcee436c..afb11e598 100644
--- a/doc/coding
+++ b/doc/coding
@@ -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