README.android

   1 /*
   2  * README.android describes in high-level the LLVM changes that we cannot push
   3  * upstream to the llvm.org repository:
   4  *  - Changes due to Android's build system.
   5  *  - Changes due to Android's toolchain.
   6  *  - Changes due to the limitations in Android-based consumer electronics.
   7  *
   8  * Some of them are to-dos. If and when they are done, there will no longer be
   9  * merge conflicts with upstream on those parts.
  10  *
  11  * The file contains useful hints when we try to resolve future 3-way merge
  12  * conflicts.
  13  */
  14
  15 * For Honeycomb: Synced to upstream r112344.
  16 * For Honeycomb MR1: Synced to upstream r119309
  17 * For Honeycomb MR2: Synced to upstream r119309
  18 * For Ice Cream Sandwich: Synced to upstream r133718
  19
  20 * Recent update #1: From r133240 to 133718
  21 * Recent update #2: From r129128 to 133240
  22 * Recent update #3: From r127116 to 129128
  23 * Recent update #4: From r119309 to 127116
  24
  25 * We add 40+ Android's *.mk files that are specific to Android's build system.
  26
  27 * All the configuration files because we don't have configure/make/make-install
  28
  29 * Changes for enabling both host and device builds.
  30
  31 * All the tblgen work to enable Android to build a generator-generator binary
  32   and then run it in the middle of Android build process.
  33
  34 * Explicitly include <cctype> header since is*() are not builtin functions in
  35 Android toolchain.
  36
  37 * Code changes to make Android's toolchain stop outputting warnings. (This part
  38   should be pushed upstream eventually.)
  39
  40 * lib/Target/{X86,ARM}/AsmPrinter/{X86,ARM}AsmPrinter.cpp
  41    Move from lib/Target/{X86,ARM}/{X86,ARM}AsmPrinter.cpp.
  42    AsmPrinter is only needed in Android when disassembly functionality
  43       is desired to be included.
  44
  45 * Our ARM code generation fixes that upstream hasn't accepted yet. (This
  46   conflict will be resolved eventually, but there will always be time lag.)
  47
  48 * Assorted size optimizations because Android-based consumer electronics
  49   need them.