maxjhandsome
/
llvm-project
forked from OSchip/llvm-project
1
0
Fork 0
Code Issues Pull Requests Packages Releases Wiki Activity
llvm-project/llvm/docs/index.rst

485 lines
13 KiB
ReStructuredText
Raw Normal View History

[docs] Convert docs index page into Sphinx. - Work in progress, this is mostly important because it lets us incrementally migrate the remaining documentation. - Lots of styling, editing, and integration work yet to come… - PR12589 llvm-svn: 155133
2012-04-20 00:31:37 +08:00
Overview
========
.. warning::
If you are using a released version of LLVM, see `the download page
<http://llvm.org/releases/>`_ to find your documentation.
The LLVM compiler infrastructure supports a wide range of projects, from
industrial strength compilers to specialized JIT applications to small
research projects.
Similarly, documentation is broken down into several high-level groupings
Fix typos found by http://github.com/lyda/misspell-check llvm-svn: 157885
2012-06-02 18:20:22 +08:00
targeted at different audiences:
[docs] Convert docs index page into Sphinx. - Work in progress, this is mostly important because it lets us incrementally migrate the remaining documentation. - Lots of styling, editing, and integration work yet to come… - PR12589 llvm-svn: 155133
2012-04-20 00:31:37 +08:00
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
LLVM Design & Overview
======================
[docs] Convert docs index page into Sphinx. - Work in progress, this is mostly important because it lets us incrementally migrate the remaining documentation. - Lots of styling, editing, and integration work yet to come… - PR12589 llvm-svn: 155133
2012-04-20 00:31:37 +08:00
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Several introductory papers and presentations.
[docs] Convert docs index page into Sphinx. - Work in progress, this is mostly important because it lets us incrementally migrate the remaining documentation. - Lots of styling, editing, and integration work yet to come… - PR12589 llvm-svn: 155133
2012-04-20 00:31:37 +08:00
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
.. toctree::
:hidden:
LangRef
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`LangRef`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Defines the LLVM intermediate representation.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
`Introduction to the LLVM Compiler`__
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Presentation providing a users introduction to LLVM.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
.. __: http://llvm.org/pubs/2008-10-04-ACAT-LLVM-Intro.html
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
`Intro to LLVM`__
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Book chapter providing a compiler hacker's introduction to LLVM.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
.. __: http://www.aosabook.org/en/llvm.html
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
`LLVM: A Compilation Framework for Lifelong Program Analysis & Transformation`__
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Design overview.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
.. __: http://llvm.org/pubs/2004-01-30-CGO-LLVM.html
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
`LLVM: An Infrastructure for Multi-Stage Optimization`__
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
More details (quite old now).
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
.. __: http://llvm.org/pubs/2002-12-LattnerMSThesis.html
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
`Publications mentioning LLVM <http://llvm.org/pubs>`_
..
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
User Guides
===========
For those new to the LLVM system.
NOTE: If you are a user who is only interested in using LLVM-based
compilers, you should look into `Clang <http://clang.llvm.org>`_ or
`DragonEgg <http://dragonegg.llvm.org>`_ instead. The documentation here is
intended for users who have a need to work with the intermediate LLVM
representation.
.. toctree::
:hidden:
CMake
HowToBuildOnARM
Cross-compilation doc llvm-svn: 190282
2013-09-09 04:44:48 +08:00
HowToCrossCompileLLVM
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
CommandGuide/index
GettingStarted
GettingStartedVS
Updating GettingStarted documentation to reference CMake as the preferred way to build LLVM. Reviewers: chandlerc, samsonov, echristo Reviewed By: samsonov Subscribers: emaste, joker.eph, llvm-commits Differential Revision: http://reviews.llvm.org/D8046 llvm-svn: 232135
2015-03-13 09:58:14 +08:00
BuildingLLVMWithAutotools
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
FAQ
Lexicon
HowToAddABuilder
yaml2obj
HowToSubmitABug
SphinxQuickstartTemplate
Phabricator
TestingGuide
tutorial/index
ReleaseNotes
Passes
YamlIO
[docs] The GEP FAQ is not "design and overview" llvm-svn: 178422
2013-03-30 23:32:50 +08:00
GetElementPtr
[new docs] Performance Tips for Frontend Authors As mentioned on llvm-dev, this is a new documentation page intended to collect tips for frontend authors on how to generate IR that LLVM is able to optimize well. These types of things come up repeated in review threads and it would be good to have a place to save them. I added a small handful to start us off, but I mostly want to get the framework in place. Once the docs are here, we can add to them incrementally. If you know of something appropriate for this page, please add it! Differential Revision: http://reviews.llvm.org/D7890 llvm-svn: 230807
2015-02-28 07:14:50 +08:00
Frontend/PerformanceTips
[docs] Fix some Sphinx toctree warnings. llvm-svn: 190326
2013-09-10 03:09:00 +08:00
MCJITDesignAndImplementation
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`GettingStarted`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Discusses how to get up and running quickly with the LLVM infrastructure.
Everything from unpacking and compilation of the distribution to execution
of some tools.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`CMake`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
An addendum to the main Getting Started guide for those using the `CMake
build system <http://www.cmake.org>`_.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`HowToBuildOnARM`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Notes on building and testing LLVM/Clang on ARM.
Cross-compilation doc llvm-svn: 190282
2013-09-09 04:44:48 +08:00
:doc:`HowToCrossCompileLLVM`
Notes on cross-building and testing LLVM/Clang.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`GettingStartedVS`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
An addendum to the main Getting Started guide for those using Visual Studio
on Windows.
Updating GettingStarted documentation to reference CMake as the preferred way to build LLVM. Reviewers: chandlerc, samsonov, echristo Reviewed By: samsonov Subscribers: emaste, joker.eph, llvm-commits Differential Revision: http://reviews.llvm.org/D8046 llvm-svn: 232135
2015-03-13 09:58:14 +08:00
:doc:`BuildingLLVMWithAutotools`
An addendum to the Getting Started guide with instructions for building LLVM
with the Autotools build system.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`tutorial/index`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Tutorials about using LLVM. Includes a tutorial about making a custom
language with LLVM.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`LLVM Command Guide <CommandGuide/index>`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
A reference manual for the LLVM command line utilities ("man" pages for LLVM
tools).
[docs] Convert docs index page into Sphinx. - Work in progress, this is mostly important because it lets us incrementally migrate the remaining documentation. - Lots of styling, editing, and integration work yet to come… - PR12589 llvm-svn: 155133
2012-04-20 00:31:37 +08:00
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`Passes`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
A list of optimizations and analyses implemented in LLVM.
[docs] Convert docs index page into Sphinx. - Work in progress, this is mostly important because it lets us incrementally migrate the remaining documentation. - Lots of styling, editing, and integration work yet to come… - PR12589 llvm-svn: 155133
2012-04-20 00:31:37 +08:00
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`FAQ`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
A list of common questions and problems and their solutions.
[docs] Convert docs index page into Sphinx. - Work in progress, this is mostly important because it lets us incrementally migrate the remaining documentation. - Lots of styling, editing, and integration work yet to come… - PR12589 llvm-svn: 155133
2012-04-20 00:31:37 +08:00
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`Release notes for the current release <ReleaseNotes>`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
This describes new features, known bugs, and other limitations.
[docs] Convert docs index page into Sphinx. - Work in progress, this is mostly important because it lets us incrementally migrate the remaining documentation. - Lots of styling, editing, and integration work yet to come… - PR12589 llvm-svn: 155133
2012-04-20 00:31:37 +08:00
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`HowToSubmitABug`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Instructions for properly submitting information about any bugs you run into
in the LLVM system.
[docs] Convert docs index page into Sphinx. - Work in progress, this is mostly important because it lets us incrementally migrate the remaining documentation. - Lots of styling, editing, and integration work yet to come… - PR12589 llvm-svn: 155133
2012-04-20 00:31:37 +08:00
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`SphinxQuickstartTemplate`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
A template + tutorial for writing new Sphinx documentation. It is meant
to be read in source form.
[docs] Convert docs index page into Sphinx. - Work in progress, this is mostly important because it lets us incrementally migrate the remaining documentation. - Lots of styling, editing, and integration work yet to come… - PR12589 llvm-svn: 155133
2012-04-20 00:31:37 +08:00
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`LLVM Testing Infrastructure Guide <TestingGuide>`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
A reference manual for using the LLVM testing infrastructure.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
`How to build the C, C++, ObjC, and ObjC++ front end`__
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Instructions for building the clang front-end from source.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
.. __: http://clang.llvm.org/get_started.html
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`Lexicon`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Definition of acronyms, terms and concepts used in LLVM.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`HowToAddABuilder`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Instructions for adding new builder to LLVM buildbot master.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`YamlIO`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
A reference guide for using LLVM's YAML I/O library.
[docs] The GEP FAQ is not "design and overview" llvm-svn: 178422
2013-03-30 23:32:50 +08:00
:doc:`GetElementPtr`
Answers to some very frequent questions about LLVM's most frequently
misunderstood instruction.
[new docs] Performance Tips for Frontend Authors As mentioned on llvm-dev, this is a new documentation page intended to collect tips for frontend authors on how to generate IR that LLVM is able to optimize well. These types of things come up repeated in review threads and it would be good to have a place to save them. I added a small handful to start us off, but I mostly want to get the framework in place. Once the docs are here, we can add to them incrementally. If you know of something appropriate for this page, please add it! Differential Revision: http://reviews.llvm.org/D7890 llvm-svn: 230807
2015-02-28 07:14:50 +08:00
:doc:`Frontend/PerformanceTips`
A collection of tips for frontend authors on how to generate IR
which LLVM is able to effectively optimize.
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Programming Documentation
=========================
For developers of applications which use LLVM as a library.
[docs] Convert docs index page into Sphinx. - Work in progress, this is mostly important because it lets us incrementally migrate the remaining documentation. - Lots of styling, editing, and integration work yet to come… - PR12589 llvm-svn: 155133
2012-04-20 00:31:37 +08:00
.. toctree::
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
:hidden:
Atomics
CodingStandards
CommandLine
CompilerWriterInfo
ExtendingLLVM
HowToSetUpLLVMStyleRTTI
ProgrammersManual
MC: Support COFF image-relative MCSymbolRefs Add support for the COFF relocation types IMAGE_REL_I386_DIR32NB and IMAGE_REL_AMD64_ADDR32NB for 32- and 64-bit respectively. These are similar to normal 4-byte relocations except that they do not include the base address of the image. Image-relative relocations are used for debug information (32-bit) and SEH unwind tables (64-bit). A new MCSymbolRef variant called 'VK_COFF_IMGREL32' is introduced to specify such relocations. For AT&T assembly, this variant can be accessed using the symbol suffix '@imgrel'. llvm-svn: 179240
2013-04-11 07:28:17 +08:00
Extensions
Move lib/Fuzzer docs from a README.txt to a proper .rst file. Summary: Move lib/Fuzzer docs from a README.txt to a proper .rst file. This change does not add any content, just formatting. Test Plan: n/a Reviewers: samsonov Reviewed By: samsonov Subscribers: llvm-commits Differential Revision: http://reviews.llvm.org/D8710 llvm-svn: 233638
2015-03-31 07:05:30 +08:00
LibFuzzer
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`LLVM Language Reference Manual <LangRef>`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Defines the LLVM intermediate representation and the assembly form of the
different nodes.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`Atomics`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Information about LLVM's concurrency model.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`ProgrammersManual`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Introduction to the general layout of the LLVM sourcebase, important classes
and APIs, and some tips & tricks.
MC: Support COFF image-relative MCSymbolRefs Add support for the COFF relocation types IMAGE_REL_I386_DIR32NB and IMAGE_REL_AMD64_ADDR32NB for 32- and 64-bit respectively. These are similar to normal 4-byte relocations except that they do not include the base address of the image. Image-relative relocations are used for debug information (32-bit) and SEH unwind tables (64-bit). A new MCSymbolRef variant called 'VK_COFF_IMGREL32' is introduced to specify such relocations. For AT&T assembly, this variant can be accessed using the symbol suffix '@imgrel'. llvm-svn: 179240
2013-04-11 07:28:17 +08:00
:doc:`Extensions`
LLVM-specific extensions to tools and formats LLVM seeks compatibility with.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`CommandLine`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Provides information on using the command line parsing library.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`CodingStandards`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Details the LLVM coding standards and provides useful information on writing
efficient C++ code.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`HowToSetUpLLVMStyleRTTI`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
How to make ``isa<>``, ``dyn_cast<>``, etc. available for clients of your
class hierarchy.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`ExtendingLLVM`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Look here to see how to add instructions and intrinsics to LLVM.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
`Doxygen generated documentation <http://llvm.org/doxygen/>`_
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
(`classes <http://llvm.org/doxygen/inherits.html>`_)
(`tarball <http://llvm.org/doxygen/doxygen.tar.gz>`_)
Add link to Go bindings documentation. llvm-svn: 225815
2015-01-14 02:49:42 +08:00
`Documentation for Go bindings <http://godoc.org/llvm.org/llvm/bindings/go/llvm>`_
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
`ViewVC Repository Browser <http://llvm.org/viewvc/>`_
..
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`CompilerWriterInfo`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
A list of helpful links for compiler writers.
Move lib/Fuzzer docs from a README.txt to a proper .rst file. Summary: Move lib/Fuzzer docs from a README.txt to a proper .rst file. This change does not add any content, just formatting. Test Plan: n/a Reviewers: samsonov Reviewed By: samsonov Subscribers: llvm-commits Differential Revision: http://reviews.llvm.org/D8710 llvm-svn: 233638
2015-03-31 07:05:30 +08:00
:doc:`LibFuzzer`
A library for writing in-process guided fuzzers.
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Subsystem Documentation
=======================
For API clients and LLVM developers.
.. toctree::
:hidden:
AliasAnalysis
BitCodeFormat
blockfreq: Document BlockFrequencyInfo terminology Documents terminology used in the forthcoming rewrite of BlockFrequencyInfo. <rdar://problem/14292693> llvm-svn: 206086
2014-04-12 07:21:07 +08:00
BlockFrequencyTerminology
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
BranchWeightMetadata
Bugpoint
CodeGenerator
ExceptionHandling
LinkTimeOptimization
SegmentedStacks
TableGenFundamentals
Re-factor TableGen docs This is mainly a movement of content around to give place to new content allowing different people to add bits to it in the right place. There is some new content, but mostly to fill the gaps left by text movement. I'm dropping the old syntax documentation as it has the problem of being quickly outdated by changes and largely unnecessary to people not involved in creating the language, but using it, which is the whole point of the documentation. llvm-svn: 204351
2014-03-21 00:08:34 +08:00
TableGen/index
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
DebuggingJITedCode
GoldPlugin
MarkedUpDisassembly
SystemLibrary
SourceLevelDebugging
Vectorizers
WritingAnLLVMBackend
GarbageCollection
WritingAnLLVMPass
Adding a HowTo for Attributes. This is based on Bill Wendling's email. No additional content has been added, but now there's a place for Attributes to capture future information. llvm-svn: 174961
2013-02-12 19:45:22 +08:00
HowToUseAttributes
Add start of user documentation for NVPTX Summary: This is the beginning of user documentation for the NVPTX back-end. I want to ensure I am integrating this properly into the rest of the LLVM documentation. Differential Revision: http://llvm-reviews.chandlerc.com/D600 llvm-svn: 178428
2013-03-31 00:41:14 +08:00
NVPTXUsage
R600/SI: Start implementing an assembler This was done using the Sparc and PowerPC AsmParsers as guides. So far it is very simple and only supports sopp instructions. llvm-svn: 221994
2014-11-14 22:08:00 +08:00
R600Usage
LangRef documentation for the stackmap and patchpoint intrinsics. These still have "experimental" status, meaning we don't guarantee backward compatibility. However, they are already actively used by the open source WebKit project, and have started to be adopted by other projects. llvm-svn: 197930
2013-12-24 10:57:25 +08:00
StackMaps
[docs] Fix some Sphinx warnings. The docs now build cleanly. Yay! The following warnings were fixed: /home/sean/pg/llvm/llvm/docs/HowToReleaseLLVM.rst:364: WARNING: Enumerated list ends without a blank line; unexpected unindent. /home/sean/pg/llvm/llvm/docs/InAlloca.rst:: WARNING: document isn't included in any toctree /home/sean/pg/llvm/llvm/docs/CodingStandards.rst:85: WARNING: Title underline too short. Supported C++11 Language and Library Features ------------------------------------------- /home/sean/pg/llvm/llvm/docs/CodingStandards.rst:85: WARNING: Title underline too short. Supported C++11 Language and Library Features ------------------------------------------- /home/sean/pg/llvm/llvm/docs/GettingStarted.rst:185: WARNING: Explicit markup ends without a blank line; unexpected unindent. /home/sean/pg/llvm/llvm/docs/GettingStarted.rst:565: WARNING: Explicit markup ends without a blank line; unexpected unindent. /home/sean/pg/llvm/llvm/docs/GettingStarted.rst:567: WARNING: Block quote ends without a blank line; unexpected unindent. llvm-svn: 202603
2014-03-02 08:21:42 +08:00
InAlloca
[ARM64-BE] Add sphinx documentation for the ARM64 NEON implementation. There are some interesting decisions based on non-obvious rationale in the ARM64-BE NEON implementation - decent documentation is definitely required. llvm-svn: 208577
2014-05-12 23:13:39 +08:00
BigEndianNEON
Docs: add documentation for the coverage mapping format. Differential Revision: http://reviews.llvm.org/D4729 llvm-svn: 215990
2014-08-20 01:05:58 +08:00
CoverageMappingFormat
Fix sphinx error from Statepoints.rst It was complaining it wasn't included in any toctree llvm-svn: 223254
2014-12-04 02:35:11 +08:00
Statepoints
Added documentation for MergeFunctions pass: Pass looks for equivalent functions that are mergable and folds them. llvm-svn: 223931
2014-12-11 01:42:01 +08:00
MergeFunctions
Introduce bitset metadata format and bitset lowering pass. This patch introduces a new mechanism that allows IR modules to co-operatively build pointer sets corresponding to addresses within a given set of globals. One particular use case for this is to allow a C++ program to efficiently verify (at each call site) that a vtable pointer is in the set of valid vtable pointers for the class or its derived classes. One way of doing this is for a toolchain component to build, for each class, a bit set that maps to the memory region allocated for the vtables, such that each 1 bit in the bit set maps to a valid vtable for that class, and lay out the vtables next to each other, to minimize the total size of the bit sets. The patch introduces a metadata format for representing pointer sets, an '@llvm.bitset.test' intrinsic and an LTO lowering pass that lays out the globals and builds the bitsets, and documents the new feature. Differential Revision: http://reviews.llvm.org/D7288 llvm-svn: 230054
2015-02-21 04:30:47 +08:00
BitSets
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`WritingAnLLVMPass`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Information on how to write LLVM transformations and analyses.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`WritingAnLLVMBackend`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Information on how to write LLVM backends for machine targets.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`CodeGenerator`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
The design and implementation of the LLVM code generator. Useful if you are
working on retargetting LLVM to a new architecture, designing a new codegen
pass, or enhancing existing components.
[docs] Update link title docs/TableGen/ is not really just "fundamentals" anymore, but rather more of a portal for all things TableGen. llvm-svn: 205743
2014-04-08 06:42:53 +08:00
:doc:`TableGen <TableGen/index>`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Describes the TableGen tool, which is used heavily by the LLVM code
generator.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`AliasAnalysis`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Information on how to write a new alias analysis implementation or how to
use existing analyses.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`GarbageCollection`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
The interfaces source-language compilers should use for compiling GC'd
programs.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`Source Level Debugging with LLVM <SourceLevelDebugging>`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
This document describes the design and philosophy behind the LLVM
source-level debugger.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`Vectorizers`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
This document describes the current status of vectorization in LLVM.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`ExceptionHandling`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
This document describes the design and implementation of exception handling
in LLVM.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`Bugpoint`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Automatic bug finder and test-case reducer description and usage
information.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`BitCodeFormat`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
This describes the file format and encoding used for LLVM "bc" files.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`System Library <SystemLibrary>`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
This document describes the LLVM System Library (``lib/System``) and
how to keep LLVM source code portable
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`LinkTimeOptimization`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
This document describes the interface between LLVM intermodular optimizer
and the linker and its design
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`GoldPlugin`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
How to build your programs with link-time optimization on Linux.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`DebuggingJITedCode`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
How to debug JITed code with GDB.
Adding a document to describe the MCJIT execution engine implementation. llvm-svn: 188943
2013-08-22 06:15:09 +08:00
:doc:`MCJITDesignAndImplementation`
Describes the inner workings of MCJIT execution engine.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`BranchWeightMetadata`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Provides information about Branch Prediction Information.
blockfreq: Document BlockFrequencyInfo terminology Documents terminology used in the forthcoming rewrite of BlockFrequencyInfo. <rdar://problem/14292693> llvm-svn: 206086
2014-04-12 07:21:07 +08:00
:doc:`BlockFrequencyTerminology`
Provides information about terminology used in the ``BlockFrequencyInfo``
analysis pass.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`SegmentedStacks`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
This document describes segmented stacks and how they are used in LLVM.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`MarkedUpDisassembly`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
This document describes the optional rich disassembly output syntax.
Adding a HowTo for Attributes. This is based on Bill Wendling's email. No additional content has been added, but now there's a place for Attributes to capture future information. llvm-svn: 174961
2013-02-12 19:45:22 +08:00
:doc:`HowToUseAttributes`
Answers some questions about the new Attributes infrastructure.
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Add start of user documentation for NVPTX Summary: This is the beginning of user documentation for the NVPTX back-end. I want to ensure I am integrating this properly into the rest of the LLVM documentation. Differential Revision: http://llvm-reviews.chandlerc.com/D600 llvm-svn: 178428
2013-03-31 00:41:14 +08:00
:doc:`NVPTXUsage`
This document describes using the NVPTX back-end to compile GPU kernels.
R600/SI: Start implementing an assembler This was done using the Sparc and PowerPC AsmParsers as guides. So far it is very simple and only supports sopp instructions. llvm-svn: 221994
2014-11-14 22:08:00 +08:00
:doc:`R600Usage`
This document describes how to use the R600 back-end.
LangRef documentation for the stackmap and patchpoint intrinsics. These still have "experimental" status, meaning we don't guarantee backward compatibility. However, they are already actively used by the open source WebKit project, and have started to be adopted by other projects. llvm-svn: 197930
2013-12-24 10:57:25 +08:00
:doc:`StackMaps`
LLVM support for mapping instruction addresses to the location of
values and allowing code to be patched.
Add start of user documentation for NVPTX Summary: This is the beginning of user documentation for the NVPTX back-end. I want to ensure I am integrating this properly into the rest of the LLVM documentation. Differential Revision: http://llvm-reviews.chandlerc.com/D600 llvm-svn: 178428
2013-03-31 00:41:14 +08:00
[ARM64-BE] Add sphinx documentation for the ARM64 NEON implementation. There are some interesting decisions based on non-obvious rationale in the ARM64-BE NEON implementation - decent documentation is definitely required. llvm-svn: 208577
2014-05-12 23:13:39 +08:00
:doc:`BigEndianNEON`
LLVM's support for generating NEON instructions on big endian ARM targets is
somewhat nonintuitive. This document explains the implementation and rationale.
Docs: add documentation for the coverage mapping format. Differential Revision: http://reviews.llvm.org/D4729 llvm-svn: 215990
2014-08-20 01:05:58 +08:00
:doc:`CoverageMappingFormat`
This describes the format and encoding used for LLVM’s code coverage mapping.
[ARM64-BE] Add sphinx documentation for the ARM64 NEON implementation. There are some interesting decisions based on non-obvious rationale in the ARM64-BE NEON implementation - decent documentation is definitely required. llvm-svn: 208577
2014-05-12 23:13:39 +08:00
Fix sphinx error from Statepoints.rst It was complaining it wasn't included in any toctree llvm-svn: 223254
2014-12-04 02:35:11 +08:00
:doc:`Statepoints`
This describes a set of experimental extensions for garbage
collection support.
Added documentation for MergeFunctions pass: Pass looks for equivalent functions that are mergable and folds them. llvm-svn: 223931
2014-12-11 01:42:01 +08:00
:doc:`MergeFunctions`
Describes functions merging optimization.
[docs] Put an explicit link to InAlloca.rst llvm-svn: 228192
2015-02-05 04:51:19 +08:00
:doc:`InAlloca`
Description of the ``inalloca`` argument attribute.
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Development Process Documentation
=================================
Information about LLVM's development process.
.. toctree::
:hidden:
[docs] Put DeveloperPolicy under "Development Process Documentation" llvm-svn: 178421
2013-03-30 23:32:47 +08:00
DeveloperPolicy
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
MakefileGuide
Projects
LLVMBuild
HowToReleaseLLVM
docs: reorganize front page slightly llvm-svn: 173718
2013-01-29 05:28:10 +08:00
Packaging
[docs] Fix some Sphinx toctree warnings. llvm-svn: 190326
2013-09-10 03:09:00 +08:00
ReleaseProcess
Add a reference to Phabricator.rst to docs/index.rst. llvm-svn: 219015
2014-10-04 04:17:32 +08:00
Phabricator
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
[docs] Put DeveloperPolicy under "Development Process Documentation" llvm-svn: 178421
2013-03-30 23:32:47 +08:00
:doc:`DeveloperPolicy`
The LLVM project's policy towards developers and their contributions.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`Projects`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
How-to guide and templates for new projects that *use* the LLVM
infrastructure. The templates (directory organization, Makefiles, and test
tree) allow the project code to be located outside (or inside) the ``llvm/``
tree, while using LLVM header files and libraries.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`LLVMBuild`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Describes the LLVMBuild organization and files used by LLVM to specify
component descriptions.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`MakefileGuide`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Describes how the LLVM makefiles work and how to use them.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
:doc:`HowToReleaseLLVM`
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
This is a guide to preparing LLVM releases. Most developers can ignore it.
Linking ReleaseProcess doc with the world llvm-svn: 182763
2013-05-28 18:32:55 +08:00
:doc:`ReleaseProcess`
fix a typo in doumentation index. llvm-svn: 218504
2014-09-26 14:59:15 +08:00
This is a guide to validate a new release, during the release process. Most developers can ignore it.
Linking ReleaseProcess doc with the world llvm-svn: 182763
2013-05-28 18:32:55 +08:00
docs: reorganize front page slightly llvm-svn: 173718
2013-01-29 05:28:10 +08:00
:doc:`Packaging`
Advice on packaging LLVM into a distribution.
Add a reference to Phabricator.rst to docs/index.rst. llvm-svn: 219015
2014-10-04 04:17:32 +08:00
:doc:`Phabricator`
Describes how to use the Phabricator code review tool hosted on
http://reviews.llvm.org/ and its command line interface, Arcanist.
[docs] Pull IRC and Mailing Lists under a new "Community" heading. llvm-svn: 178423
2013-03-30 23:32:51 +08:00
Community
=========
LLVM has a thriving community of friendly and helpful developers.
The two primary communication mechanisms in the LLVM community are mailing
lists and IRC.
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
Mailing Lists
[docs] Pull IRC and Mailing Lists under a new "Community" heading. llvm-svn: 178423
2013-03-30 23:32:51 +08:00
-------------
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
If you can't find what you need in these docs, try consulting the mailing
lists.
[docs] Annotate mailing lists with their "name". Nobody says "the developer's list" or "commits archive"; they always say "llvmdev" or "llvm-commits". It makes sense for our documentation to at least make that association explicitly. llvm-svn: 178425
2013-03-30 23:33:01 +08:00
`Developer's List (llvmdev)`__
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
This list is for people who want to be included in technical discussions of
LLVM. People post to this list when they have questions about writing code
for or using the LLVM tools. It is relatively low volume.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
.. __: http://lists.cs.uiuc.edu/mailman/listinfo/llvmdev
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
[docs] Annotate mailing lists with their "name". Nobody says "the developer's list" or "commits archive"; they always say "llvmdev" or "llvm-commits". It makes sense for our documentation to at least make that association explicitly. llvm-svn: 178425
2013-03-30 23:33:01 +08:00
`Commits Archive (llvm-commits)`__
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
This list contains all commit messages that are made when LLVM developers
[docs] llvmbugs is not the place for patches. llvm-svn: 178426
2013-03-30 23:33:02 +08:00
commit code changes to the repository. It also serves as a forum for
patch review (i.e. send patches here). It is useful for those who want to
stay on the bleeding edge of LLVM development. This list is very high
volume.
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
.. __: http://lists.cs.uiuc.edu/pipermail/llvm-commits/
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
[docs] Annotate mailing lists with their "name". Nobody says "the developer's list" or "commits archive"; they always say "llvmdev" or "llvm-commits". It makes sense for our documentation to at least make that association explicitly. llvm-svn: 178425
2013-03-30 23:33:01 +08:00
`Bugs & Patches Archive (llvmbugs)`__
[docs] llvmbugs is not the place for patches. llvm-svn: 178426
2013-03-30 23:33:02 +08:00
This list gets emailed every time a bug is opened and closed. It is
higher volume than the LLVMdev list.
[docs] Reorganize mailing lists. Order them roughly by "which one should a newbie join first". llvm-svn: 178424
2013-03-30 23:32:54 +08:00
.. __: http://lists.cs.uiuc.edu/pipermail/llvmbugs/
[docs] Annotate mailing lists with their "name". Nobody says "the developer's list" or "commits archive"; they always say "llvmdev" or "llvm-commits". It makes sense for our documentation to at least make that association explicitly. llvm-svn: 178425
2013-03-30 23:33:01 +08:00
`Test Results Archive (llvm-testresults)`__
docs: Inline documentation structure into homepage. This brings back {Ctrl,Cmd}-f'ability, and makes some really bad organizational choices easier to see (and therefore fix). llvm-svn: 172949
2013-01-20 10:19:36 +08:00
A message is automatically sent to this list by every active nightly tester
when it completes. As such, this list gets email several times each day,
making it a high volume list.
docs: Use proper markup. These are really definition lists. llvm-svn: 172950
2013-01-20 10:19:42 +08:00
.. __: http://lists.cs.uiuc.edu/pipermail/llvm-testresults/
[docs] Annotate mailing lists with their "name". Nobody says "the developer's list" or "commits archive"; they always say "llvmdev" or "llvm-commits". It makes sense for our documentation to at least make that association explicitly. llvm-svn: 178425
2013-03-30 23:33:01 +08:00
`LLVM Announcements List (llvm-announce)`__
[docs] Reorganize mailing lists. Order them roughly by "which one should a newbie join first". llvm-svn: 178424
2013-03-30 23:32:54 +08:00
This is a low volume list that provides important announcements regarding
LLVM. It gets email about once a month.
.. __: http://lists.cs.uiuc.edu/mailman/listinfo/llvm-announce
[docs] Pull IRC and Mailing Lists under a new "Community" heading. llvm-svn: 178423
2013-03-30 23:32:51 +08:00
IRC
---
Users and developers of the LLVM project (including subprojects such as Clang)
can be found in #llvm on `irc.oftc.net <irc://irc.oftc.net/llvm>`_.
This channel has several bots.
* Buildbot reporters
* llvmbb - Bot for the main LLVM buildbot master.
http://lab.llvm.org:8011/console
* bb-chapuni - An individually run buildbot master. http://bb.pgr.jp/console
* smooshlab - Apple's internal buildbot master.
* robot - Bugzilla linker. %bug <number>
* clang-bot - A `geordi <http://www.eelis.net/geordi/>`_ instance running
near-trunk clang instead of gcc.
[docs] Convert docs index page into Sphinx. - Work in progress, this is mostly important because it lets us incrementally migrate the remaining documentation. - Lots of styling, editing, and integration work yet to come… - PR12589 llvm-svn: 155133
2012-04-20 00:31:37 +08:00
Indices and tables
==================
* :ref:`genindex`
* :ref:`search`