docs/UserGuides.rst

   1 User Guides\r
   2 ===========\r
   3 \r
   4 For those new to the LLVM system.\r
   5 \r
   6 NOTE: If you are a user who is only interested in using an LLVM-based compiler,\r
   7 you should look into `Clang <http://clang.llvm.org>`_ instead. The\r
   8 documentation here is intended for users who have a need to work with the\r
   9 intermediate LLVM representation.\r
  10 \r
  11 .. toctree::\r
  12    :hidden:\r
  13 \r
  14    CMake\r
  15    CMakePrimer\r
  16    AdvancedBuilds\r
  17    HowToBuildOnARM\r
  18    HowToBuildWithPGO\r
  19    HowToCrossCompileBuiltinsOnArm\r
  20    HowToCrossCompileLLVM\r
  21    yaml2obj\r
  22    MarkdownQuickstartTemplate\r
  23    Phabricator\r
  24    Passes\r
  25    YamlIO\r
  26    GetElementPtr\r
  27    Frontend/PerformanceTips\r
  28    MCJITDesignAndImplementation\r
  29    ORCv2\r
  30    CodeOfConduct\r
  31    CompileCudaWithLLVM\r
  32    ReportingGuide\r
  33    Benchmarking\r
  34    Docker\r
  35    BuildingADistribution\r
  36    Remarks\r
  37 \r
  38 :doc:`CMake`\r
  39    An addendum to the main Getting Started guide for those using the `CMake\r
  40    build system <http://www.cmake.org>`_.\r
  41 \r
  42 :doc:`HowToBuildOnARM`\r
  43    Notes on building and testing LLVM/Clang on ARM.\r
  44 \r
  45 :doc:`HowToBuildWithPGO`\r
  46     Notes on building LLVM/Clang with PGO.\r
  47 \r
  48 :doc:`HowToCrossCompileBuiltinsOnArm`\r
  49    Notes on cross-building and testing the compiler-rt builtins for Arm.\r
  50 \r
  51 :doc:`HowToCrossCompileLLVM`\r
  52    Notes on cross-building and testing LLVM/Clang.\r
  53 \r
  54 :doc:`Passes`\r
  55    A list of optimizations and analyses implemented in LLVM.\r
  56 \r
  57 :doc:`TestSuiteGuide`\r
  58   Describes how to compile and run the test-suite benchmarks.\r
  59 \r
  60 `How to build the C, C++, ObjC, and ObjC++ front end`__\r
  61    Instructions for building the clang front-end from source.\r
  62 \r
  63    .. __: http://clang.llvm.org/get_started.html\r
  64 \r
  65 :doc:`YamlIO`\r
  66    A reference guide for using LLVM's YAML I/O library.\r
  67 \r
  68 :doc:`GetElementPtr`\r
  69   Answers to some very frequent questions about LLVM's most frequently\r
  70   misunderstood instruction.\r
  71 \r
  72 :doc:`Frontend/PerformanceTips`\r
  73    A collection of tips for frontend authors on how to generate IR\r
  74    which LLVM is able to effectively optimize.\r
  75 \r
  76 :doc:`Docker`\r
  77    A reference for using Dockerfiles provided with LLVM.\r
  78 \r
  79 :doc:`BuildingADistribution`\r
  80   A best-practices guide for using LLVM's CMake build system to package and\r
  81   distribute LLVM-based tools.\r
  82 \r
  83 :doc:`Remarks`\r
  84    A reference on the implementation of remarks in LLVM.