Try to clarify which compilers can be used for the
[oota-llvm.git] / docs / index.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
2                       "http://www.w3.org/TR/html4/strict.dtd">
3 <html>
4 <head>
5   <title>Documentation for the LLVM System</title>
6   <link rel="stylesheet" href="llvm.css" type="text/css">
7 </head>
8 <body>
9
10 <div class="doc_title">Documentation for the LLVM System</div>
11
12 <div class="doc_text">
13 <table class="layout" width="95%"><tr class="layout"><td class="left">
14 <ul>
15   <li><a href="#llvmdesign">LLVM Design</a></li>
16   <li><a href="/pubs/">LLVM Publications</a></li>
17   <li><a href="#userguide">LLVM User Guides</a></li>
18   <li><a href="#llvmprog">General LLVM Programming Documentation</a></li>
19   <li><a href="#subsystems">LLVM Subsystem Documentation</a></li>
20   <li><a href="#maillist">LLVM Mailing Lists</a></li>
21 </ul>
22 </td><td class="right">
23   <form action="http://www.google.com/search" method=get>
24       <input type="hidden" name="sitesearch" value="llvm.org/docs">
25       <input type=text name=q size=25><br>
26       <input type=submit value="Search the LLVM Docs" name="submit">
27   </form>
28 </td></tr></table>
29 </div>
30
31 <div class="doc_author">    
32   <p>Written by <a href="http://llvm.org">The LLVM Team</a></p>
33 </div>
34
35 <!--=======================================================================-->
36 <div class="doc_section"><a name="llvmdesign">LLVM Design &amp; Overview</a></div>
37 <!--=======================================================================-->
38
39 <ul>
40 <li><a href="LangRef.html">LLVM Language Reference Manual</a> - Defines the LLVM
41 intermediate representation.</li>
42 <li><a href="http://llvm.org/pubs/2006-04-25-GelatoLLVMIntro.html">Introduction to the LLVM Compiler Infrastructure</a> - Presentation describing LLVM.</li>
43 <li><a href="http://llvm.org/pubs/2004-09-22-LCPCLLVMTutorial.html">The LLVM Compiler Framework and
44 Infrastructure Tutorial</a> - Tutorial for writing passes, exploring the system.</li>
45 <li><a href="http://llvm.org/pubs/2004-01-30-CGO-LLVM.html">LLVM: A Compilation Framework for
46 Lifelong Program Analysis &amp; Transformation</a> - Design overview.</li>
47 <li><a href="http://llvm.org/pubs/2002-12-LattnerMSThesis.html">LLVM: An Infrastructure for
48 Multi-Stage Optimization</a> - More details (somewhat old now).</li>
49 <li><a href="GetElementPtr.html">GetElementPtr FAQ</a> - Answers to some very
50 frequent questions about LLVM's most frequently misunderstood instruction.</li>
51 </ul>
52
53 <!--=======================================================================-->
54 <div class="doc_section"><a name="userguide">LLVM User Guides</a></div>
55 <!--=======================================================================-->
56
57 <ul>
58 <li><a href="GettingStarted.html">The LLVM Getting Started Guide</a> -
59 Discusses how to get up and running quickly with the LLVM infrastructure.
60 Everything from unpacking and compilation of the distribution to execution of
61 some tools.</li>
62
63 <li><a href="GettingStartedVS.html">Getting Started with the LLVM System using
64 Microsoft Visual Studio</a> - An addendum to the main Getting Started guide for
65 those using Visual Studio on Windows.</li>
66
67 <li><a href="tutorial/">LLVM Tutorial</a> - A walk through the process of using
68 LLVM for a custom language, and the facilities LLVM offers in tutorial form.</li>
69 <li><a href="DeveloperPolicy.html">Developer Policy</a> - The LLVM project's
70 policy towards developers and their contributions.</li>
71
72 <li><a href="/docs/CommandGuide/index.html">LLVM Command Guide</a> - A reference
73 manual for the LLVM command line utilities ("man" pages for LLVM tools).<br/>
74 Current tools:
75  <a href="/cmds/llvm-ar.html">llvm-ar</a>,
76  <a href="/cmds/llvm-as.html">llvm-as</a>,
77  <a href="/cmds/llvm-dis.html">llvm-dis</a>,
78  <a href="/cmds/llvm-extract.html">llvm-extract</a>,
79  <a href="/cmds/llvm-ld.html">llvm-ld</a>,
80  <a href="/cmds/llvm-link.html">llvm-link</a>,
81  <a href="/cmds/llvm-nm.html">llvm-nm</a>,
82  <a href="/cmds/llvm-prof.html">llvm-prof</a>,
83  <a href="/cmds/llvm-ranlib.html">llvm-ranlib</a>,
84  <a href="/cmds/opt.html">opt</a>,
85  <a href="/cmds/llc.html">llc</a>,
86  <a href="/cmds/lli.html">lli</a>,
87  <a href="/cmds/llvmc.html">llvmc</a>
88  <a href="/cmds/llvmgcc.html">llvm-gcc</a>,
89  <a href="/cmds/llvmgxx.html">llvm-g++</a>,
90  <a href="/cmds/stkrc.html">stkrc</a>,
91  <a href="/cmds/bugpoint.html">bugpoint</a>,
92  <a href="/cmds/llvm-bcanalyzer.html">llvm-bcanalyzer</a>,
93 </li>
94
95 <li><a href="FAQ.html">Frequently Asked Questions</a> - A list of common
96 questions and problems and their solutions.</li>
97
98 <li><a href="ReleaseNotes.html">Release notes for the current release</a> 
99 - This describes new features, known bugs, and other limitations.</li>
100
101 <li><a href="HowToSubmitABug.html">How to Submit A Bug Report</a> -
102 Instructions for properly submitting information about any bugs you run into in
103 the LLVM system.</li>
104
105 <li><a href="TestingGuide.html">LLVM Test Suite Guide</a> - A reference
106 manual for using the LLVM test suite.</li>
107
108 <li><a href="GCCFEBuildInstrs.html">How to build the C/C++ front-end</a> -
109 Instructions for building the front-end from source.</li>
110
111 <li><a href="Lexicon.html">The LLVM Lexicon</a> - Definition of acronyms, terms
112 and concepts used in LLVM.</li>
113
114 <li><a name="irc">You can probably find help on the unofficial LLVM IRC 
115 channel</a>.  We often are on irc.oftc.net in the #llvm channel.  If you are 
116 using the mozilla browser, and have chatzilla installed, you can <a 
117 href="irc://irc.oftc.net/llvm">join #llvm on irc.oftc.net</a> directly.</li>
118
119 </ul>
120
121
122 <!--=======================================================================-->
123 <div class="doc_section"><a name="llvmprog">General LLVM Programming Documentation</a></div>
124 <!--=======================================================================-->
125
126 <ul>
127 <li><a href="LangRef.html">LLVM Language Reference Manual</a> - Defines the LLVM
128 intermediate representation and the assembly form of the different nodes.</li>
129
130 <li><a href="ProgrammersManual.html">The LLVM Programmers Manual</a> -
131 Introduction to the general layout of the LLVM sourcebase, important classes
132 and APIs, and some tips &amp; tricks.</li>
133
134 <li><a href="Projects.html">LLVM Project Guide</a> - How-to guide and
135 templates for new projects that <em>use</em> the LLVM infrastructure.  The
136 templates (directory organization, Makefiles, and test tree) allow the project
137 code to be located outside (or inside) the <tt>llvm/</tt> tree, while using LLVM
138 header files and libraries.</li>
139
140 <li><a href="MakefileGuide.html">LLVM Makefile Guide</a> - Describes how the
141 LLVM makefiles work and how to use them.</li>
142
143 <li><a href="CommandLine.html">CommandLine library Reference Manual</a> -
144 Provides information on using the command line parsing library.</li>
145
146 <li><a href="CodingStandards.html">LLVM Coding standards</a> -
147 Details the LLVM coding standards and provides useful information on writing
148 efficient C++ code.</li>
149
150 <li><a href="ExtendingLLVM.html">Extending LLVM</a> - Look here to see how 
151 to add instructions and intrinsics to LLVM.</li>
152
153 <li><a href="UsingLibraries.html">Using LLVM Libraries</a> - Look here to
154 understand how to use the libraries produced when LLVM is compiled.</li>
155
156 <li><a href="HowToReleaseLLVM.html">How To Release LLVM To The Public</a> - This
157 is a guide to preparing LLVM releases. Most developers can ignore it.</li>
158
159 <li><a href="http://llvm.org/doxygen/">Doxygen generated 
160 documentation</a> (<a
161 href="http://llvm.org/doxygen/inherits.html">classes</a>)
162
163 (<a href="http://llvm.org/doxygen/doxygen.tar.gz">tarball</a>)
164 </li>
165
166 <li><a href="http://llvm.org/viewvc/">ViewVC Repository Browser</a></li>
167
168 </ul>
169
170 <!--=======================================================================-->
171 <div class="doc_section"><a name="subsystems">LLVM Subsystem Documentation</a></div>
172 <!--=======================================================================-->
173
174 <ul>
175
176 <li><a href="WritingAnLLVMPass.html">Writing an LLVM Pass</a> - Information
177 on how to write LLVM transformations and analyses.</li>
178
179 <li><a href="WritingAnLLVMBackend.html">Writing an LLVM Backend</a> - Information
180 on how to write LLVM backends for machine targets.</li>
181
182 <li><a href="CodeGenerator.html">The LLVM Target-Independent Code
183 Generator</a> - The design and implementation of the LLVM code generator.
184 Useful if you are working on retargetting LLVM to a new architecture, designing
185 a new codegen pass, or enhancing existing components.</li>
186
187 <li><a href="TableGenFundamentals.html">TableGen Fundamentals</a> -
188 Describes the TableGen tool, which is used heavily by the LLVM code
189 generator.</li>
190
191 <li><a href="AliasAnalysis.html">Alias Analysis in LLVM</a> - Information
192 on how to write a new alias analysis implementation or how to use existing
193 analyses.</li>
194
195 <li><a href="Stacker.html">The Stacker Chronicles</a> - This document
196 describes both the Stacker language and LLVM frontend, but also some details
197 about LLVM useful for those writing front-ends.</li>
198
199 <li><a href="GarbageCollection.html">Accurate Garbage Collection with
200 LLVM</a> - The interfaces source-language compilers should use for compiling
201 GC'd programs.</li>
202
203 <li><a href="SourceLevelDebugging.html">Source Level Debugging with
204 LLVM</a> - This document describes the design and philosophy behind the LLVM
205 source-level debugger.</li>
206
207 <li><a href="ExceptionHandling.html">Zero Cost Exception handling in LLVM</a> 
208 - This document describes the design and implementation of exception handling
209 in LLVM.</li>
210
211 <li><a href="Bugpoint.html">Bugpoint</a> - automatic bug finder and test-case
212 reducer description and usage information.</li>
213
214 <li><a href="CompilerDriver.html">Compiler Driver (llvmc)</a> - This document
215 describes the design and configuration of the LLVM compiler driver tool,
216 <tt>llvmc</tt>.</li>
217
218 <li><a href="BitCodeFormat.html">LLVM Bitcode File Format</a></li>
219
220 <li><a href="SystemLibrary.html">System Library</a> - This document describes
221 the LLVM System Library (<tt>lib/System</tt>) and how to keep LLVM source code
222 portable</li>
223
224 <li><a href="LinkTimeOptimization.html">Link Time Optimization</a> - This
225 document describes the interface between LLVM intermodular optimizer and
226 the linker and its design</li>
227
228 </ul>
229
230
231 <!--=======================================================================-->
232 <div class="doc_section"><a name="maillist">LLVM Mailing Lists</a></div>
233 <!--=======================================================================-->
234
235 <ul>
236 <li>The <a href="http://mail.cs.uiuc.edu/mailman/listinfo/llvm-announce">
237 LLVM Announcements List</a>: This is a low volume list that provides important 
238 announcements regarding LLVM.  It gets email about once a month.</li>
239
240 <li>The <a href="http://mail.cs.uiuc.edu/mailman/listinfo/llvmdev">Developer's
241 List</a>: This list is for people who want to be included in technical 
242 discussions of LLVM. People post to this list when they have questions about 
243 writing code for or using the LLVM tools. It is relatively low volume.</li>
244
245 <li>The <a href="http://mail.cs.uiuc.edu/pipermail/llvmbugs/">Bugs &amp;
246 Patches Archive</a>: This list gets emailed every time a bug is opened and
247 closed, and when people submit patches to be included in LLVM.  It is higher 
248 volume than the LLVMdev list.</li>
249
250 <li>The <a href="http://mail.cs.uiuc.edu/pipermail/llvm-commits/">Commits
251 Archive</a>: This list contains all commit messages that are made when LLVM 
252 developers commit code changes to the repository. It is useful for those who 
253 want to stay on the bleeding edge of LLVM development. This list is very high
254 volume.</li>
255
256 <li>The <a href="http://mail.cs.uiuc.edu/pipermail/llvm-testresults/">
257 Test Results Archive</a>: A message is automatically sent to this list by every
258 active nightly tester when it completes.  As such, this list gets email several
259 times each day, making it a high volume list.</li>
260
261 </ul>
262
263 <!-- *********************************************************************** -->
264
265 <hr>
266 <address>
267   <a href="http://jigsaw.w3.org/css-validator/check/referer"><img
268   src="http://jigsaw.w3.org/css-validator/images/vcss" alt="Valid CSS!"></a>
269   <a href="http://validator.w3.org/check/referer"><img
270   src="http://www.w3.org/Icons/valid-html401" alt="Valid HTML 4.01!"></a>
271
272   <a href="http://llvm.org">LLVM Compiler Infrastructure</a><br>
273   Last modified: $Date$
274 </address>
275 </body></html>
276