Blame - llvm/docs/index.rst - toolchain/llvm-project

blob: fcdea03c65fafec02f66e1d973220de82b8a2b38 [file] [log] [blame]

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
Renato Golin	d24899b	2013-09-08 20:44:48 +0000	[diff] [blame]	69	HowToCrossCompileLLVM
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	70	CommandGuide/index
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	71	GettingStarted
				72	GettingStartedVS
Chris Bieneman	9f611e3	2015-03-13 01:58:14 +0000	[diff] [blame]	73	BuildingLLVMWithAutotools
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	74	FAQ
				75	Lexicon
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	76	HowToAddABuilder
				77	yaml2obj
				78	HowToSubmitABug
				79	SphinxQuickstartTemplate
				80	Phabricator
				81	TestingGuide
				82	tutorial/index
				83	ReleaseNotes
				84	Passes
				85	YamlIO
Sean Silva	163b5c4	2013-03-30 15:32:50 +0000	[diff] [blame]	86	GetElementPtr
Philip Reames	f8bf9dd	2015-02-27 23:14:50 +0000	[diff] [blame]	87	Frontend/PerformanceTips
Sean Silva	3f93a61	2013-09-09 19:09:00 +0000	[diff] [blame]	88	MCJITDesignAndImplementation
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	89
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	90	:doc:`GettingStarted`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	91	Discusses how to get up and running quickly with the LLVM infrastructure.
				92	Everything from unpacking and compilation of the distribution to execution
				93	of some tools.
				94
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	95	:doc:`CMake`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	96	An addendum to the main Getting Started guide for those using the `CMake
				97	build system <http://www.cmake.org>`_.
				98
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	99	:doc:`HowToBuildOnARM`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	100	Notes on building and testing LLVM/Clang on ARM.
				101
Renato Golin	d24899b	2013-09-08 20:44:48 +0000	[diff] [blame]	102	:doc:`HowToCrossCompileLLVM`
				103	Notes on cross-building and testing LLVM/Clang.
				104
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	105	:doc:`GettingStartedVS`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	106	An addendum to the main Getting Started guide for those using Visual Studio
				107	on Windows.
				108
Chris Bieneman	9f611e3	2015-03-13 01:58:14 +0000	[diff] [blame]	109	:doc:`BuildingLLVMWithAutotools`
				110	An addendum to the Getting Started guide with instructions for building LLVM
				111	with the Autotools build system.
				112
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	113	:doc:`tutorial/index`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	114	Tutorials about using LLVM. Includes a tutorial about making a custom
				115	language with LLVM.
				116
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	117	:doc:`LLVM Command Guide <CommandGuide/index>`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	118	A reference manual for the LLVM command line utilities ("man" pages for LLVM
				119	tools).
				120
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	121	:doc:`Passes`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	122	A list of optimizations and analyses implemented in LLVM.
				123
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	124	:doc:`FAQ`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	125	A list of common questions and problems and their solutions.
				126
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	127	:doc:`Release notes for the current release <ReleaseNotes>`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	128	This describes new features, known bugs, and other limitations.
				129
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	130	:doc:`HowToSubmitABug`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	131	Instructions for properly submitting information about any bugs you run into
				132	in the LLVM system.
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	133
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	134	:doc:`SphinxQuickstartTemplate`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	135	A template + tutorial for writing new Sphinx documentation. It is meant
				136	to be read in source form.
				137
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	138	:doc:`LLVM Testing Infrastructure Guide <TestingGuide>`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	139	A reference manual for using the LLVM testing infrastructure.
				140
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	141	`How to build the C, C++, ObjC, and ObjC++ front end`__
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	142	Instructions for building the clang front-end from source.
				143
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	144	.. __: http://clang.llvm.org/get_started.html
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	145
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	146	:doc:`Lexicon`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	147	Definition of acronyms, terms and concepts used in LLVM.
				148
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	149	:doc:`HowToAddABuilder`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	150	Instructions for adding new builder to LLVM buildbot master.
				151
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	152	:doc:`YamlIO`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	153	A reference guide for using LLVM's YAML I/O library.
				154
Sean Silva	163b5c4	2013-03-30 15:32:50 +0000	[diff] [blame]	155	:doc:`GetElementPtr`
				156	Answers to some very frequent questions about LLVM's most frequently
				157	misunderstood instruction.
				158
