blob: c0a4356b0e151685dbe0bf73b2e1dea2da19f117 [file] [log] [blame]
Micah Villmoweb9c0d02012-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 Wendling954e4302012-10-07 07:10:13 +000013 GettingStarted
Micah Villmoweb9c0d02012-09-27 17:51:02 +000014 GettingStartedVS
15 FAQ
16 Lexicon
17 Packaging
18 HowToAddABuilder
19 yaml2obj
Sean Silvab0a1edc2012-09-25 20:52:04 +000020 HowToSubmitABug
Sean Silvad91ff4c2012-10-12 00:53:48 +000021 SphinxQuickstartTemplate
Sean Silvab39f47b2012-10-12 01:21:24 +000022 Phabricator
Sean Silvaa89edf62012-11-14 21:09:30 +000023 TestingGuide
Sean Silvaf75e74f2012-12-04 21:16:41 +000024 tutorial/index
Dmitri Gribenko38782b82012-12-09 23:14:26 +000025 ReleaseNotes
Dmitri Gribenko11ffe2c2012-12-12 17:02:44 +000026 Passes
Nick Kledzikf60a9272012-12-12 20:46:15 +000027 YamlIO
Micah Villmoweb9c0d02012-09-27 17:51:02 +000028
Bill Wendling954e4302012-10-07 07:10:13 +000029* :ref:`getting_started`
Micah Villmoweb9c0d02012-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 Silva8f146422012-12-04 21:16:34 +000044* :doc:`GettingStartedVS`
Micah Villmoweb9c0d02012-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 Silvaf75e74f2012-12-04 21:16:41 +000049* :doc:`tutorial/index`
Micah Villmoweb9c0d02012-09-27 17:51:02 +000050
Sean Silva216ff2f2013-01-11 01:54:16 +000051 Tutorials about using LLVM. Includes a tutorial about making a custom
52 language with LLVM.
Micah Villmoweb9c0d02012-09-27 17:51:02 +000053
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 Gribenko11ffe2c2012-12-12 17:02:44 +000063* :doc:`Passes`
Micah Villmoweb9c0d02012-09-27 17:51:02 +000064
65 A list of optimizations and analyses implemented in LLVM.
Dmitri Gribenko11ffe2c2012-12-12 17:02:44 +000066
Micah Villmoweb9c0d02012-09-27 17:51:02 +000067* :ref:`faq`
68
69 A list of common questions and problems and their solutions.
70
Dmitri Gribenko38782b82012-12-09 23:14:26 +000071* :doc:`Release notes for the current release <ReleaseNotes>`
Micah Villmoweb9c0d02012-09-27 17:51:02 +000072
73 This describes new features, known bugs, and other limitations.
74
Sean Silvab0a1edc2012-09-25 20:52:04 +000075* :ref:`how-to-submit-a-bug-report`
Micah Villmoweb9c0d02012-09-27 17:51:02 +000076
77 Instructions for properly submitting information about any bugs you run into
78 in the LLVM system.
Sean Silvad91ff4c2012-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 Villmoweb9c0d02012-09-27 17:51:02 +000083
Sean Silvaa89edf62012-11-14 21:09:30 +000084* :doc:`LLVM Testing Infrastructure Guide <TestingGuide>`
Micah Villmoweb9c0d02012-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 Kledzikf60a9272012-12-12 20:46:15 +0000104* :ref:`yamlio`
105
106 A reference guide for using LLVM's YAML I/O library.
107
Micah Villmoweb9c0d02012-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>`_.