From: Ian Jackson Date: Wed, 5 Nov 2014 14:32:47 +0000 (+0000) Subject: libxl: CODING_STYLE: Discuss existing style problems X-Git-Tag: archive/raspbian/4.8.0-1+rpi1~1^2~4081 X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=09ff8eadec09233b905f79579900006fb17dd55f;p=xen.git libxl: CODING_STYLE: Discuss existing style problems Document that: - the existing code is not all confirming yet - code should conform - we will sometimes accept patches with nonconforming elements if they don't make matters worse. Signed-off-by: Ian Jackson Acked-by: Wei Liu Release-Acked-by: Konrad Rzeszutek Wilk --- diff --git a/tools/libxl/CODING_STYLE b/tools/libxl/CODING_STYLE index 9a1d6e0933..f5b58909b3 100644 --- a/tools/libxl/CODING_STYLE +++ b/tools/libxl/CODING_STYLE @@ -2,6 +2,24 @@ LIBXENLIGHT CODING STYLE ======================== +AN APOLOGY AND WARNING +---------------------- + +Much of the code in libxl does not yet follow this coding style +document in every respect. However, new code is expected to conform. + +Patches to improve the style of existing code are welcome. Please +separate these out from functional changes. + +If it is not feasible to conform fully to the style while patching old +code, without doing substantial style reengineering first, we may +accept patches which contain nonconformant elements, provided that +they don't make the coding style problem worse overall. + +In this case, the new code should conform to the prevailing style in +the area being touched. + + MEMORY ALLOCATION -----------------