Philip Reames	f8bf9dd	2015-02-27 23:14:50 +0000	[diff] [blame]	159	:doc:`Frontend/PerformanceTips`
				160	A collection of tips for frontend authors on how to generate IR
				161	which LLVM is able to effectively optimize.
				162
				163
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	164	Programming Documentation
				165	=========================
				166
				167	For developers of applications which use LLVM as a library.
				168
				169	.. toctree::
				170	:hidden:
				171
				172	Atomics
				173	CodingStandards
				174	CommandLine
				175	CompilerWriterInfo
				176	ExtendingLLVM
				177	HowToSetUpLLVMStyleRTTI
				178	ProgrammersManual
Nico Rieck	1da4529	2013-04-10 23:28:17 +0000	[diff] [blame]	179	Extensions
Kostya Serebryany	35ce863	2015-03-30 23:05:30 +0000	[diff] [blame]	180	LibFuzzer
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	181
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	182	:doc:`LLVM Language Reference Manual <LangRef>`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	183	Defines the LLVM intermediate representation and the assembly form of the
				184	different nodes.
				185
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	186	:doc:`Atomics`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	187	Information about LLVM's concurrency model.
				188
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	189	:doc:`ProgrammersManual`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	190	Introduction to the general layout of the LLVM sourcebase, important classes
				191	and APIs, and some tips & tricks.
				192
Nico Rieck	1da4529	2013-04-10 23:28:17 +0000	[diff] [blame]	193	:doc:`Extensions`
				194	LLVM-specific extensions to tools and formats LLVM seeks compatibility with.
				195
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	196	:doc:`CommandLine`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	197	Provides information on using the command line parsing library.
				198
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	199	:doc:`CodingStandards`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	200	Details the LLVM coding standards and provides useful information on writing
				201	efficient C++ code.
				202
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	203	:doc:`HowToSetUpLLVMStyleRTTI`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	204	How to make ``isa<>``, ``dyn_cast<>``, etc. available for clients of your
				205	class hierarchy.
				206
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	207	:doc:`ExtendingLLVM`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	208	Look here to see how to add instructions and intrinsics to LLVM.
				209
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	210	`Doxygen generated documentation <http://llvm.org/doxygen/>`_
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	211	(`classes <http://llvm.org/doxygen/inherits.html>`_)
				212	(`tarball <http://llvm.org/doxygen/doxygen.tar.gz>`_)
				213
Peter Collingbourne	943d270	2015-01-13 18:49:42 +0000	[diff] [blame]	214	`Documentation for Go bindings <http://godoc.org/llvm.org/llvm/bindings/go/llvm>`_
				215
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	216	`ViewVC Repository Browser <http://llvm.org/viewvc/>`_
				217	..
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	218
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	219	:doc:`CompilerWriterInfo`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	220	A list of helpful links for compiler writers.
				221
Kostya Serebryany	35ce863	2015-03-30 23:05:30 +0000	[diff] [blame]	222	:doc:`LibFuzzer`
				223	A library for writing in-process guided fuzzers.
				224
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	225	Subsystem Documentation
				226	=======================
				227
				228	For API clients and LLVM developers.
				229
				230	.. toctree::
				231	:hidden:
				232
				233	AliasAnalysis
				234	BitCodeFormat
Duncan P. N. Exon Smith	6e40cec	2014-04-11 23:21:07 +0000	[diff] [blame]	235	BlockFrequencyTerminology
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	236	BranchWeightMetadata
				237	Bugpoint
				238	CodeGenerator
				239	ExceptionHandling
				240	LinkTimeOptimization
				241	SegmentedStacks
				242	TableGenFundamentals
Renato Golin	ca10564	2014-03-20 16:08:34 +0000	[diff] [blame]	243	TableGen/index
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	244	DebuggingJITedCode
				245	GoldPlugin
				246	MarkedUpDisassembly
				247	SystemLibrary
				248	SourceLevelDebugging
				249	Vectorizers
				250	WritingAnLLVMBackend
				251	GarbageCollection
				252	WritingAnLLVMPass
