When building the ARM version of the embedded book, there's 5 different ABI choices presented in section 6.3 but not much info on why someone should pick one over any other. That was confusing for me the first time I went through the book, I didn't know which one to choose.
Would it be worthwhile to add a third column to the ABI table to provide a short note that can help people make a selection? I've attached a patch with a rough idea. Would something like this be a worthwhile addition to the embedded book? Thanks, Andrew
From 23b90d898cc73036eb95c5dc088245e01e9a9e57 Mon Sep 17 00:00:00 2001 From: Andrew Bradford <[email protected]> Date: Mon, 24 Jan 2011 20:08:04 -0500 Subject: [PATCH] Added notes to ARM ABI Variable table The listing of ARM ABI variables can be intimidating because there's 5 choices and no information on which should be chosen. I attempted to make short notes to help inform people about which ABI would be a good choice. Good info about ARM ABIs found at: http://wiki.debian.org/ArmEabiPort --- BOOK/cross-tools/arm/abi.xml | 7 +++++++ 1 files changed, 7 insertions(+), 0 deletions(-) diff --git a/BOOK/cross-tools/arm/abi.xml b/BOOK/cross-tools/arm/abi.xml index 698a54c..9c042b9 100644 --- a/BOOK/cross-tools/arm/abi.xml +++ b/BOOK/cross-tools/arm/abi.xml @@ -30,11 +30,13 @@ <colspec colnum="1" colwidth="1.5in" colname="ABI to Select"/> <colspec colnum="2" colwidth="1.5in" colname="Variable Value"/> + <colspec colnum="3" colwidth="2in" colname="Note"/> <thead> <row> <entry>ABI</entry> <entry>BUILD=Value</entry> + <entry>Note</entry> </row> </thead> @@ -42,22 +44,27 @@ <row> <entry>apcs-gnu</entry> <entry>-mabi=apcs-gnu</entry> + <entry>Legacy ABI, arm4 and older</entry> </row> <row> <entry>atpcs</entry> <entry>-mabi=atpcs</entry> + <entry>Thumb ABI</entry> </row> <row> <entry>aapcs</entry> <entry>-mabi=aapcs</entry> + <entry>EABI w/ variable size enums</entry> </row> <row> <entry>aapcs-linux</entry> <entry>-mabi=aapcs-linux</entry> + <entry>EABI w/ standard Linux 32 bit (int) enums</entry> </row> <row> <entry>iwmmxt</entry> <entry>-mabi=iwmmxt</entry> + <entry>Supports Intel XScale MMX extensions</entry> </row> </tbody> -- 1.5.6.5
_______________________________________________ Clfs-dev mailing list [email protected] http://lists.cross-lfs.org/listinfo.cgi/clfs-dev-cross-lfs.org
