Daniel Dunbar | fbb8041 | 2012-04-19 16:31:37 +0000 | [diff] [blame] | 1 | Overview |
| 2 | ======== |
| 3 | |
| 4 | .. warning:: |
| 5 | |
| 6 | If you are using a released version of LLVM, see `the download page |
| 7 | <http://llvm.org/releases/>`_ to find your documentation. |
| 8 | |
| 9 | The LLVM compiler infrastructure supports a wide range of projects, from |
| 10 | industrial strength compilers to specialized JIT applications to small |
| 11 | research projects. |
| 12 | |
| 13 | Similarly, documentation is broken down into several high-level groupings |
Benjamin Kramer | bde9176 | 2012-06-02 10:20:22 +0000 | [diff] [blame] | 14 | targeted at different audiences: |
Daniel Dunbar | fbb8041 | 2012-04-19 16:31:37 +0000 | [diff] [blame] | 15 | |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 16 | LLVM Design & Overview |
| 17 | ====================== |
Daniel Dunbar | fbb8041 | 2012-04-19 16:31:37 +0000 | [diff] [blame] | 18 | |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 19 | Several introductory papers and presentations. |
Daniel Dunbar | fbb8041 | 2012-04-19 16:31:37 +0000 | [diff] [blame] | 20 | |
| 21 | .. toctree:: |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 22 | :hidden: |
Daniel Dunbar | fbb8041 | 2012-04-19 16:31:37 +0000 | [diff] [blame] | 23 | |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 24 | LangRef |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 25 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 26 | :doc:`LangRef` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 27 | Defines the LLVM intermediate representation. |
| 28 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 29 | `Introduction to the LLVM Compiler`__ |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 30 | Presentation providing a users introduction to LLVM. |
| 31 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 32 | .. __: http://llvm.org/pubs/2008-10-04-ACAT-LLVM-Intro.html |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 33 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 34 | `Intro to LLVM`__ |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 35 | Book chapter providing a compiler hacker's introduction to LLVM. |
| 36 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 37 | .. __: http://www.aosabook.org/en/llvm.html |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 38 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 39 | |
| 40 | `LLVM: A Compilation Framework for Lifelong Program Analysis & Transformation`__ |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 41 | Design overview. |
| 42 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 43 | .. __: http://llvm.org/pubs/2004-01-30-CGO-LLVM.html |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 44 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 45 | `LLVM: An Infrastructure for Multi-Stage Optimization`__ |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 46 | More details (quite old now). |
| 47 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 48 | .. __: http://llvm.org/pubs/2002-12-LattnerMSThesis.html |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 49 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 50 | `Publications mentioning LLVM <http://llvm.org/pubs>`_ |
| 51 | .. |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 52 | |
| 53 | User Guides |
| 54 | =========== |
| 55 | |
| 56 | For those new to the LLVM system. |
| 57 | |
| 58 | NOTE: If you are a user who is only interested in using LLVM-based |
| 59 | compilers, you should look into `Clang <http://clang.llvm.org>`_ or |
| 60 | `DragonEgg <http://dragonegg.llvm.org>`_ instead. The documentation here is |
| 61 | intended for users who have a need to work with the intermediate LLVM |
| 62 | representation. |
| 63 | |
| 64 | .. toctree:: |
| 65 | :hidden: |
| 66 | |
| 67 | CMake |
| 68 | HowToBuildOnARM |
| 69 | CommandGuide/index |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 70 | GettingStarted |
| 71 | GettingStartedVS |
| 72 | FAQ |
| 73 | Lexicon |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 74 | HowToAddABuilder |
| 75 | yaml2obj |
| 76 | HowToSubmitABug |
| 77 | SphinxQuickstartTemplate |
| 78 | Phabricator |
| 79 | TestingGuide |
| 80 | tutorial/index |
| 81 | ReleaseNotes |
| 82 | Passes |
| 83 | YamlIO |
Sean Silva | 163b5c4 | 2013-03-30 15:32:50 +0000 | [diff] [blame] | 84 | GetElementPtr |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 85 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 86 | :doc:`GettingStarted` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 87 | Discusses how to get up and running quickly with the LLVM infrastructure. |
| 88 | Everything from unpacking and compilation of the distribution to execution |
| 89 | of some tools. |
| 90 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 91 | :doc:`CMake` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 92 | An addendum to the main Getting Started guide for those using the `CMake |
| 93 | build system <http://www.cmake.org>`_. |
| 94 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 95 | :doc:`HowToBuildOnARM` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 96 | Notes on building and testing LLVM/Clang on ARM. |
| 97 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 98 | :doc:`GettingStartedVS` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 99 | An addendum to the main Getting Started guide for those using Visual Studio |
| 100 | on Windows. |
| 101 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 102 | :doc:`tutorial/index` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 103 | Tutorials about using LLVM. Includes a tutorial about making a custom |
| 104 | language with LLVM. |
| 105 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 106 | :doc:`LLVM Command Guide <CommandGuide/index>` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 107 | A reference manual for the LLVM command line utilities ("man" pages for LLVM |
| 108 | tools). |
| 109 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 110 | :doc:`Passes` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 111 | A list of optimizations and analyses implemented in LLVM. |
| 112 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 113 | :doc:`FAQ` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 114 | A list of common questions and problems and their solutions. |
| 115 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 116 | :doc:`Release notes for the current release <ReleaseNotes>` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 117 | This describes new features, known bugs, and other limitations. |
| 118 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 119 | :doc:`HowToSubmitABug` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 120 | Instructions for properly submitting information about any bugs you run into |
| 121 | in the LLVM system. |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 122 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 123 | :doc:`SphinxQuickstartTemplate` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 124 | A template + tutorial for writing new Sphinx documentation. It is meant |
| 125 | to be read in source form. |
| 126 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 127 | :doc:`LLVM Testing Infrastructure Guide <TestingGuide>` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 128 | A reference manual for using the LLVM testing infrastructure. |
| 129 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 130 | `How to build the C, C++, ObjC, and ObjC++ front end`__ |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 131 | Instructions for building the clang front-end from source. |
| 132 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 133 | .. __: http://clang.llvm.org/get_started.html |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 134 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 135 | :doc:`Lexicon` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 136 | Definition of acronyms, terms and concepts used in LLVM. |
| 137 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 138 | :doc:`HowToAddABuilder` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 139 | Instructions for adding new builder to LLVM buildbot master. |
| 140 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 141 | :doc:`YamlIO` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 142 | A reference guide for using LLVM's YAML I/O library. |
| 143 | |
Sean Silva | 163b5c4 | 2013-03-30 15:32:50 +0000 | [diff] [blame] | 144 | :doc:`GetElementPtr` |
| 145 | Answers to some very frequent questions about LLVM's most frequently |
| 146 | misunderstood instruction. |
| 147 | |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 148 | Programming Documentation |
| 149 | ========================= |
| 150 | |
| 151 | For developers of applications which use LLVM as a library. |
| 152 | |
| 153 | .. toctree:: |
| 154 | :hidden: |
| 155 | |
| 156 | Atomics |
| 157 | CodingStandards |
| 158 | CommandLine |
| 159 | CompilerWriterInfo |
| 160 | ExtendingLLVM |
| 161 | HowToSetUpLLVMStyleRTTI |
| 162 | ProgrammersManual |
Nico Rieck | 1da4529 | 2013-04-10 23:28:17 +0000 | [diff] [blame] | 163 | Extensions |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 164 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 165 | :doc:`LLVM Language Reference Manual <LangRef>` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 166 | Defines the LLVM intermediate representation and the assembly form of the |
| 167 | different nodes. |
| 168 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 169 | :doc:`Atomics` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 170 | Information about LLVM's concurrency model. |
| 171 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 172 | :doc:`ProgrammersManual` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 173 | Introduction to the general layout of the LLVM sourcebase, important classes |
| 174 | and APIs, and some tips & tricks. |
| 175 | |
Nico Rieck | 1da4529 | 2013-04-10 23:28:17 +0000 | [diff] [blame] | 176 | :doc:`Extensions` |
| 177 | LLVM-specific extensions to tools and formats LLVM seeks compatibility with. |
| 178 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 179 | :doc:`CommandLine` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 180 | Provides information on using the command line parsing library. |
| 181 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 182 | :doc:`CodingStandards` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 183 | Details the LLVM coding standards and provides useful information on writing |
| 184 | efficient C++ code. |
| 185 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 186 | :doc:`HowToSetUpLLVMStyleRTTI` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 187 | How to make ``isa<>``, ``dyn_cast<>``, etc. available for clients of your |
| 188 | class hierarchy. |
| 189 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 190 | :doc:`ExtendingLLVM` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 191 | Look here to see how to add instructions and intrinsics to LLVM. |
| 192 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 193 | `Doxygen generated documentation <http://llvm.org/doxygen/>`_ |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 194 | (`classes <http://llvm.org/doxygen/inherits.html>`_) |
| 195 | (`tarball <http://llvm.org/doxygen/doxygen.tar.gz>`_) |
| 196 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 197 | `ViewVC Repository Browser <http://llvm.org/viewvc/>`_ |
| 198 | .. |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 199 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 200 | :doc:`CompilerWriterInfo` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 201 | A list of helpful links for compiler writers. |
| 202 | |
| 203 | Subsystem Documentation |
| 204 | ======================= |
| 205 | |
| 206 | For API clients and LLVM developers. |
| 207 | |
| 208 | .. toctree:: |
| 209 | :hidden: |
| 210 | |
| 211 | AliasAnalysis |
| 212 | BitCodeFormat |
| 213 | BranchWeightMetadata |
| 214 | Bugpoint |
| 215 | CodeGenerator |
| 216 | ExceptionHandling |
| 217 | LinkTimeOptimization |
| 218 | SegmentedStacks |
| 219 | TableGenFundamentals |
| 220 | DebuggingJITedCode |
| 221 | GoldPlugin |
| 222 | MarkedUpDisassembly |
| 223 | SystemLibrary |
| 224 | SourceLevelDebugging |
| 225 | Vectorizers |
| 226 | WritingAnLLVMBackend |
| 227 | GarbageCollection |
| 228 | WritingAnLLVMPass |
| 229 | TableGen/LangRef |
Joe Abbey | ba3e901 | 2013-02-12 11:45:22 +0000 | [diff] [blame] | 230 | HowToUseAttributes |
Justin Holewinski | 45df882 | 2013-03-30 16:41:14 +0000 | [diff] [blame] | 231 | NVPTXUsage |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 232 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 233 | :doc:`WritingAnLLVMPass` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 234 | Information on how to write LLVM transformations and analyses. |
| 235 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 236 | :doc:`WritingAnLLVMBackend` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 237 | Information on how to write LLVM backends for machine targets. |
| 238 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 239 | :doc:`CodeGenerator` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 240 | The design and implementation of the LLVM code generator. Useful if you are |
| 241 | working on retargetting LLVM to a new architecture, designing a new codegen |
| 242 | pass, or enhancing existing components. |
| 243 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 244 | :doc:`TableGenFundamentals` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 245 | Describes the TableGen tool, which is used heavily by the LLVM code |
| 246 | generator. |
| 247 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 248 | :doc:`AliasAnalysis` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 249 | Information on how to write a new alias analysis implementation or how to |
| 250 | use existing analyses. |
| 251 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 252 | :doc:`GarbageCollection` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 253 | The interfaces source-language compilers should use for compiling GC'd |
| 254 | programs. |
| 255 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 256 | :doc:`Source Level Debugging with LLVM <SourceLevelDebugging>` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 257 | This document describes the design and philosophy behind the LLVM |
| 258 | source-level debugger. |
| 259 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 260 | :doc:`Vectorizers` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 261 | This document describes the current status of vectorization in LLVM. |
| 262 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 263 | :doc:`ExceptionHandling` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 264 | This document describes the design and implementation of exception handling |
| 265 | in LLVM. |
| 266 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 267 | :doc:`Bugpoint` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 268 | Automatic bug finder and test-case reducer description and usage |
| 269 | information. |
| 270 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 271 | :doc:`BitCodeFormat` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 272 | This describes the file format and encoding used for LLVM "bc" files. |
| 273 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 274 | :doc:`System Library <SystemLibrary>` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 275 | This document describes the LLVM System Library (``lib/System``) and |
| 276 | how to keep LLVM source code portable |
| 277 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 278 | :doc:`LinkTimeOptimization` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 279 | This document describes the interface between LLVM intermodular optimizer |
| 280 | and the linker and its design |
| 281 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 282 | :doc:`GoldPlugin` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 283 | How to build your programs with link-time optimization on Linux. |
| 284 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 285 | :doc:`DebuggingJITedCode` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 286 | How to debug JITed code with GDB. |
| 287 | |
Andrew Kaylor | 27299c3 | 2013-08-21 22:15:09 +0000 | [diff] [blame^] | 288 | :doc:`MCJITDesignAndImplementation` |
| 289 | Describes the inner workings of MCJIT execution engine. |
| 290 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 291 | :doc:`BranchWeightMetadata` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 292 | Provides information about Branch Prediction Information. |
| 293 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 294 | :doc:`SegmentedStacks` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 295 | This document describes segmented stacks and how they are used in LLVM. |
| 296 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 297 | :doc:`MarkedUpDisassembly` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 298 | This document describes the optional rich disassembly output syntax. |
| 299 | |
Joe Abbey | ba3e901 | 2013-02-12 11:45:22 +0000 | [diff] [blame] | 300 | :doc:`HowToUseAttributes` |
| 301 | Answers some questions about the new Attributes infrastructure. |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 302 | |
Justin Holewinski | 45df882 | 2013-03-30 16:41:14 +0000 | [diff] [blame] | 303 | :doc:`NVPTXUsage` |
| 304 | This document describes using the NVPTX back-end to compile GPU kernels. |
| 305 | |
| 306 | |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 307 | Development Process Documentation |
| 308 | ================================= |
| 309 | |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 310 | Information about LLVM's development process. |
| 311 | |
| 312 | .. toctree:: |
| 313 | :hidden: |
| 314 | |
Sean Silva | 9d205c8 | 2013-03-30 15:32:47 +0000 | [diff] [blame] | 315 | DeveloperPolicy |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 316 | MakefileGuide |
| 317 | Projects |
| 318 | LLVMBuild |
| 319 | HowToReleaseLLVM |
Sean Silva | bdb940f | 2013-01-28 21:28:10 +0000 | [diff] [blame] | 320 | Packaging |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 321 | |
Sean Silva | 9d205c8 | 2013-03-30 15:32:47 +0000 | [diff] [blame] | 322 | :doc:`DeveloperPolicy` |
| 323 | The LLVM project's policy towards developers and their contributions. |
| 324 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 325 | :doc:`Projects` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 326 | How-to guide and templates for new projects that *use* the LLVM |
| 327 | infrastructure. The templates (directory organization, Makefiles, and test |
| 328 | tree) allow the project code to be located outside (or inside) the ``llvm/`` |
| 329 | tree, while using LLVM header files and libraries. |
| 330 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 331 | :doc:`LLVMBuild` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 332 | Describes the LLVMBuild organization and files used by LLVM to specify |
| 333 | component descriptions. |
| 334 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 335 | :doc:`MakefileGuide` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 336 | Describes how the LLVM makefiles work and how to use them. |
| 337 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 338 | :doc:`HowToReleaseLLVM` |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 339 | This is a guide to preparing LLVM releases. Most developers can ignore it. |
| 340 | |
Renato Golin | c08f218 | 2013-05-28 10:32:55 +0000 | [diff] [blame] | 341 | :doc:`ReleaseProcess` |
| 342 | This is a validate a new release, during the release process. Most developers can ignore it. |
| 343 | |
Sean Silva | bdb940f | 2013-01-28 21:28:10 +0000 | [diff] [blame] | 344 | :doc:`Packaging` |
| 345 | Advice on packaging LLVM into a distribution. |
| 346 | |
Sean Silva | 0129924 | 2013-03-30 15:32:51 +0000 | [diff] [blame] | 347 | Community |
| 348 | ========= |
| 349 | |
| 350 | LLVM has a thriving community of friendly and helpful developers. |
| 351 | The two primary communication mechanisms in the LLVM community are mailing |
| 352 | lists and IRC. |
| 353 | |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 354 | Mailing Lists |
Sean Silva | 0129924 | 2013-03-30 15:32:51 +0000 | [diff] [blame] | 355 | ------------- |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 356 | |
| 357 | If you can't find what you need in these docs, try consulting the mailing |
| 358 | lists. |
| 359 | |
Sean Silva | ab4997d | 2013-03-30 15:33:01 +0000 | [diff] [blame] | 360 | `Developer's List (llvmdev)`__ |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 361 | This list is for people who want to be included in technical discussions of |
| 362 | LLVM. People post to this list when they have questions about writing code |
| 363 | for or using the LLVM tools. It is relatively low volume. |
| 364 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 365 | .. __: http://lists.cs.uiuc.edu/mailman/listinfo/llvmdev |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 366 | |
Sean Silva | ab4997d | 2013-03-30 15:33:01 +0000 | [diff] [blame] | 367 | `Commits Archive (llvm-commits)`__ |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 368 | This list contains all commit messages that are made when LLVM developers |
Sean Silva | 2a74699 | 2013-03-30 15:33:02 +0000 | [diff] [blame] | 369 | commit code changes to the repository. It also serves as a forum for |
| 370 | patch review (i.e. send patches here). It is useful for those who want to |
| 371 | stay on the bleeding edge of LLVM development. This list is very high |
| 372 | volume. |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 373 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 374 | .. __: http://lists.cs.uiuc.edu/pipermail/llvm-commits/ |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 375 | |
Sean Silva | ab4997d | 2013-03-30 15:33:01 +0000 | [diff] [blame] | 376 | `Bugs & Patches Archive (llvmbugs)`__ |
Sean Silva | 2a74699 | 2013-03-30 15:33:02 +0000 | [diff] [blame] | 377 | This list gets emailed every time a bug is opened and closed. It is |
| 378 | higher volume than the LLVMdev list. |
Sean Silva | 84b296c | 2013-03-30 15:32:54 +0000 | [diff] [blame] | 379 | |
| 380 | .. __: http://lists.cs.uiuc.edu/pipermail/llvmbugs/ |
| 381 | |
Sean Silva | ab4997d | 2013-03-30 15:33:01 +0000 | [diff] [blame] | 382 | `Test Results Archive (llvm-testresults)`__ |
Sean Silva | 12159ff | 2013-01-20 02:19:36 +0000 | [diff] [blame] | 383 | A message is automatically sent to this list by every active nightly tester |
| 384 | when it completes. As such, this list gets email several times each day, |
| 385 | making it a high volume list. |
| 386 | |
Sean Silva | 9d0eb94 | 2013-01-20 02:19:42 +0000 | [diff] [blame] | 387 | .. __: http://lists.cs.uiuc.edu/pipermail/llvm-testresults/ |
| 388 | |
Sean Silva | ab4997d | 2013-03-30 15:33:01 +0000 | [diff] [blame] | 389 | `LLVM Announcements List (llvm-announce)`__ |
Sean Silva | 84b296c | 2013-03-30 15:32:54 +0000 | [diff] [blame] | 390 | This is a low volume list that provides important announcements regarding |
| 391 | LLVM. It gets email about once a month. |
| 392 | |
| 393 | .. __: http://lists.cs.uiuc.edu/mailman/listinfo/llvm-announce |
| 394 | |
Sean Silva | 0129924 | 2013-03-30 15:32:51 +0000 | [diff] [blame] | 395 | IRC |
| 396 | --- |
| 397 | |
| 398 | Users and developers of the LLVM project (including subprojects such as Clang) |
| 399 | can be found in #llvm on `irc.oftc.net <irc://irc.oftc.net/llvm>`_. |
| 400 | |
| 401 | This channel has several bots. |
| 402 | |
| 403 | * Buildbot reporters |
| 404 | |
| 405 | * llvmbb - Bot for the main LLVM buildbot master. |
| 406 | http://lab.llvm.org:8011/console |
| 407 | * bb-chapuni - An individually run buildbot master. http://bb.pgr.jp/console |
| 408 | * smooshlab - Apple's internal buildbot master. |
| 409 | |
| 410 | * robot - Bugzilla linker. %bug <number> |
| 411 | |
| 412 | * clang-bot - A `geordi <http://www.eelis.net/geordi/>`_ instance running |
| 413 | near-trunk clang instead of gcc. |
| 414 | |
| 415 | |
Daniel Dunbar | fbb8041 | 2012-04-19 16:31:37 +0000 | [diff] [blame] | 416 | Indices and tables |
| 417 | ================== |
| 418 | |
| 419 | * :ref:`genindex` |
| 420 | * :ref:`search` |