Joe Abbey	ba3e901	2013-02-12 11:45:22 +0000	[diff] [blame]	253	HowToUseAttributes
Justin Holewinski	45df882	2013-03-30 16:41:14 +0000	[diff] [blame]	254	NVPTXUsage
Tom Stellard	45bb48e	2015-06-13 03:28:10 +0000	[diff] [blame]	255	AMDGPUUsage
Andrew Trick	5e029ce	2013-12-24 02:57:25 +0000	[diff] [blame]	256	StackMaps
Sean Silva	216f1ee	2014-03-02 00:21:42 +0000	[diff] [blame]	257	InAlloca
James Molloy	3f7878a	2014-05-12 15:13:39 +0000	[diff] [blame]	258	BigEndianNEON
Alex Lorenz	6a12833	2014-08-19 17:05:58 +0000	[diff] [blame]	259	CoverageMappingFormat
Matt Arsenault	03f0e83	2014-12-03 18:35:11 +0000	[diff] [blame]	260	Statepoints
Stepan Dyatkovskiy	f0c3a34	2014-12-10 17:42:01 +0000	[diff] [blame]	261	MergeFunctions
Peter Collingbourne	e6909c8	2015-02-20 20:30:47 +0000	[diff] [blame]	262	BitSets
Sanjoy Das	5553bc8	2015-06-15 19:38:15 +0000	[diff] [blame]	263	FaultMaps
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	264
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	265	:doc:`WritingAnLLVMPass`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	266	Information on how to write LLVM transformations and analyses.
				267
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	268	:doc:`WritingAnLLVMBackend`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	269	Information on how to write LLVM backends for machine targets.
				270
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	271	:doc:`CodeGenerator`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	272	The design and implementation of the LLVM code generator. Useful if you are
				273	working on retargetting LLVM to a new architecture, designing a new codegen
				274	pass, or enhancing existing components.
				275
Sean Silva	0b4df9b	2014-04-07 22:42:53 +0000	[diff] [blame]	276	:doc:`TableGen <TableGen/index>`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	277	Describes the TableGen tool, which is used heavily by the LLVM code
				278	generator.
				279
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	280	:doc:`AliasAnalysis`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	281	Information on how to write a new alias analysis implementation or how to
				282	use existing analyses.
				283
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	284	:doc:`GarbageCollection`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	285	The interfaces source-language compilers should use for compiling GC'd
				286	programs.
				287
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	288	:doc:`Source Level Debugging with LLVM <SourceLevelDebugging>`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	289	This document describes the design and philosophy behind the LLVM
				290	source-level debugger.
				291
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	292	:doc:`Vectorizers`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	293	This document describes the current status of vectorization in LLVM.
				294
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	295	:doc:`ExceptionHandling`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	296	This document describes the design and implementation of exception handling
				297	in LLVM.
				298
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	299	:doc:`Bugpoint`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	300	Automatic bug finder and test-case reducer description and usage
				301	information.
				302
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	303	:doc:`BitCodeFormat`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	304	This describes the file format and encoding used for LLVM "bc" files.
				305
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	306	:doc:`System Library <SystemLibrary>`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	307	This document describes the LLVM System Library (``lib/System``) and
				308	how to keep LLVM source code portable
				309
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	310	:doc:`LinkTimeOptimization`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	311	This document describes the interface between LLVM intermodular optimizer
				312	and the linker and its design
				313
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	314	:doc:`GoldPlugin`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	315	How to build your programs with link-time optimization on Linux.
				316
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	317	:doc:`DebuggingJITedCode`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	318	How to debug JITed code with GDB.
				319
Andrew Kaylor	27299c3	2013-08-21 22:15:09 +0000	[diff] [blame]	320	:doc:`MCJITDesignAndImplementation`
				321	Describes the inner workings of MCJIT execution engine.
				322
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	323	:doc:`BranchWeightMetadata`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	324	Provides information about Branch Prediction Information.
				325
Duncan P. N. Exon Smith	6e40cec	2014-04-11 23:21:07 +0000	[diff] [blame]	326	:doc:`BlockFrequencyTerminology`
				327	Provides information about terminology used in the ``BlockFrequencyInfo``
				328	analysis pass.
				329
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	330	:doc:`SegmentedStacks`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	331	This document describes segmented stacks and how they are used in LLVM.
				332
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	333	:doc:`MarkedUpDisassembly`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	334	This document describes the optional rich disassembly output syntax.
				335
Joe Abbey	ba3e901	2013-02-12 11:45:22 +0000	[diff] [blame]	336	:doc:`HowToUseAttributes`
				337	Answers some questions about the new Attributes infrastructure.
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	338
Justin Holewinski	45df882	2013-03-30 16:41:14 +0000	[diff] [blame]	339	:doc:`NVPTXUsage`
				340	This document describes using the NVPTX back-end to compile GPU kernels.
				341
Tom Stellard	45bb48e	2015-06-13 03:28:10 +0000	[diff] [blame]	342	:doc:`AMDGPUUsage`
				343	This document describes how to use the AMDGPU back-end.
Tom Stellard	9d7ddd5	2014-11-14 14:08:00 +0000	[diff] [blame]	344
Andrew Trick	5e029ce	2013-12-24 02:57:25 +0000	[diff] [blame]	345	:doc:`StackMaps`
				346	LLVM support for mapping instruction addresses to the location of
				347	values and allowing code to be patched.
