From 5ed11ffd57876fc3cf7e19373450e9e6426406b2 Mon Sep 17 00:00:00 2001 From: Markus Armbruster Date: Wed, 30 Dec 2020 18:01:25 +0100 Subject: [PATCH] doc/coding: Improve section "Portability" a bit Signed-off-by: Markus Armbruster --- doc/coding | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) 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 -- 2.43.0