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