blob: 3e8fb4cb8552ff2c685be73872b70536d2a38d0d [file] [log] [blame]
Daniel Dunbar21e993c2012-04-19 16:31:37 +00001.. _userguides:
2
3User Guides
4===========
5
Daniel Dunbar17412a02012-05-08 16:50:43 +00006.. toctree::
7 :hidden:
8
9 CommandGuide/index
Michael J. Spencer0ed5cf42012-06-18 20:21:38 +000010 FAQ
Daniel Dunbar17412a02012-05-08 16:50:43 +000011
Bill Wendling81e664b2012-06-20 09:48:38 +000012* `The LLVM Getting Started Guide <GettingStarted.html>`_
Daniel Dunbar21e993c2012-04-19 16:31:37 +000013
Bill Wendling81e664b2012-06-20 09:48:38 +000014 Discusses how to get up and running quickly with the LLVM infrastructure.
15 Everything from unpacking and compilation of the distribution to execution
16 of some tools.
Daniel Dunbar21e993c2012-04-19 16:31:37 +000017
Bill Wendling81e664b2012-06-20 09:48:38 +000018* `LLVM CMake guide <CMake.html>`_
Daniel Dunbar21e993c2012-04-19 16:31:37 +000019
Bill Wendling81e664b2012-06-20 09:48:38 +000020 An addendum to the main Getting Started guide for those using the `CMake
21 build system <http://www.cmake.org>`_.
Daniel Dunbar21e993c2012-04-19 16:31:37 +000022
Bill Wendling81e664b2012-06-20 09:48:38 +000023* `Getting Started with the LLVM System using Microsoft Visual Studio
24 <GettingStartedVS.html>`_
Daniel Dunbar21e993c2012-04-19 16:31:37 +000025
Bill Wendling81e664b2012-06-20 09:48:38 +000026 An addendum to the main Getting Started guide for those using Visual Studio
27 on Windows.
Daniel Dunbar21e993c2012-04-19 16:31:37 +000028
Bill Wendling81e664b2012-06-20 09:48:38 +000029* `LLVM Tutorial <tutorial/>`_
Daniel Dunbar21e993c2012-04-19 16:31:37 +000030
Bill Wendling81e664b2012-06-20 09:48:38 +000031 A walk through the process of using LLVM for a custom language, and the
32 facilities LLVM offers in tutorial form.
Daniel Dunbar21e993c2012-04-19 16:31:37 +000033
Bill Wendling81e664b2012-06-20 09:48:38 +000034* `Developer Policy <DeveloperPolicy.html>`_
Daniel Dunbar21e993c2012-04-19 16:31:37 +000035
Bill Wendling81e664b2012-06-20 09:48:38 +000036 The LLVM project's policy towards developers and their contributions.
Daniel Dunbar17412a02012-05-08 16:50:43 +000037
Bill Wendling81e664b2012-06-20 09:48:38 +000038* :ref:`LLVM Command Guide <commands>`
Daniel Dunbar21e993c2012-04-19 16:31:37 +000039
Bill Wendling81e664b2012-06-20 09:48:38 +000040 A reference manual for the LLVM command line utilities ("man" pages for LLVM
41 tools).
Daniel Dunbar21e993c2012-04-19 16:31:37 +000042
Bill Wendling81e664b2012-06-20 09:48:38 +000043* `LLVM's Analysis and Transform Passes <Passes.html>`_
Daniel Dunbar21e993c2012-04-19 16:31:37 +000044
Bill Wendling81e664b2012-06-20 09:48:38 +000045 A list of optimizations and analyses implemented in LLVM.
Daniel Dunbar21e993c2012-04-19 16:31:37 +000046
Bill Wendling81e664b2012-06-20 09:48:38 +000047* :ref:`faq`
Daniel Dunbar21e993c2012-04-19 16:31:37 +000048
Bill Wendling81e664b2012-06-20 09:48:38 +000049 A list of common questions and problems and their solutions.
Daniel Dunbar21e993c2012-04-19 16:31:37 +000050
Bill Wendling81e664b2012-06-20 09:48:38 +000051* `Release notes for the current release <ReleaseNotes.html>`_
Daniel Dunbar21e993c2012-04-19 16:31:37 +000052
Bill Wendling81e664b2012-06-20 09:48:38 +000053 This describes new features, known bugs, and other limitations.
Daniel Dunbar21e993c2012-04-19 16:31:37 +000054
Bill Wendling81e664b2012-06-20 09:48:38 +000055* `How to Submit A Bug Report <HowToSubmitABug.html>`_
Daniel Dunbar21e993c2012-04-19 16:31:37 +000056
Bill Wendling81e664b2012-06-20 09:48:38 +000057 Instructions for properly submitting information about any bugs you run into
58 in the LLVM system.
Daniel Dunbar21e993c2012-04-19 16:31:37 +000059
Bill Wendling81e664b2012-06-20 09:48:38 +000060* `LLVM Testing Infrastructure Guide <TestingGuide.html>`_
Daniel Dunbar21e993c2012-04-19 16:31:37 +000061
Bill Wendling81e664b2012-06-20 09:48:38 +000062 A reference manual for using the LLVM testing infrastructure.
Daniel Dunbar21e993c2012-04-19 16:31:37 +000063
Bill Wendling81e664b2012-06-20 09:48:38 +000064* `How to build the C, C++, ObjC, and ObjC++ front end <http://clang.llvm.org/get_started.html>`_
Daniel Dunbar21e993c2012-04-19 16:31:37 +000065
Bill Wendling81e664b2012-06-20 09:48:38 +000066 Instructions for building the clang front-end from source.
Daniel Dunbar21e993c2012-04-19 16:31:37 +000067
Bill Wendling81e664b2012-06-20 09:48:38 +000068* `Packaging guide <Packaging.html>`_
Daniel Dunbar21e993c2012-04-19 16:31:37 +000069
Bill Wendling81e664b2012-06-20 09:48:38 +000070 Advice on packaging LLVM into a distribution.
Daniel Dunbar21e993c2012-04-19 16:31:37 +000071
Bill Wendling81e664b2012-06-20 09:48:38 +000072* `The LLVM Lexicon <Lexicon.html>`_
Daniel Dunbar21e993c2012-04-19 16:31:37 +000073
Bill Wendling81e664b2012-06-20 09:48:38 +000074 Definition of acronyms, terms and concepts used in LLVM.
Daniel Dunbar21e993c2012-04-19 16:31:37 +000075
Bill Wendling81e664b2012-06-20 09:48:38 +000076* `How To Add Your Build Configuration To LLVM Buildbot Infrastructure <HowToAddABuilder.html>`_
Daniel Dunbar21e993c2012-04-19 16:31:37 +000077
Bill Wendling81e664b2012-06-20 09:48:38 +000078 Instructions for adding new builder to LLVM buildbot master.
Daniel Dunbar21e993c2012-04-19 16:31:37 +000079
Bill Wendling81e664b2012-06-20 09:48:38 +000080* **IRC** -- You can probably find help on the unofficial LLVM IRC.
Daniel Dunbar21e993c2012-04-19 16:31:37 +000081
Bill Wendling81e664b2012-06-20 09:48:38 +000082 We often are on irc.oftc.net in the #llvm channel. If you are using the
83 mozilla browser, and have chatzilla installed, you can `join #llvm on
84 irc.oftc.net <irc://irc.oftc.net/llvm>`_.