blob: 0d1f3fb46aaed028e768c045585bdaa8f862d344 [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
Bill Wendling5cda9012012-06-20 10:36:41 +000011 Lexicon
Daniel Dunbar17412a02012-05-08 16:50:43 +000012
Bill Wendling81e664b2012-06-20 09:48:38 +000013* `The LLVM Getting Started Guide <GettingStarted.html>`_
Daniel Dunbar21e993c2012-04-19 16:31:37 +000014
Bill Wendling81e664b2012-06-20 09:48:38 +000015 Discusses how to get up and running quickly with the LLVM infrastructure.
16 Everything from unpacking and compilation of the distribution to execution
17 of some tools.
Daniel Dunbar21e993c2012-04-19 16:31:37 +000018
Bill Wendling81e664b2012-06-20 09:48:38 +000019* `LLVM CMake guide <CMake.html>`_
Daniel Dunbar21e993c2012-04-19 16:31:37 +000020
Bill Wendling81e664b2012-06-20 09:48:38 +000021 An addendum to the main Getting Started guide for those using the `CMake
22 build system <http://www.cmake.org>`_.
Daniel Dunbar21e993c2012-04-19 16:31:37 +000023
Bill Wendling81e664b2012-06-20 09:48:38 +000024* `Getting Started with the LLVM System using Microsoft Visual Studio
25 <GettingStartedVS.html>`_
Daniel Dunbar21e993c2012-04-19 16:31:37 +000026
Bill Wendling81e664b2012-06-20 09:48:38 +000027 An addendum to the main Getting Started guide for those using Visual Studio
28 on Windows.
Daniel Dunbar21e993c2012-04-19 16:31:37 +000029
Bill Wendling81e664b2012-06-20 09:48:38 +000030* `LLVM Tutorial <tutorial/>`_
Daniel Dunbar21e993c2012-04-19 16:31:37 +000031
Bill Wendling81e664b2012-06-20 09:48:38 +000032 A walk through the process of using LLVM for a custom language, and the
33 facilities LLVM offers in tutorial form.
Daniel Dunbar21e993c2012-04-19 16:31:37 +000034
Bill Wendling81e664b2012-06-20 09:48:38 +000035* `Developer Policy <DeveloperPolicy.html>`_
Daniel Dunbar21e993c2012-04-19 16:31:37 +000036
Bill Wendling81e664b2012-06-20 09:48:38 +000037 The LLVM project's policy towards developers and their contributions.
Daniel Dunbar17412a02012-05-08 16:50:43 +000038
Bill Wendling81e664b2012-06-20 09:48:38 +000039* :ref:`LLVM Command Guide <commands>`
Daniel Dunbar21e993c2012-04-19 16:31:37 +000040
Bill Wendling81e664b2012-06-20 09:48:38 +000041 A reference manual for the LLVM command line utilities ("man" pages for LLVM
42 tools).
Daniel Dunbar21e993c2012-04-19 16:31:37 +000043
Bill Wendling81e664b2012-06-20 09:48:38 +000044* `LLVM's Analysis and Transform Passes <Passes.html>`_
Daniel Dunbar21e993c2012-04-19 16:31:37 +000045
Bill Wendling81e664b2012-06-20 09:48:38 +000046 A list of optimizations and analyses implemented in LLVM.
Daniel Dunbar21e993c2012-04-19 16:31:37 +000047
Bill Wendling81e664b2012-06-20 09:48:38 +000048* :ref:`faq`
Daniel Dunbar21e993c2012-04-19 16:31:37 +000049
Bill Wendling81e664b2012-06-20 09:48:38 +000050 A list of common questions and problems and their solutions.
Daniel Dunbar21e993c2012-04-19 16:31:37 +000051
Bill Wendling81e664b2012-06-20 09:48:38 +000052* `Release notes for the current release <ReleaseNotes.html>`_
Daniel Dunbar21e993c2012-04-19 16:31:37 +000053
Bill Wendling81e664b2012-06-20 09:48:38 +000054 This describes new features, known bugs, and other limitations.
Daniel Dunbar21e993c2012-04-19 16:31:37 +000055
Bill Wendling81e664b2012-06-20 09:48:38 +000056* `How to Submit A Bug Report <HowToSubmitABug.html>`_
Daniel Dunbar21e993c2012-04-19 16:31:37 +000057
Bill Wendling81e664b2012-06-20 09:48:38 +000058 Instructions for properly submitting information about any bugs you run into
59 in the LLVM system.
Daniel Dunbar21e993c2012-04-19 16:31:37 +000060
Bill Wendling81e664b2012-06-20 09:48:38 +000061* `LLVM Testing Infrastructure Guide <TestingGuide.html>`_
Daniel Dunbar21e993c2012-04-19 16:31:37 +000062
Bill Wendling81e664b2012-06-20 09:48:38 +000063 A reference manual for using the LLVM testing infrastructure.
Daniel Dunbar21e993c2012-04-19 16:31:37 +000064
Bill Wendling81e664b2012-06-20 09:48:38 +000065* `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 +000066
Bill Wendling81e664b2012-06-20 09:48:38 +000067 Instructions for building the clang front-end from source.
Daniel Dunbar21e993c2012-04-19 16:31:37 +000068
Bill Wendling81e664b2012-06-20 09:48:38 +000069* `Packaging guide <Packaging.html>`_
Daniel Dunbar21e993c2012-04-19 16:31:37 +000070
Bill Wendling81e664b2012-06-20 09:48:38 +000071 Advice on packaging LLVM into a distribution.
Daniel Dunbar21e993c2012-04-19 16:31:37 +000072
Bill Wendling5cda9012012-06-20 10:36:41 +000073* :ref:`lexicon`
Daniel Dunbar21e993c2012-04-19 16:31:37 +000074
Bill Wendling81e664b2012-06-20 09:48:38 +000075 Definition of acronyms, terms and concepts used in LLVM.
Daniel Dunbar21e993c2012-04-19 16:31:37 +000076
Bill Wendling81e664b2012-06-20 09:48:38 +000077* `How To Add Your Build Configuration To LLVM Buildbot Infrastructure <HowToAddABuilder.html>`_
Daniel Dunbar21e993c2012-04-19 16:31:37 +000078
Bill Wendling81e664b2012-06-20 09:48:38 +000079 Instructions for adding new builder to LLVM buildbot master.
Daniel Dunbar21e993c2012-04-19 16:31:37 +000080
Bill Wendling81e664b2012-06-20 09:48:38 +000081* **IRC** -- You can probably find help on the unofficial LLVM IRC.
Daniel Dunbar21e993c2012-04-19 16:31:37 +000082
Bill Wendling81e664b2012-06-20 09:48:38 +000083 We often are on irc.oftc.net in the #llvm channel. If you are using the
84 mozilla browser, and have chatzilla installed, you can `join #llvm on
85 irc.oftc.net <irc://irc.oftc.net/llvm>`_.