From db616f009101e834a0690cdf29737c4add6b7aa3 Mon Sep 17 00:00:00 2001 From: William Roberts Date: Sat, 9 Apr 2016 10:24:25 -0700 Subject: [PATCH] fs_config: correct README Testing on earlier versions of Python indicated an error in the README. Python's ConfigParser prior to version 3.2 allows for sections within the same file to override later sections. Correct the README. Test: Checked diff and hash of output file from before and after. Change-Id: Ifd3f78414b4803e4b74decb1fdf6816d4902c4a2 Signed-off-by: William Roberts --- tools/fs_config/README | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/tools/fs_config/README b/tools/fs_config/README index 7eca4a382..025868747 100644 --- a/tools/fs_config/README +++ b/tools/fs_config/README @@ -67,8 +67,9 @@ caps: * hex (0xFF) For multiple caps, just separate by whitespace. -It is an error to specify multiple sections with the same [path]. Per the ini -specifications enforced by Pythons ConfigParser. +It is an error to specify multiple sections with the same [path] in different +files. Note that the same file may contain sections that override the previous +section in Python versions <= 3.2. In Python 3.2 it's set to strict mode. The next section type is the "AID" section, for specifying OEM specific AIDS. @@ -84,13 +85,13 @@ Where: The can be any valid character for a #define identifier in C. value: - A valid C style number string. Hex, octal, binary and decimal are supported. See "caps" - above for more details on number formatting. + A valid C style number string. Hex, octal, binary and decimal are supported. + See "caps" above for more details on number formatting. -It is an error to specify multiple sections with the same [AID_]. Per the ini -specifications enforced by Pythons ConfigParser. It is also an error to specify -multiple sections with the same value option. It is also an error to specify a value -that is outside of the inclusive OEM ranges: +It is an error to specify multiple sections with the same [AID_]. With +the same constraints as [path] described above. It is also an error to specify +multiple sections with the same value option. It is also an error to specify a +value that is outside of the inclusive OEM ranges: * AID_OEM_RESERVED_START(2900) - AID_OEM_RESERVED_END(2999) * AID_OEM_RESERVED_2_START(5000) - AID_OEM_RESERVED_2_END(5999) -- 2.11.0