Justin Holewinski	45df882	2013-03-30 16:41:14 +0000	[diff] [blame]	348
James Molloy	3f7878a	2014-05-12 15:13:39 +0000	[diff] [blame]	349	:doc:`BigEndianNEON`
				350	LLVM's support for generating NEON instructions on big endian ARM targets is
				351	somewhat nonintuitive. This document explains the implementation and rationale.
				352
Alex Lorenz	6a12833	2014-08-19 17:05:58 +0000	[diff] [blame]	353	:doc:`CoverageMappingFormat`
				354	This describes the format and encoding used for LLVM’s code coverage mapping.
James Molloy	3f7878a	2014-05-12 15:13:39 +0000	[diff] [blame]	355
Matt Arsenault	03f0e83	2014-12-03 18:35:11 +0000	[diff] [blame]	356	:doc:`Statepoints`
				357	This describes a set of experimental extensions for garbage
				358	collection support.
				359
Stepan Dyatkovskiy	f0c3a34	2014-12-10 17:42:01 +0000	[diff] [blame]	360	:doc:`MergeFunctions`
				361	Describes functions merging optimization.
				362
Sean Silva	b6472fe	2015-02-04 20:51:19 +0000	[diff] [blame]	363	:doc:`InAlloca`
				364	Description of the ``inalloca`` argument attribute.
				365
Sanjoy Das	5553bc8	2015-06-15 19:38:15 +0000	[diff] [blame]	366	:doc:`FaultMaps`
				367	LLVM support for folding control flow into faulting machine instructions.
				368
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	369	Development Process Documentation
				370	=================================
				371
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	372	Information about LLVM's development process.
				373
				374	.. toctree::
				375	:hidden:
				376
Sean Silva	9d205c8	2013-03-30 15:32:47 +0000	[diff] [blame]	377	DeveloperPolicy
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	378	MakefileGuide
				379	Projects
				380	LLVMBuild
				381	HowToReleaseLLVM
Sean Silva	bdb940f	2013-01-28 21:28:10 +0000	[diff] [blame]	382	Packaging
Sean Silva	3f93a61	2013-09-09 19:09:00 +0000	[diff] [blame]	383	ReleaseProcess
Adrian Prantl	adc41ca	2014-10-03 20:17:32 +0000	[diff] [blame]	384	Phabricator
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	385
Sean Silva	9d205c8	2013-03-30 15:32:47 +0000	[diff] [blame]	386	:doc:`DeveloperPolicy`
				387	The LLVM project's policy towards developers and their contributions.
				388
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	389	:doc:`Projects`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	390	How-to guide and templates for new projects that use the LLVM
				391	infrastructure. The templates (directory organization, Makefiles, and test
				392	tree) allow the project code to be located outside (or inside) the ``llvm/``
				393	tree, while using LLVM header files and libraries.
				394
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	395	:doc:`LLVMBuild`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	396	Describes the LLVMBuild organization and files used by LLVM to specify
				397	component descriptions.
				398
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	399	:doc:`MakefileGuide`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	400	Describes how the LLVM makefiles work and how to use them.
				401
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	402	:doc:`HowToReleaseLLVM`
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	403	This is a guide to preparing LLVM releases. Most developers can ignore it.
				404
Renato Golin	c08f218	2013-05-28 10:32:55 +0000	[diff] [blame]	405	:doc:`ReleaseProcess`
Jyoti Allur	223602d	2014-09-26 06:59:15 +0000	[diff] [blame]	406	This is a guide to validate a new release, during the release process. Most developers can ignore it.
Renato Golin	c08f218	2013-05-28 10:32:55 +0000	[diff] [blame]	407
Sean Silva	bdb940f	2013-01-28 21:28:10 +0000	[diff] [blame]	408	:doc:`Packaging`
				409	Advice on packaging LLVM into a distribution.
				410
Adrian Prantl	adc41ca	2014-10-03 20:17:32 +0000	[diff] [blame]	411	:doc:`Phabricator`
				412	Describes how to use the Phabricator code review tool hosted on
				413	http://reviews.llvm.org/ and its command line interface, Arcanist.
				414
Sean Silva	0129924	2013-03-30 15:32:51 +0000	[diff] [blame]	415	Community
				416	=========
				417
				418	LLVM has a thriving community of friendly and helpful developers.
				419	The two primary communication mechanisms in the LLVM community are mailing
				420	lists and IRC.
				421
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	422	Mailing Lists
Sean Silva	0129924	2013-03-30 15:32:51 +0000	[diff] [blame]	423	-------------
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	424
				425	If you can't find what you need in these docs, try consulting the mailing
				426	lists.
				427
