blob: 7e4e3b7bc099f4f804d179ad3c0657c07e696930 [file] [log] [blame]
Micah Villmow593c0b02012-09-27 17:51:02 +00001.. _userguides:
2
3User Guides
4===========
5
6.. toctree::
7 :hidden:
8
9 CMake
10 HowToBuildOnARM
11 CommandGuide/index
12 DeveloperPolicy
Bill Wendlingf93c55a2012-10-07 07:10:13 +000013 GettingStarted
Micah Villmow593c0b02012-09-27 17:51:02 +000014 GettingStartedVS
15 FAQ
16 Lexicon
17 Packaging
18 HowToAddABuilder
19 yaml2obj
Sean Silva87ed5532012-09-25 20:52:04 +000020 HowToSubmitABug
Sean Silva5d499c22012-10-12 00:53:48 +000021 SphinxQuickstartTemplate
Sean Silvab92dfe02012-10-12 01:21:24 +000022 Phabricator
Sean Silvaac99eed2012-11-14 21:09:30 +000023 TestingGuide
Sean Silva91b97632012-12-04 21:16:41 +000024 tutorial/index
Dmitri Gribenkoe17d8582012-12-09 23:14:26 +000025 ReleaseNotes
Dmitri Gribenkob64f0202012-12-12 17:02:44 +000026 Passes
Nick Kledzik8ceb8b72012-12-12 20:46:15 +000027 YamlIO
Micah Villmow593c0b02012-09-27 17:51:02 +000028
Bill Wendlingf93c55a2012-10-07 07:10:13 +000029* :ref:`getting_started`
Micah Villmow593c0b02012-09-27 17:51:02 +000030
31 Discusses how to get up and running quickly with the LLVM infrastructure.
32 Everything from unpacking and compilation of the distribution to execution
33 of some tools.
34
35* :ref:`building-with-cmake`
36
37 An addendum to the main Getting Started guide for those using the `CMake
38 build system <http://www.cmake.org>`_.
39
40* :ref:`how_to_build_on_arm`
41
42 Notes on building and testing LLVM/Clang on ARM.
43
Sean Silva16935832012-12-04 21:16:34 +000044* :doc:`GettingStartedVS`
Micah Villmow593c0b02012-09-27 17:51:02 +000045
46 An addendum to the main Getting Started guide for those using Visual Studio
47 on Windows.
48
Sean Silva91b97632012-12-04 21:16:41 +000049* :doc:`tutorial/index`
Micah Villmow593c0b02012-09-27 17:51:02 +000050
51 A walk through the process of using LLVM for a custom language, and the
52 facilities LLVM offers in tutorial form.
53
54* :ref:`developer_policy`
55
56 The LLVM project's policy towards developers and their contributions.
57
58* :ref:`LLVM Command Guide <commands>`
59
60 A reference manual for the LLVM command line utilities ("man" pages for LLVM
61 tools).
62
Dmitri Gribenkob64f0202012-12-12 17:02:44 +000063* :doc:`Passes`
Micah Villmow593c0b02012-09-27 17:51:02 +000064
65 A list of optimizations and analyses implemented in LLVM.
Dmitri Gribenkob64f0202012-12-12 17:02:44 +000066
Micah Villmow593c0b02012-09-27 17:51:02 +000067* :ref:`faq`
68
69 A list of common questions and problems and their solutions.
70
Dmitri Gribenkoe17d8582012-12-09 23:14:26 +000071* :doc:`Release notes for the current release <ReleaseNotes>`
Micah Villmow593c0b02012-09-27 17:51:02 +000072
73 This describes new features, known bugs, and other limitations.
74
Sean Silva87ed5532012-09-25 20:52:04 +000075* :ref:`how-to-submit-a-bug-report`
Micah Villmow593c0b02012-09-27 17:51:02 +000076
77 Instructions for properly submitting information about any bugs you run into
78 in the LLVM system.
Sean Silva5d499c22012-10-12 00:53:48 +000079* :doc:`SphinxQuickstartTemplate`
80
81 A template + tutorial for writing new Sphinx documentation. It is meant
82 to be read in source form.
Micah Villmow593c0b02012-09-27 17:51:02 +000083
Sean Silvaac99eed2012-11-14 21:09:30 +000084* :doc:`LLVM Testing Infrastructure Guide <TestingGuide>`
Micah Villmow593c0b02012-09-27 17:51:02 +000085
86 A reference manual for using the LLVM testing infrastructure.
87
88* `How to build the C, C++, ObjC, and ObjC++ front end <http://clang.llvm.org/get_started.html>`_
89
90 Instructions for building the clang front-end from source.
91
92* :ref:`packaging`
93
94 Advice on packaging LLVM into a distribution.
95
96* :ref:`lexicon`
97
98 Definition of acronyms, terms and concepts used in LLVM.
99
100* :ref:`how_to_add_a_builder`
101
102 Instructions for adding new builder to LLVM buildbot master.
103
Nick Kledzik8ceb8b72012-12-12 20:46:15 +0000104* :ref:`yamlio`
105
106 A reference guide for using LLVM's YAML I/O library.
107
Micah Villmow593c0b02012-09-27 17:51:02 +0000108* **IRC** -- You can probably find help on the unofficial LLVM IRC.
109
110 We often are on irc.oftc.net in the #llvm channel. If you are using the
111 mozilla browser, and have chatzilla installed, you can `join #llvm on
112 irc.oftc.net <irc://irc.oftc.net/llvm>`_.