Make the indirect branch optimization deterministic. No functionality change.
[oota-llvm.git] / docs / userguides.rst
1 .. _userguides:
2
3 User Guides
4 ===========
5
6 .. toctree::
7    :hidden:
8
9    CMake
10    HowToBuildOnARM
11    CommandGuide/index
12    DeveloperPolicy
13    GettingStarted
14    GettingStartedVS
15    FAQ
16    Lexicon
17    Packaging
18    HowToAddABuilder
19    yaml2obj
20    HowToSubmitABug
21    SphinxQuickstartTemplate
22    Phabricator
23
24 * :ref:`getting_started`
25     
26    Discusses how to get up and running quickly with the LLVM infrastructure.
27    Everything from unpacking and compilation of the distribution to execution
28    of some tools.
29     
30 * :ref:`building-with-cmake`
31
32    An addendum to the main Getting Started guide for those using the `CMake
33    build system <http://www.cmake.org>`_.
34
35 * :ref:`how_to_build_on_arm`
36
37    Notes on building and testing LLVM/Clang on ARM.
38
39 * `Getting Started with the LLVM System using Microsoft Visual Studio
40   <GettingStartedVS.html>`_
41
42    An addendum to the main Getting Started guide for those using Visual Studio
43    on Windows.
44     
45 * `LLVM Tutorial <tutorial/>`_
46
47    A walk through the process of using LLVM for a custom language, and the
48    facilities LLVM offers in tutorial form.
49
50 * :ref:`developer_policy`
51
52    The LLVM project's policy towards developers and their contributions.
53
54 * :ref:`LLVM Command Guide <commands>`
55
56    A reference manual for the LLVM command line utilities ("man" pages for LLVM
57    tools).
58     
59 * `LLVM's Analysis and Transform Passes <Passes.html>`_
60
61    A list of optimizations and analyses implemented in LLVM.
62     
63 * :ref:`faq`
64
65    A list of common questions and problems and their solutions.
66     
67 * `Release notes for the current release <ReleaseNotes.html>`_
68
69    This describes new features, known bugs, and other limitations.
70
71 * :ref:`how-to-submit-a-bug-report`
72     
73    Instructions for properly submitting information about any bugs you run into
74    in the LLVM system.
75 * :doc:`SphinxQuickstartTemplate`
76
77   A template + tutorial for writing new Sphinx documentation. It is meant
78   to be read in source form.
79     
80 * `LLVM Testing Infrastructure Guide <TestingGuide.html>`_
81
82    A reference manual for using the LLVM testing infrastructure.
83     
84 * `How to build the C, C++, ObjC, and ObjC++ front end <http://clang.llvm.org/get_started.html>`_
85
86    Instructions for building the clang front-end from source.
87     
88 * :ref:`packaging`
89
90    Advice on packaging LLVM into a distribution.
91     
92 * :ref:`lexicon`
93
94    Definition of acronyms, terms and concepts used in LLVM.
95
96 * :ref:`how_to_add_a_builder`
97
98    Instructions for adding new builder to LLVM buildbot master.
99     
100 * **IRC** -- You can probably find help on the unofficial LLVM IRC.
101
102    We often are on irc.oftc.net in the #llvm channel.  If you are using the
103    mozilla browser, and have chatzilla installed, you can `join #llvm on
104    irc.oftc.net <irc://irc.oftc.net/llvm>`_.