Tanya Lattner	0d28f80	2015-08-05 03:51:17 +0000	[diff] [blame^]	428	`Developer's List (llvm-dev)`__
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	429	This list is for people who want to be included in technical discussions of
				430	LLVM. People post to this list when they have questions about writing code
				431	for or using the LLVM tools. It is relatively low volume.
				432
Tanya Lattner	0d28f80	2015-08-05 03:51:17 +0000	[diff] [blame^]	433	.. __: http://lists.llvm.org/mailman/listinfo/llvm-dev
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	434
Sean Silva	ab4997d	2013-03-30 15:33:01 +0000	[diff] [blame]	435	`Commits Archive (llvm-commits)`__
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	436	This list contains all commit messages that are made when LLVM developers
Sean Silva	2a74699	2013-03-30 15:33:02 +0000	[diff] [blame]	437	commit code changes to the repository. It also serves as a forum for
				438	patch review (i.e. send patches here). It is useful for those who want to
				439	stay on the bleeding edge of LLVM development. This list is very high
				440	volume.
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	441
Tanya Lattner	0d28f80	2015-08-05 03:51:17 +0000	[diff] [blame^]	442	.. __: http://lists.llvm.org/pipermail/llvm-commits/
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	443
Tanya Lattner	0d28f80	2015-08-05 03:51:17 +0000	[diff] [blame^]	444	`Bugs & Patches Archive (llvm-bugs)`__
Sean Silva	2a74699	2013-03-30 15:33:02 +0000	[diff] [blame]	445	This list gets emailed every time a bug is opened and closed. It is
Tanya Lattner	0d28f80	2015-08-05 03:51:17 +0000	[diff] [blame^]	446	higher volume than the LLVM-dev list.
Sean Silva	84b296c	2013-03-30 15:32:54 +0000	[diff] [blame]	447
Tanya Lattner	0d28f80	2015-08-05 03:51:17 +0000	[diff] [blame^]	448	.. __: http://lists.llvm.org/pipermail/llvm-bugs/
Sean Silva	84b296c	2013-03-30 15:32:54 +0000	[diff] [blame]	449
Sean Silva	ab4997d	2013-03-30 15:33:01 +0000	[diff] [blame]	450	`Test Results Archive (llvm-testresults)`__
Sean Silva	12159ff	2013-01-20 02:19:36 +0000	[diff] [blame]	451	A message is automatically sent to this list by every active nightly tester
				452	when it completes. As such, this list gets email several times each day,
				453	making it a high volume list.
				454
Tanya Lattner	0d28f80	2015-08-05 03:51:17 +0000	[diff] [blame^]	455	.. __: http://lists.llvm.org/pipermail/llvm-testresults/
Sean Silva	9d0eb94	2013-01-20 02:19:42 +0000	[diff] [blame]	456
Sean Silva	ab4997d	2013-03-30 15:33:01 +0000	[diff] [blame]	457	`LLVM Announcements List (llvm-announce)`__
Sean Silva	84b296c	2013-03-30 15:32:54 +0000	[diff] [blame]	458	This is a low volume list that provides important announcements regarding
				459	LLVM. It gets email about once a month.
				460
Tanya Lattner	0d28f80	2015-08-05 03:51:17 +0000	[diff] [blame^]	461	.. __: http://lists.llvm.org/mailman/listinfo/llvm-announce
Sean Silva	84b296c	2013-03-30 15:32:54 +0000	[diff] [blame]	462
Sean Silva	0129924	2013-03-30 15:32:51 +0000	[diff] [blame]	463	IRC
				464	---
				465
				466	Users and developers of the LLVM project (including subprojects such as Clang)
				467	can be found in #llvm on `irc.oftc.net <irc://irc.oftc.net/llvm>`_.
				468
				469	This channel has several bots.
				470
				471	* Buildbot reporters
				472
				473	* llvmbb - Bot for the main LLVM buildbot master.
				474	http://lab.llvm.org:8011/console
				475	* bb-chapuni - An individually run buildbot master. http://bb.pgr.jp/console
				476	* smooshlab - Apple's internal buildbot master.
				477
				478	* robot - Bugzilla linker. %bug <number>
				479
				480	* clang-bot - A `geordi <http://www.eelis.net/geordi/>`_ instance running
				481	near-trunk clang instead of gcc.
				482
				483
Daniel Dunbar	fbb8041	2012-04-19 16:31:37 +0000	[diff] [blame]	484	Indices and tables
				485	==================
				486
				487	* :ref:`genindex`
				488	* :ref:`search`