Refactored out a part of ObjCARCOpt::OptimizeReturns into its own method HasSafePathT...

[oota-llvm.git] / docs / HowToBuildOnARM.rst

diff --git a/docs/HowToBuildOnARM.rst b/docs/HowToBuildOnARM.rst
index 793015a4ed40f7d97e161dfe0da8300878b1b235..32ae39ba688362e90368f6acf96da43a29b8df18 100644 (file)
--- a/docs/HowToBuildOnARM.rst
+++ b/docs/HowToBuildOnARM.rst
@@ -1,34 +1,43 @@
-.. _how_to_build_on_arm:\r
-\r
-===================================================================\r
-How To Build On ARM\r
-===================================================================\r
-\r
-.. sectionauthor:: Wei-Ren Chen (陳韋任) <chenwj@iis.sinica.edu.tw>\r
-\r
-Introduction\r
-============\r
-\r
-This document contains information about building/testing LLVM and\r
-Clang on ARM.\r
-\r
-Notes On Building LLVM/Clang on ARM\r
-=====================================\r
-Here are some notes on building/testing LLVM/Clang on ARM. Note that\r
-ARM encompasses a wide variety of CPUs; this advice is primarily based\r
-on the ARMv6 and ARMv7 architectures and may be inapplicable to older chips.\r
-\r
-#. If you are building LLVM/Clang on an ARM board with 1G of memory or less,\r
-   please use ``gold`` rather then GNU ``ld``.\r
-   Building LLVM/Clang with ``--enable-optimized``\r
-   is prefered since it consumes less memory. Otherwise, the building\r
-   process will very likely fail due to insufficient memory. In any\r
-   case it is probably a good idea to set up a swap partition.\r
-\r
-#. If you want to run ``make\r
-   check-all`` after building LLVM/Clang, to avoid false alarms (eg, ARCMT\r
-   failure) please use the following configuration:\r
-\r
-   .. code-block:: bash\r
-\r
-     $ ../$LLVM_SRC_DIR/configure --with-abi=aapcs\r
+===================================================================
+How To Build On ARM
+===================================================================
+
+Introduction
+============
+
+This document contains information about building/testing LLVM and
+Clang on ARM.
+
+Notes On Building LLVM/Clang on ARM
+=====================================
+Here are some notes on building/testing LLVM/Clang on ARM. Note that
+ARM encompasses a wide variety of CPUs; this advice is primarily based
+on the ARMv6 and ARMv7 architectures and may be inapplicable to older chips.
+
+#. If you are building LLVM/Clang on an ARM board with 1G of memory or less,
+   please use ``gold`` rather then GNU ``ld``.
+   Building LLVM/Clang with ``--enable-optimized``
+   is prefered since it consumes less memory. Otherwise, the building
+   process will very likely fail due to insufficient memory. In any
+   case it is probably a good idea to set up a swap partition.
+
+#. If you want to run ``make
+   check-all`` after building LLVM/Clang, to avoid false alarms (eg, ARCMT
+   failure) please use at least the following configuration:
+
+   .. code-block:: bash
+
+     $ ../$LLVM_SRC_DIR/configure --with-abi=aapcs-vfp
+
+#. The most popular linaro/ubuntu OS's for ARM boards, eg, the
+   Pandaboard, have become hard-float platforms. The following set
+   of configuration options appears to be a good choice for this
+   platform:
+
+   .. code-block:: bash
+
+     ./configure --build=armv7l-unknown-linux-gnueabihf \
+     --host=armv7l-unknown-linux-gnueabihf \
+     --target=armv7l-unknown-linux-gnueabihf --with-cpu=cortex-a9 \
+     --with-float=hard --with-abi=aapcs-vfp --with-fpu=neon \
+     --enable-targets=arm --enable-optimized --enable-assertions