Gitiles
Code Review Sign In
gerrit-public.fairphone.software / fp2-dev / platform / external / llvm / ff373d73d039a24a274d0f98940d417d1d89812d / . / docs / ReleaseNotes.html
blob: 1ab2b709f58cfbb78b3555b5fa04e4fa45812de4 [file] [log] [blame]
Misha Brukman500bc302003-11-22 00:38:41 +0000[diff] [blame]1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
2 "http://www.w3.org/TR/html4/strict.dtd">
3<html>
4<head>
Reid Spencer6454ed32004-11-18 18:38:58 +0000[diff] [blame]5 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
Daniel Dunbaradea4972012-04-19 20:20:34 +0000[diff] [blame]6 <link rel="stylesheet" href="_static/llvm.css" type="text/css">
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]7 <title>LLVM 3.2 Release Notes</title>
Misha Brukman500bc302003-11-22 00:38:41 +0000[diff] [blame]8</head>
9<body>
Chris Lattner79c3fe12003-10-02 04:57:28 +0000[diff] [blame]10
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]11<h1>LLVM 3.2 Release Notes</h1>
Mikhail Glushenkovea65d7d2008-10-13 02:08:34 +0000[diff] [blame]12
Jakub Staszakf8de54f2011-12-06 23:33:07 +0000[diff] [blame]13<div>
14<img style="float:right" src="http://llvm.org/img/DragonSmall.png"
15 width="136" height="136" alt="LLVM Dragon Logo">
16</div>
Chris Lattner0e464a92010-03-17 04:02:39 +0000[diff] [blame]17
Chris Lattner79c3fe12003-10-02 04:57:28 +0000[diff] [blame]18<ol>
Misha Brukman500bc302003-11-22 00:38:41 +0000[diff] [blame]19 <li><a href="#intro">Introduction</a></li>
Chris Lattner96a445e2008-10-13 18:01:01 +0000[diff] [blame]20 <li><a href="#subproj">Sub-project Status Update</a></li>
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]21 <li><a href="#externalproj">External Projects Using LLVM 3.2</a></li>
Chris Lattner21e1b7a2011-12-13 17:55:30 +0000[diff] [blame]22 <li><a href="#whatsnew">What's New in LLVM?</a></li>
Chris Lattner4b538b92004-04-30 22:17:12 +0000[diff] [blame]23 <li><a href="GettingStarted.html">Installation Instructions</a></li>
Dan Gohman44aa9212008-10-14 16:23:02 +0000[diff] [blame]24 <li><a href="#knownproblems">Known Problems</a></li>
Misha Brukman500bc302003-11-22 00:38:41 +0000[diff] [blame]25 <li><a href="#additionalinfo">Additional Information</a></li>
Chris Lattner79c3fe12003-10-02 04:57:28 +0000[diff] [blame]26</ol>
27
Chris Lattner7911ce22004-05-23 21:07:27 +0000[diff] [blame]28<div class="doc_author">
NAKAMURA Takumib9a33632011-04-09 02:13:37 +0000[diff] [blame]29 <p>Written by the <a href="http://llvm.org/">LLVM Team</a></p>
Misha Brukman500bc302003-11-22 00:38:41 +0000[diff] [blame]30</div>
Chris Lattner79c3fe12003-10-02 04:57:28 +0000[diff] [blame]31
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]32<h1 style="color:red">These are in-progress notes for the upcoming LLVM 3.2
Jeffrey Yasskinbec48772010-01-28 01:14:43 +0000[diff] [blame]33release.<br>
34You may prefer the
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]35<a href="http://llvm.org/releases/3.1/docs/ReleaseNotes.html">LLVM 3.1
Dan Gohmanb44f6c62010-05-03 23:51:05 +0000[diff] [blame]36Release Notes</a>.</h1>
Jeffrey Yasskinbec48772010-01-28 01:14:43 +0000[diff] [blame]37
Chris Lattner79c3fe12003-10-02 04:57:28 +0000[diff] [blame]38<!-- *********************************************************************** -->
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]39<h2>
Misha Brukman500bc302003-11-22 00:38:41 +0000[diff] [blame]40 <a name="intro">Introduction</a>
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]41</h2>
Chris Lattner79c3fe12003-10-02 04:57:28 +0000[diff] [blame]42<!-- *********************************************************************** -->
43
NAKAMURA Takumi074eeaa2011-04-21 01:52:00 +0000[diff] [blame]44<div>
Misha Brukman500bc302003-11-22 00:38:41 +0000[diff] [blame]45
Chris Lattnerf6662f92008-10-13 17:57:36 +0000[diff] [blame]46<p>This document contains the release notes for the LLVM Compiler
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]47 Infrastructure, release 3.2. Here we describe the status of LLVM, including
Chris Lattner1ab8ce92011-11-27 18:47:37 +0000[diff] [blame]48 major improvements from the previous release, improvements in various
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]49 subprojects of LLVM, and some of the current users of the code. All LLVM
50 releases may be downloaded from the <a href="http://llvm.org/releases/">LLVM
51 releases web site</a>.</p>
Chris Lattner19092612003-10-02 16:38:05 +0000[diff] [blame]52
Chris Lattner7506b1d2004-12-07 08:04:13 +0000[diff] [blame]53<p>For more information about LLVM, including information about the latest
Bill Wendling7b7fa742011-10-26 18:46:16 +0000[diff] [blame]54 release, please check out the <a href="http://llvm.org/">main LLVM web
55 site</a>. If you have questions or comments,
56 the <a href="http://lists.cs.uiuc.edu/mailman/listinfo/llvmdev">LLVM
57 Developer's Mailing List</a> is a good place to send them.</p>
Chris Lattner79c3fe12003-10-02 04:57:28 +0000[diff] [blame]58
Bill Wendling7b7fa742011-10-26 18:46:16 +0000[diff] [blame]59<p>Note that if you are reading this file from a Subversion checkout or the main
60 LLVM web page, this document applies to the <i>next</i> release, not the
61 current one. To see the release notes for a specific release, please see the
62 <a href="http://llvm.org/releases/">releases page</a>.</p>
Misha Brukman500bc302003-11-22 00:38:41 +0000[diff] [blame]63
64</div>
Michael J. Spencer60f790c2011-11-28 18:20:09 +0000[diff] [blame]65
66
Chris Lattner96a445e2008-10-13 18:01:01 +0000[diff] [blame]67<!-- *********************************************************************** -->
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]68<h2>
Chris Lattner96a445e2008-10-13 18:01:01 +0000[diff] [blame]69 <a name="subproj">Sub-project Status Update</a>
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]70</h2>
Chris Lattner96a445e2008-10-13 18:01:01 +0000[diff] [blame]71<!-- *********************************************************************** -->
Chris Lattnerea34f642008-06-08 21:34:41 +0000[diff] [blame]72
NAKAMURA Takumi074eeaa2011-04-21 01:52:00 +0000[diff] [blame]73<div>
Bill Wendling7b7fa742011-10-26 18:46:16 +0000[diff] [blame]74
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]75<p>The LLVM 3.2 distribution currently consists of code from the core LLVM
76 repository, which roughly includes the LLVM optimizers, code generators and
77 supporting tools, and the Clang repository. In addition to this code, the
78 LLVM Project includes other sub-projects that are in development. Here we
Bill Wendling1fefd092012-05-14 08:11:53 +0000[diff] [blame]79 include updates on these subprojects.</p>
Chris Lattner96a445e2008-10-13 18:01:01 +0000[diff] [blame]80
Chris Lattner8348b472008-06-08 21:58:17 +0000[diff] [blame]81<!--=========================================================================-->
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]82<h3>
Chris Lattnerfb97b2d2008-10-13 18:11:54 +0000[diff] [blame]83<a name="clang">Clang: C/C++/Objective-C Frontend Toolkit</a>
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]84</h3>
Chris Lattner8348b472008-06-08 21:58:17 +0000[diff] [blame]85
NAKAMURA Takumi074eeaa2011-04-21 01:52:00 +0000[diff] [blame]86<div>
Chris Lattner8348b472008-06-08 21:58:17 +0000[diff] [blame]87
Chris Lattner095539f2010-04-26 17:42:18 +0000[diff] [blame]88<p><a href="http://clang.llvm.org/">Clang</a> is an LLVM front end for the C,
Bill Wendling7b7fa742011-10-26 18:46:16 +0000[diff] [blame]89 C++, and Objective-C languages. Clang aims to provide a better user
90 experience through expressive diagnostics, a high level of conformance to
91 language standards, fast compilation, and low memory use. Like LLVM, Clang
92 provides a modular, library-based architecture that makes it suitable for
93 creating or integrating with other development tools. Clang is considered a
94 production-quality compiler for C, Objective-C, C++ and Objective-C++ on x86
Chris Lattner1ab8ce92011-11-27 18:47:37 +0000[diff] [blame]95 (32- and 64-bit), and for Darwin/ARM targets.</p>
Chris Lattner61358ab2009-10-13 17:48:04 +0000[diff] [blame]96
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]97<p>In the LLVM 3.2 time-frame, the Clang team has made many improvements.
Benjamin Kramer88c8e692012-05-13 10:40:08 +0000[diff] [blame]98 Highlights include:</p>
Douglas Gregorba087df2011-10-15 00:48:01 +0000[diff] [blame]99<ul>
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]100 <li>...</li>
Douglas Gregorba087df2011-10-15 00:48:01 +0000[diff] [blame]101</ul>
Chris Lattner21e1b7a2011-12-13 17:55:30 +0000[diff] [blame]102
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]103<p>For more details about the changes to Clang since the 3.1 release, see the
Bill Wendling1fefd092012-05-14 08:11:53 +0000[diff] [blame]104 <a href="http://clang.llvm.org/docs/ReleaseNotes.html">Clang release
105 notes.</a></p>
Michael J. Spencer60f790c2011-11-28 18:20:09 +0000[diff] [blame]106
Duncan Sandsf3ba7af2011-04-06 08:07:40 +0000[diff] [blame]107<p>If Clang rejects your code but another compiler accepts it, please take a
Bill Wendling7b7fa742011-10-26 18:46:16 +0000[diff] [blame]108 look at the <a href="http://clang.llvm.org/compatibility.html">language
109 compatibility</a> guide to make sure this is not intentional or a known
110 issue.</p>
Bill Wendling741748a2008-10-27 09:27:33 +0000[diff] [blame]111
Chris Lattnerfb97b2d2008-10-13 18:11:54 +0000[diff] [blame]112</div>
113
114<!--=========================================================================-->
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]115<h3>
Duncan Sands528a5102011-04-04 11:09:08 +0000[diff] [blame]116<a name="dragonegg">DragonEgg: GCC front-ends, LLVM back-end</a>
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]117</h3>
Chris Lattner61358ab2009-10-13 17:48:04 +0000[diff] [blame]118
NAKAMURA Takumi074eeaa2011-04-21 01:52:00 +0000[diff] [blame]119<div>
Bill Wendling1fefd092012-05-14 08:11:53 +0000[diff] [blame]120
Bill Wendling7b7fa742011-10-26 18:46:16 +0000[diff] [blame]121<p><a href="http://dragonegg.llvm.org/">DragonEgg</a> is a
122 <a href="http://gcc.gnu.org/wiki/plugins">gcc plugin</a> that replaces GCC's
Duncan Sands5abd10a2012-05-11 19:59:43 +0000[diff] [blame]123 optimizers and code generators with LLVM's. It works with gcc-4.5 and gcc-4.6
124 (and partially with gcc-4.7), can target the x86-32/x86-64 and ARM processor
125 families, and has been successfully used on the Darwin, FreeBSD, KFreeBSD,
126 Linux and OpenBSD platforms. It fully supports Ada, C, C++ and Fortran. It
127 has partial support for Go, Java, Obj-C and Obj-C++.</p>
Duncan Sands749fd832010-04-02 09:23:15 +0000[diff] [blame]128
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]129<p>The 3.2 release has the following notable changes:</p>
Bill Wendling7b7fa742011-10-26 18:46:16 +0000[diff] [blame]130
Bill Wendling1fefd092012-05-14 08:11:53 +0000[diff] [blame]131<ul>
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]132 <li>...</li>
Duncan Sands4b1da2b2010-09-30 17:37:34 +0000[diff] [blame]133</ul>
Chris Lattner61358ab2009-10-13 17:48:04 +0000[diff] [blame]134
135</div>
136
Chris Lattner75547712010-10-03 23:49:06 +0000[diff] [blame]137<!--=========================================================================-->
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]138<h3>
Chris Lattner75547712010-10-03 23:49:06 +0000[diff] [blame]139<a name="compiler-rt">compiler-rt: Compiler Runtime Library</a>
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]140</h3>
Chris Lattner75547712010-10-03 23:49:06 +0000[diff] [blame]141
NAKAMURA Takumi074eeaa2011-04-21 01:52:00 +0000[diff] [blame]142<div>
Bill Wendling7b7fa742011-10-26 18:46:16 +0000[diff] [blame]143
144<p>The new LLVM <a href="http://compiler-rt.llvm.org/">compiler-rt project</a>
145 is a simple library that provides an implementation of the low-level
146 target-specific hooks required by code generation and other runtime
147 components. For example, when compiling for a 32-bit target, converting a
148 double to a 64-bit unsigned integer is compiled into a runtime call to the
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]149 <code>__fixunsdfdi</code> function. The compiler-rt library provides highly
150 optimized implementations of this and other low-level routines (some are 3x
151 faster than the equivalent libgcc routines).</p>
Chris Lattner75547712010-10-03 23:49:06 +0000[diff] [blame]152
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]153<p>The 3.2 release has the following notable changes:</p>
154
155<ul>
156 <li>...</li>
157</ul>
David Chisnall6dd3bdb2012-05-15 13:06:46 +0000[diff] [blame]158
Chris Lattner75547712010-10-03 23:49:06 +0000[diff] [blame]159</div>
Chris Lattner61358ab2009-10-13 17:48:04 +0000[diff] [blame]160
161<!--=========================================================================-->
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]162<h3>
Chris Lattnere07043c2010-09-29 05:30:03 +0000[diff] [blame]163<a name="lldb">LLDB: Low Level Debugger</a>
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]164</h3>
Chris Lattnere07043c2010-09-29 05:30:03 +0000[diff] [blame]165
NAKAMURA Takumi074eeaa2011-04-21 01:52:00 +0000[diff] [blame]166<div>
Michael J. Spencer60f790c2011-11-28 18:20:09 +0000[diff] [blame]167
Benjamin Kramerabe446c2012-05-13 10:21:51 +0000[diff] [blame]168<p><a href="http://lldb.llvm.org">LLDB</a> is a ground-up implementation of a
169 command line debugger, as well as a debugger API that can be used from other
170 applications. LLDB makes use of the Clang parser to provide high-fidelity
171 expression parsing (particularly for C++) and uses the LLVM JIT for target
172 support.</p>
Chris Lattnere07043c2010-09-29 05:30:03 +0000[diff] [blame]173
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]174<p>The 3.2 release has the following notable changes:</p>
175
176<ul>
177 <li>...</li>
178</ul>
179
Chris Lattnere07043c2010-09-29 05:30:03 +0000[diff] [blame]180</div>
181
182<!--=========================================================================-->
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]183<h3>
Chris Lattnere07043c2010-09-29 05:30:03 +0000[diff] [blame]184<a name="libc++">libc++: C++ Standard Library</a>
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]185</h3>
Chris Lattnere07043c2010-09-29 05:30:03 +0000[diff] [blame]186
NAKAMURA Takumi074eeaa2011-04-21 01:52:00 +0000[diff] [blame]187<div>
Chris Lattnere07043c2010-09-29 05:30:03 +0000[diff] [blame]188
Bill Wendling7b7fa742011-10-26 18:46:16 +0000[diff] [blame]189<p>Like compiler_rt, libc++ is now <a href="DeveloperPolicy.html#license">dual
190 licensed</a> under the MIT and UIUC license, allowing it to be used more
191 permissively.</p>
Chris Lattnere07043c2010-09-29 05:30:03 +0000[diff] [blame]192
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]193<p>Within the LLVM 3.2 time-frame there were the following highlights:</p>
David Chisnall6dd3bdb2012-05-15 13:06:46 +0000[diff] [blame]194
195<ul>
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]196 <li>...</li>
David Chisnall6dd3bdb2012-05-15 13:06:46 +0000[diff] [blame]197</ul>
198
Chris Lattnere07043c2010-09-29 05:30:03 +0000[diff] [blame]199</div>
200
Chris Lattner3d6a80a2011-04-07 03:08:22 +0000[diff] [blame]201<!--=========================================================================-->
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]202<h3>
Chris Lattner3d6a80a2011-04-07 03:08:22 +0000[diff] [blame]203<a name="vmkit">VMKit</a>
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]204</h3>
Chris Lattner3d6a80a2011-04-07 03:08:22 +0000[diff] [blame]205
NAKAMURA Takumi074eeaa2011-04-21 01:52:00 +0000[diff] [blame]206<div>
Bill Wendling7b7fa742011-10-26 18:46:16 +0000[diff] [blame]207
Bill Wendling1fefd092012-05-14 08:11:53 +0000[diff] [blame]208<p>The <a href="http://vmkit.llvm.org/">VMKit project</a> is an implementation
209 of a Java Virtual Machine (Java VM or JVM) that uses LLVM for static and
210 just-in-time compilation.</p>
Nicolas Geoffray54d5df92011-11-10 23:37:56 +0000[diff] [blame]211
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]212<p>The 3.2 release has the following notable changes:</p>
213
214<ul>
215 <li>...</li>
216</ul>
Bill Wendling7b7fa742011-10-26 18:46:16 +0000[diff] [blame]217
Chris Lattner3d6a80a2011-04-07 03:08:22 +0000[diff] [blame]218</div>
Michael J. Spencer60f790c2011-11-28 18:20:09 +0000[diff] [blame]219
Tobias Grosser76213b82012-04-16 17:17:00 +0000[diff] [blame]220
221<!--=========================================================================-->
222<h3>
Tobias Grosser99a0b282012-04-16 17:18:49 +0000[diff] [blame]223<a name="Polly">Polly: Polyhedral Optimizer</a>
Tobias Grosser76213b82012-04-16 17:17:00 +0000[diff] [blame]224</h3>
225
226<div>
227
Bill Wendling1fefd092012-05-14 08:11:53 +0000[diff] [blame]228<p><a href="http://polly.llvm.org/">Polly</a> is an <em>experimental</em>
Tobias Grosser76213b82012-04-16 17:17:00 +0000[diff] [blame]229 optimizer for data locality and parallelism. It currently provides high-level
230 loop optimizations and automatic parallelisation (using the OpenMP run time).
231 Work in the area of automatic SIMD and accelerator code generation was
Bill Wendling1fefd092012-05-14 08:11:53 +0000[diff] [blame]232 started.</p>
Tobias Grosser76213b82012-04-16 17:17:00 +0000[diff] [blame]233
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]234<p>Within the LLVM 3.2 time-frame there were the following highlights:</p>
Tobias Grosser76213b82012-04-16 17:17:00 +0000[diff] [blame]235
Bill Wendling1fefd092012-05-14 08:11:53 +0000[diff] [blame]236<ul>
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]237 <li>...</li>
Bill Wendling1fefd092012-05-14 08:11:53 +0000[diff] [blame]238</ul>
Tobias Grosser76213b82012-04-16 17:17:00 +0000[diff] [blame]239
240</div>
241
NAKAMURA Takumi074eeaa2011-04-21 01:52:00 +0000[diff] [blame]242</div>
Daniel Dunbar97b01a82010-10-04 17:39:47 +0000[diff] [blame]243
Chris Lattnerab68e9e2009-02-26 22:33:38 +0000[diff] [blame]244<!-- *********************************************************************** -->
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]245<h2>
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]246 <a name="externalproj">External Open Source Projects Using LLVM 3.2</a>
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]247</h2>
Chris Lattnerab68e9e2009-02-26 22:33:38 +0000[diff] [blame]248<!-- *********************************************************************** -->
249
NAKAMURA Takumi074eeaa2011-04-21 01:52:00 +0000[diff] [blame]250<div>
Chris Lattner61358ab2009-10-13 17:48:04 +0000[diff] [blame]251
252<p>An exciting aspect of LLVM is that it is used as an enabling technology for
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]253 a lot of other language and tools projects. This section lists some of the
254 projects that have already been updated to work with LLVM 3.2.</p>
Chris Lattner75547712010-10-03 23:49:06 +0000[diff] [blame]255
Bill Wendlinged0ab542012-05-15 20:47:23 +0000[diff] [blame]256<h3>Crack</h3>
257
258<div>
259
260<p><a href="http://code.google.com/p/crack-language/">Crack</a> aims to provide
261 the ease of development of a scripting language with the performance of a
262 compiled language. The language derives concepts from C++, Java and Python,
263 incorporating object-oriented programming, operator overloading and strong
264 typing.</p>
265
266</div>
267
Bill Wendlingf8cfe2e2012-05-13 09:52:48 +0000[diff] [blame]268<h3>FAUST</h3>
269
270<div>
271
Benjamin Kramerabe446c2012-05-13 10:21:51 +0000[diff] [blame]272<p><a href="http://faust.grame.fr/">FAUST</a> is a compiled language for
273 real-time audio signal processing. The name FAUST stands for Functional
274 AUdio STream. Its programming model combines two approaches: functional
275 programming and block diagram composition. In addition with the C, C++, Java,
276 JavaScript output formats, the Faust compiler can generate LLVM bitcode, and
277 works with LLVM 2.7-3.1.</p>
Bill Wendlingf8cfe2e2012-05-13 09:52:48 +0000[diff] [blame]278
279</div>
280
Bill Wendlingde86bea2012-05-11 21:42:37 +0000[diff] [blame]281<h3>Glasgow Haskell Compiler (GHC)</h3>
282
283<div>
284
Benjamin Kramerabe446c2012-05-13 10:21:51 +0000[diff] [blame]285<p><a href="http://www.haskell.org/ghc/">GHC</a> is an open source compiler and
286 programming suite for Haskell, a lazy functional programming language. It
287 includes an optimizing static compiler generating good code for a variety of
288 platforms, together with an interactive system for convenient, quick
289 development.</p>
Bill Wendlingde86bea2012-05-11 21:42:37 +0000[diff] [blame]290
291<p>GHC 7.0 and onwards include an LLVM code generator, supporting LLVM 2.8 and
292 later.</p>
293
294</div>
295
Bill Wendlinge9a73bb2012-05-14 06:23:51 +0000[diff] [blame]296<h3>Julia</h3>
297
298<div>
299
300<p><a href="https://github.com/JuliaLang/julia">Julia</a> is a high-level,
301 high-performance dynamic language for technical computing. It provides a
302 sophisticated compiler, distributed parallel execution, numerical accuracy,
303 and an extensive mathematical function library. The compiler uses type
304 inference to generate fast code without any type declarations, and uses
305 LLVM's optimization passes and JIT compiler. The
306 <a href="http://julialang.org/"> Julia Language</a> is designed
307 around multiple dispatch, giving programs a large degree of flexibility. It
308 is ready for use on many kinds of problems.</p>
309
310</div>
311
Bill Wendlingf2f92ba2012-05-13 10:00:58 +0000[diff] [blame]312<h3>LLVM D Compiler</h3>
313
314<div>
315
316<p><a href="https://github.com/ldc-developers/ldc">LLVM D Compiler</a> (LDC) is
317 a compiler for the D programming Language. It is based on the DMD frontend
318 and uses LLVM as backend.</p>
319
320</div>
321
Bill Wendling91071052012-05-13 09:55:24 +0000[diff] [blame]322<h3>Open Shading Language</h3>
323
324<div>
325
Benjamin Kramerabe446c2012-05-13 10:21:51 +0000[diff] [blame]326<p><a href="https://github.com/imageworks/OpenShadingLanguage/">Open Shading
327 Language (OSL)</a> is a small but rich language for programmable shading in
328 advanced global illumination renderers and other applications, ideal for
329 describing materials, lights, displacement, and pattern generation. It uses
330 LLVM to JIT complex shader networks to x86 code at runtime.</p>
Bill Wendling91071052012-05-13 09:55:24 +0000[diff] [blame]331
332<p>OSL was developed by Sony Pictures Imageworks for use in its in-house
333 renderer used for feature film animation and visual effects, and is
Benjamin Kramerabe446c2012-05-13 10:21:51 +0000[diff] [blame]334 distributed as open source software with the "New BSD" license.</p>
Bill Wendling91071052012-05-13 09:55:24 +0000[diff] [blame]335
336</div>
337
Bill Wendling59a23e32012-05-13 09:59:27 +0000[diff] [blame]338<h3>Portable OpenCL (pocl)</h3>
339
340<div>
341
342<p>In addition to producing an easily portable open source OpenCL
Benjamin Kramerabe446c2012-05-13 10:21:51 +0000[diff] [blame]343 implementation, another major goal of <a href="http://pocl.sourceforge.net/">
344 pocl</a> is improving performance portability of OpenCL programs with
345 compiler optimizations, reducing the need for target-dependent manual
346 optimizations. An important part of pocl is a set of LLVM passes used to
347 statically parallelize multiple work-items with the kernel compiler, even in
348 the presence of work-group barriers. This enables static parallelization of
349 the fine-grained static concurrency in the work groups in multiple ways
350 (SIMD, VLIW, superscalar,...).</p>
Bill Wendling59a23e32012-05-13 09:59:27 +0000[diff] [blame]351
352</div>
353
Bill Wendlingde86bea2012-05-11 21:42:37 +0000[diff] [blame]354<h3>Pure</h3>
355
356<div>
357
Bill Wendling015d2ad2012-05-11 22:38:33 +0000[diff] [blame]358<p><a href="http://pure-lang.googlecode.com/">Pure</a> is an
359 algebraic/functional programming language based on term rewriting. Programs
360 are collections of equations which are used to evaluate expressions in a
361 symbolic fashion. The interpreter uses LLVM as a backend to JIT-compile Pure
362 programs to fast native code. Pure offers dynamic typing, eager and lazy
363 evaluation, lexical closures, a hygienic macro system (also based on term
364 rewriting), built-in list and matrix support (including list and matrix
365 comprehensions) and an easy-to-use interface to C and other programming
366 languages (including the ability to load LLVM bitcode modules, and inline C,
367 C++, Fortran and Faust code in Pure programs if the corresponding
368 LLVM-enabled compilers are installed).</p>
Bill Wendlingde86bea2012-05-11 21:42:37 +0000[diff] [blame]369
370<p>Pure version 0.54 has been tested and is known to work with LLVM 3.1 (and
371 continues to work with older LLVM releases >= 2.5).</p>
372
373</div>
Bill Wendling644ce532011-10-26 09:25:01 +0000[diff] [blame]374
Bill Wendling59a23e32012-05-13 09:59:27 +0000[diff] [blame]375<h3>TTA-based Co-design Environment (TCE)</h3>
376
377<div>
378
Benjamin Kramerabe446c2012-05-13 10:21:51 +0000[diff] [blame]379<p><a href="http://tce.cs.tut.fi/">TCE</a> is a toolset for designing
380 application-specific processors (ASP) based on the Transport triggered
381 architecture (TTA). The toolset provides a complete co-design flow from C/C++
382 programs down to synthesizable VHDL/Verilog and parallel program binaries.
383 Processor customization points include the register files, function units,
384 supported operations, and the interconnection network.</p>
Bill Wendling59a23e32012-05-13 09:59:27 +0000[diff] [blame]385
386<p>TCE uses Clang and LLVM for C/C++ language support, target independent
387 optimizations and also for parts of code generation. It generates new
388 LLVM-based code generators "on the fly" for the designed TTA processors and
389 loads them in to the compiler backend as runtime libraries to avoid
390 per-target recompilation of larger parts of the compiler chain.</p>
391
392</div>
393
NAKAMURA Takumi074eeaa2011-04-21 01:52:00 +0000[diff] [blame]394</div>
395
Chris Lattner8348b472008-06-08 21:58:17 +0000[diff] [blame]396<!-- *********************************************************************** -->
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]397<h2>
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]398 <a name="whatsnew">What's New in LLVM 3.2?</a>
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]399</h2>
Chris Lattner8348b472008-06-08 21:58:17 +0000[diff] [blame]400<!-- *********************************************************************** -->
401
NAKAMURA Takumi074eeaa2011-04-21 01:52:00 +0000[diff] [blame]402<div>
Chris Lattnerf8e0b4e2008-06-08 22:59:35 +0000[diff] [blame]403
Chris Lattner61358ab2009-10-13 17:48:04 +0000[diff] [blame]404<p>This release includes a huge number of bug fixes, performance tweaks and
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]405 minor improvements. Some of the major improvements and new features are
Bill Wendling7b7fa742011-10-26 18:46:16 +0000[diff] [blame]406 listed in this section.</p>
Chris Lattner61358ab2009-10-13 17:48:04 +0000[diff] [blame]407
Chris Lattner914ce462010-04-22 06:28:20 +0000[diff] [blame]408<!--=========================================================================-->
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]409<h3>
Chris Lattner252b83d2008-02-06 18:00:06 +0000[diff] [blame]410<a name="majorfeatures">Major New Features</a>
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]411</h3>
Chris Lattner252b83d2008-02-06 18:00:06 +0000[diff] [blame]412
NAKAMURA Takumi074eeaa2011-04-21 01:52:00 +0000[diff] [blame]413<div>
Chris Lattner252b83d2008-02-06 18:00:06 +0000[diff] [blame]414
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]415 <!-- Features that need text if they're finished for 3.2:
Chris Lattner1ab8ce92011-11-27 18:47:37 +0000[diff] [blame]416 ARM EHABI
417 combiner-aa?
418 strong phi elim
419 loop dependence analysis
420 CorrelatedValuePropagation
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]421 lib/Transforms/IPO/MergeFunctions.cpp => consider for 3.2.
Chris Lattner1c80fbf2011-11-27 20:51:47 +0000[diff] [blame]422 Integrated assembler on by default for arm/thumb?
423
Chris Lattner1ab8ce92011-11-27 18:47:37 +0000[diff] [blame]424 -->
425
Chris Lattner1c80fbf2011-11-27 20:51:47 +0000[diff] [blame]426 <!-- Near dead:
Chris Lattnerdec23b62011-11-15 22:13:27 +0000[diff] [blame]427 Analysis/RegionInfo.h + Dom Frontiers
428 SparseBitVector: used in LiveVar.
Chris Lattner5a1731d2011-11-27 08:32:32 +0000[diff] [blame]429 llvm/lib/Archive - replace with lib object?
Chris Lattner1c80fbf2011-11-27 20:51:47 +0000[diff] [blame]430 -->
Chris Lattner6a007d12011-11-25 20:33:27 +0000[diff] [blame]431
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]432<p>LLVM 3.2 includes several major changes and big features:</p>
Bill Wendlingbc5f6dd2011-10-26 18:33:01 +0000[diff] [blame]433
Chris Lattner791f77b2008-06-05 06:25:56 +0000[diff] [blame]434<ul>
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]435 <li>...</li>
Chris Lattnerf304ffc2008-02-10 08:17:19 +0000[diff] [blame]436</ul>
Mikhail Glushenkovea65d7d2008-10-13 02:08:34 +0000[diff] [blame]437
Bill Wendlingbc5f6dd2011-10-26 18:33:01 +0000[diff] [blame]438</div>
439
Michael J. Spencer60f790c2011-11-28 18:20:09 +0000[diff] [blame]440
Chris Lattner4f0fe432011-11-27 19:26:30 +0000[diff] [blame]441<!--=========================================================================-->
442<h3>
443<a name="coreimprovements">LLVM IR and Core Improvements</a>
444</h3>
445
446<div>
447
448<p>LLVM IR has several new features for better support of new targets and that
449 expose new optimization opportunities:</p>
450
Bill Wendling1fefd092012-05-14 08:11:53 +0000[diff] [blame]451<ul>
Hans Wennborgff373d72012-07-13 12:44:23 +0000[diff] [blame^]452 <li>Thread local variables may have a specified TLS model. See the
453 <a href="LangRef.html#globalvars">Language Reference Manual</a>.</li>
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]454 <li>...</li>
Bill Wendling1fefd092012-05-14 08:11:53 +0000[diff] [blame]455</ul>
456
Andrew Trick5aab6382011-11-06 17:59:24 +0000[diff] [blame]457</div>
458
459<!--=========================================================================-->
460<h3>
Chris Lattneracce85d2008-02-10 07:46:44 +0000[diff] [blame]461<a name="optimizer">Optimizer Improvements</a>
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]462</h3>
Chris Lattneracce85d2008-02-10 07:46:44 +0000[diff] [blame]463
NAKAMURA Takumi074eeaa2011-04-21 01:52:00 +0000[diff] [blame]464<div>
Chris Lattneracce85d2008-02-10 07:46:44 +0000[diff] [blame]465
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]466<p>In addition to many minor performance tweaks and bug fixes, this release
467 includes a few major enhancements and additions to the optimizers:</p>
Chris Lattneracce85d2008-02-10 07:46:44 +0000[diff] [blame]468
469<ul>
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]470 <li>...</li>
Chris Lattner11b66112010-10-04 02:42:39 +0000[diff] [blame]471</ul>
472
Chris Lattner61358ab2009-10-13 17:48:04 +0000[diff] [blame]473</div>
Chris Lattner917cc712009-03-02 02:37:32 +0000[diff] [blame]474
Chris Lattner0b832202008-06-08 02:45:07 +0000[diff] [blame]475<!--=========================================================================-->
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]476<h3>
Chris Lattner4ba2b652010-09-30 16:31:33 +0000[diff] [blame]477<a name="mc">MC Level Improvements</a>
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]478</h3>
Chris Lattner4ba2b652010-09-30 16:31:33 +0000[diff] [blame]479
NAKAMURA Takumi074eeaa2011-04-21 01:52:00 +0000[diff] [blame]480<div>
Bill Wendling7b7fa742011-10-26 18:46:16 +0000[diff] [blame]481
482<p>The LLVM Machine Code (aka MC) subsystem was created to solve a number of
483 problems in the realm of assembly, disassembly, object file format handling,
484 and a number of other related areas that CPU instruction-set level tools work
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]485 in. For more information, please see the
486 <a href="http://blog.llvm.org/2010/04/intro-to-llvm-mc-project.html">Intro
487 to the LLVM MC Project Blog Post</a>.</p>
Chris Lattner7d9b6b42010-10-02 21:59:30 +0000[diff] [blame]488
Chris Lattner7d9b6b42010-10-02 21:59:30 +0000[diff] [blame]489<ul>
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]490 <li>...</li>
Chris Lattner7d9b6b42010-10-02 21:59:30 +0000[diff] [blame]491</ul>
492
NAKAMURA Takumi45c435a2011-04-05 08:24:22 +0000[diff] [blame]493</div>
Chris Lattner4ba2b652010-09-30 16:31:33 +0000[diff] [blame]494
Chris Lattner4ba2b652010-09-30 16:31:33 +0000[diff] [blame]495<!--=========================================================================-->
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]496<h3>
Chris Lattner511433e2009-03-02 03:24:11 +0000[diff] [blame]497<a name="codegen">Target Independent Code Generator Improvements</a>
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]498</h3>
Chris Lattner0b832202008-06-08 02:45:07 +0000[diff] [blame]499
NAKAMURA Takumi074eeaa2011-04-21 01:52:00 +0000[diff] [blame]500<div>
Chris Lattner0b832202008-06-08 02:45:07 +0000[diff] [blame]501
Bill Wendling190ec9b2012-02-16 10:23:43 +0000[diff] [blame]502<p>We have changed the way that the Type Legalizer legalizes vectors. The type
503 legalizer now attempts to promote integer elements. This enabled the
504 implementation of vector-select. Additionally, we see a performance boost on
505 workloads which use vectors of chars and shorts, since they are now promoted
506 to 32-bit types, which are better supported by the SIMD instruction set.
507 Floating point types are still widened as before.</p>
Nadav Rotem75597662011-12-20 08:02:50 +0000[diff] [blame]508
509
Mikhail Glushenkovf795ef02009-03-01 18:09:47 +0000[diff] [blame]510<p>We have put a significant amount of work into the code generator
Bill Wendling7b7fa742011-10-26 18:46:16 +0000[diff] [blame]511 infrastructure, which allows us to implement more aggressive algorithms and
512 make it run faster:</p>
Chris Lattner0b832202008-06-08 02:45:07 +0000[diff] [blame]513
514<ul>
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]515 <li>...</li>
Chris Lattner84977642007-09-21 03:54:09 +0000[diff] [blame]516</ul>
Bill Wendling190ec9b2012-02-16 10:23:43 +0000[diff] [blame]517
Anshuman Dasgupta4b479552012-04-12 15:17:35 +0000[diff] [blame]518<p> We added new TableGen infrastructure to support bundling for
519 Very Long Instruction Word (VLIW) architectures. TableGen can now
520 automatically generate a deterministic finite automaton from a VLIW
521 target's schedule description which can be queried to determine
522 legal groupings of instructions in a bundle.</p>
523
Anshuman Dasgupta3c1ded22012-04-14 20:59:13 +0000[diff] [blame]524<p> We have added a new target independent VLIW packetizer based on the
Anshuman Dasguptacff391a2012-04-14 20:57:13 +0000[diff] [blame]525 DFA infrastructure to group machine instructions into bundles.</p>
526
Chris Lattner84977642007-09-21 03:54:09 +0000[diff] [blame]527</div>
528
Chandler Carruth268fde42012-04-17 01:10:35 +0000[diff] [blame]529<h4>
530<a name="blockplacement">Basic Block Placement</a>
531</h4>
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]532
Chandler Carruth268fde42012-04-17 01:10:35 +0000[diff] [blame]533<div>
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]534
Chandler Carruth268fde42012-04-17 01:10:35 +0000[diff] [blame]535<p>A probability based block placement and code layout algorithm was added to
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]536 LLVM's code generator. This layout pass supports probabilities derived from
537 static heuristics as well as source code annotations such as
538 <code>__builtin_expect</code>.</p>
539
Chandler Carruth268fde42012-04-17 01:10:35 +0000[diff] [blame]540</div>
541
Chris Lattner917cc712009-03-02 02:37:32 +0000[diff] [blame]542<!--=========================================================================-->
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]543<h3>
Chris Lattner917cc712009-03-02 02:37:32 +0000[diff] [blame]544<a name="x86">X86-32 and X86-64 Target Improvements</a>
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]545</h3>
Chris Lattner917cc712009-03-02 02:37:32 +0000[diff] [blame]546
NAKAMURA Takumi074eeaa2011-04-21 01:52:00 +0000[diff] [blame]547<div>
Bill Wendling7b7fa742011-10-26 18:46:16 +0000[diff] [blame]548
549<p>New features and major changes in the X86 target include:</p>
Chris Lattner917cc712009-03-02 02:37:32 +0000[diff] [blame]550
551<ul>
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]552 <li>...</li>
Chris Lattner917cc712009-03-02 02:37:32 +0000[diff] [blame]553</ul>
554
Chris Lattner917cc712009-03-02 02:37:32 +0000[diff] [blame]555</div>
Chris Lattner84977642007-09-21 03:54:09 +0000[diff] [blame]556
557<!--=========================================================================-->
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]558<h3>
Chris Lattner61358ab2009-10-13 17:48:04 +0000[diff] [blame]559<a name="ARM">ARM Target Improvements</a>
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]560</h3>
Chris Lattnerc441fb82009-03-01 02:30:21 +0000[diff] [blame]561
NAKAMURA Takumi074eeaa2011-04-21 01:52:00 +0000[diff] [blame]562<div>
Bill Wendling7b7fa742011-10-26 18:46:16 +0000[diff] [blame]563
564<p>New features of the ARM target include:</p>
Chris Lattnerc441fb82009-03-01 02:30:21 +0000[diff] [blame]565
566<ul>
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]567 <li>...</li>
Jim Grosbach6e6b8222012-02-23 23:52:06 +0000[diff] [blame]568</ul>
Chris Lattner7b95c382011-11-15 22:23:46 +0000[diff] [blame]569
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]570<!--_________________________________________________________________________-->
571
Jim Grosbach6e6b8222012-02-23 23:52:06 +0000[diff] [blame]572<h4>
573<a name="armintegratedassembler">ARM Integrated Assembler</a>
574</h4>
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]575
Jim Grosbach6e6b8222012-02-23 23:52:06 +0000[diff] [blame]576<div>
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]577
Jim Grosbach6e6b8222012-02-23 23:52:06 +0000[diff] [blame]578<p>The ARM target now includes a full featured macro assembler, including
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]579 direct-to-object module support for clang. The assembler is currently enabled
580 by default for Darwin only pending testing and any additional necessary
581 platform specific support for Linux.</p>
Michael J. Spencer60f790c2011-11-28 18:20:09 +0000[diff] [blame]582
Jim Grosbach6e6b8222012-02-23 23:52:06 +0000[diff] [blame]583<p>Full support is included for Thumb1, Thumb2 and ARM modes, along with
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]584 subtarget and CPU specific extensions for VFP2, VFP3 and NEON.</p>
Jim Grosbach6e6b8222012-02-23 23:52:06 +0000[diff] [blame]585
586<p>The assembler is Unified Syntax only (see ARM Architecural Reference Manual
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]587 for details). While there is some, and growing, support for pre-unfied
588 (divided) syntax, there are still significant gaps in that support.</p>
589
Jim Grosbach6e6b8222012-02-23 23:52:06 +0000[diff] [blame]590</div>
NAKAMURA Takumi9c55f592012-03-27 11:25:16 +0000[diff] [blame]591
592</div>
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]593
Chris Lattner1efe27e2011-04-06 00:45:11 +0000[diff] [blame]594<!--=========================================================================-->
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]595<h3>
Akira Hatanaka5381cbf2011-11-15 21:33:05 +0000[diff] [blame]596<a name="MIPS">MIPS Target Improvements</a>
597</h3>
598
599<div>
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]600
601<p>New features and major changes in the MIPS target include:</p>
Akira Hatanaka5381cbf2011-11-15 21:33:05 +0000[diff] [blame]602
603<ul>
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]604 <li>...</li>
Akira Hatanaka5381cbf2011-11-15 21:33:05 +0000[diff] [blame]605</ul>
Justin Holewinskidc23c142012-05-13 17:32:35 +0000[diff] [blame]606
607</div>
608
609<!--=========================================================================-->
610<h3>
Chris Lattner1efe27e2011-04-06 00:45:11 +0000[diff] [blame]611<a name="OtherTS">Other Target Specific Improvements</a>
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]612</h3>
Chris Lattnerc441fb82009-03-01 02:30:21 +0000[diff] [blame]613
NAKAMURA Takumi074eeaa2011-04-21 01:52:00 +0000[diff] [blame]614<div>
Bill Wendling7b7fa742011-10-26 18:46:16 +0000[diff] [blame]615
Chris Lattner1efe27e2011-04-06 00:45:11 +0000[diff] [blame]616<ul>
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]617 <li>...</li>
Chris Lattner1efe27e2011-04-06 00:45:11 +0000[diff] [blame]618</ul>
Bill Wendling7b7fa742011-10-26 18:46:16 +0000[diff] [blame]619
Chris Lattner1efe27e2011-04-06 00:45:11 +0000[diff] [blame]620</div>
Chris Lattner77d29b12008-06-05 08:02:49 +0000[diff] [blame]621
622<!--=========================================================================-->
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]623<h3>
Chris Lattnerf6662f92008-10-13 17:57:36 +0000[diff] [blame]624<a name="changes">Major Changes and Removed Features</a>
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]625</h3>
Chris Lattnerf6662f92008-10-13 17:57:36 +0000[diff] [blame]626
NAKAMURA Takumi074eeaa2011-04-21 01:52:00 +0000[diff] [blame]627<div>
Chris Lattnerf6662f92008-10-13 17:57:36 +0000[diff] [blame]628
Bill Wendling2626dba2011-08-03 22:18:20 +0000[diff] [blame]629<p>If you're already an LLVM user or developer with out-of-tree changes based on
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]630 LLVM 3.2, this section lists some "gotchas" that you may run into upgrading
Bill Wendling2626dba2011-08-03 22:18:20 +0000[diff] [blame]631 from the previous release.</p>
Chris Lattnerf6662f92008-10-13 17:57:36 +0000[diff] [blame]632
633<ul>
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]634 <li>...</li>
Devang Patelb34dd132008-10-14 20:03:43 +0000[diff] [blame]635</ul>
Chris Lattnerf6662f92008-10-13 17:57:36 +0000[diff] [blame]636
Chris Lattnerf6662f92008-10-13 17:57:36 +0000[diff] [blame]637</div>
638
Daniel Dunbarf0233c62010-10-04 20:11:41 +0000[diff] [blame]639<!--=========================================================================-->
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]640<h3>
Chris Lattner1efe27e2011-04-06 00:45:11 +0000[diff] [blame]641<a name="api_changes">Internal API Changes</a>
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]642</h3>
Daniel Dunbarf0233c62010-10-04 20:11:41 +0000[diff] [blame]643
NAKAMURA Takumi074eeaa2011-04-21 01:52:00 +0000[diff] [blame]644<div>
Daniel Dunbarf0233c62010-10-04 20:11:41 +0000[diff] [blame]645
Chris Lattner1efe27e2011-04-06 00:45:11 +0000[diff] [blame]646<p>In addition, many APIs have changed in this release. Some of the major
Bill Wendling16005252011-08-02 06:20:17 +0000[diff] [blame]647 LLVM API changes are:</p>
Daniel Dunbarf0233c62010-10-04 20:11:41 +0000[diff] [blame]648
649<ul>
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]650 <li>...</li>
Daniel Dunbarf0233c62010-10-04 20:11:41 +0000[diff] [blame]651</ul>
Bill Wendling7b7fa742011-10-26 18:46:16 +0000[diff] [blame]652
Daniel Dunbarf0233c62010-10-04 20:11:41 +0000[diff] [blame]653</div>
Chris Lattnerf6662f92008-10-13 17:57:36 +0000[diff] [blame]654
Nadav Rotemfdc309c2012-02-26 08:35:53 +0000[diff] [blame]655<!--=========================================================================-->
656<h3>
657<a name="tools_changes">Tools Changes</a>
658</h3>
659
660<div>
661
662<p>In addition, some tools have changed in this release. Some of the changes
663 are:</p>
664
Nadav Rotemfdc309c2012-02-26 08:35:53 +0000[diff] [blame]665<ul>
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]666 <li>...</li>
Nadav Rotemfdc309c2012-02-26 08:35:53 +0000[diff] [blame]667</ul>
668
669</div>
670
Gregory Szorcca347492012-05-12 21:12:22 +0000[diff] [blame]671
672<!--=========================================================================-->
673<h3>
674<a name="python">Python Bindings</a>
675</h3>
676
677<div>
678
679<p>Officially supported Python bindings have been added! Feature support is far
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]680 from complete. The current bindings support interfaces to:</p>
681
Gregory Szorcca347492012-05-12 21:12:22 +0000[diff] [blame]682<ul>
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]683 <li>...</li>
Gregory Szorcca347492012-05-12 21:12:22 +0000[diff] [blame]684</ul>
685
Gregory Szorcca347492012-05-12 21:12:22 +0000[diff] [blame]686</div>
687
Nadav Rotemfdc309c2012-02-26 08:35:53 +0000[diff] [blame]688</div>
689
Chris Lattner79c3fe12003-10-02 04:57:28 +0000[diff] [blame]690<!-- *********************************************************************** -->
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]691<h2>
Misha Brukman500bc302003-11-22 00:38:41 +0000[diff] [blame]692 <a name="knownproblems">Known Problems</a>
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]693</h2>
Chris Lattner79c3fe12003-10-02 04:57:28 +0000[diff] [blame]694<!-- *********************************************************************** -->
695
NAKAMURA Takumi074eeaa2011-04-21 01:52:00 +0000[diff] [blame]696<div>
Misha Brukman500bc302003-11-22 00:38:41 +0000[diff] [blame]697
Chris Lattner70e22012011-11-27 19:38:20 +0000[diff] [blame]698<p>LLVM is generally a production quality compiler, and is used by a broad range
699 of applications and shipping in many products. That said, not every
700 subsystem is as mature as the aggregate, particularly the more obscure
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]701 targets. If you run into a problem, please check
702 the <a href="http://llvm.org/bugs/">LLVM bug database</a> and submit a bug if
703 there isn't already one or ask on
704 the <a href="http://lists.cs.uiuc.edu/mailman/listinfo/llvmdev">LLVMdev
705 list</a>.</p>
Michael J. Spencer60f790c2011-11-28 18:20:09 +0000[diff] [blame]706
Chris Lattner70e22012011-11-27 19:38:20 +0000[diff] [blame]707 <p>Known problem areas include:</p>
Michael J. Spencer60f790c2011-11-28 18:20:09 +0000[diff] [blame]708
Chris Lattnerf5ee1702004-03-14 02:03:02 +0000[diff] [blame]709<ul>
Benjamin Kramer5fdfaf52012-05-13 11:28:46 +0000[diff] [blame]710 <li>The CellSPU, MSP430, PTX and XCore backends are experimental.</li>
Bill Wendling7b7fa742011-10-26 18:46:16 +0000[diff] [blame]711
Chris Lattner70e22012011-11-27 19:38:20 +0000[diff] [blame]712 <li>The integrated assembler, disassembler, and JIT is not supported by
Bill Wendling7a437a02012-05-24 06:38:09 +0000[diff] [blame]713 several targets. If an integrated assembler is not supported, then a
Chris Lattner70e22012011-11-27 19:38:20 +0000[diff] [blame]714 system assembler is required. For more details, see the <a
715 href="CodeGenerator.html#targetfeatures">Target Features Matrix</a>.
716 </li>
Chris Lattner26299222006-11-18 07:51:14 +0000[diff] [blame]717</ul>
718
719</div>
John Criswellc0c186d2005-11-08 21:11:33 +0000[diff] [blame]720
Chris Lattner79c3fe12003-10-02 04:57:28 +0000[diff] [blame]721<!-- *********************************************************************** -->
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]722<h2>
Misha Brukman500bc302003-11-22 00:38:41 +0000[diff] [blame]723 <a name="additionalinfo">Additional Information</a>
NAKAMURA Takumi06c6d9a2011-04-18 01:17:51 +0000[diff] [blame]724</h2>
Chris Lattner79c3fe12003-10-02 04:57:28 +0000[diff] [blame]725<!-- *********************************************************************** -->
726
NAKAMURA Takumi074eeaa2011-04-21 01:52:00 +0000[diff] [blame]727<div>
Misha Brukman500bc302003-11-22 00:38:41 +0000[diff] [blame]728
Bill Wendling7b7fa742011-10-26 18:46:16 +0000[diff] [blame]729<p>A wide variety of additional information is available on
730 the <a href="http://llvm.org/">LLVM web page</a>, in particular in
731 the <a href="http://llvm.org/docs/">documentation</a> section. The web page
732 also contains versions of the API documentation which is up-to-date with the
733 Subversion version of the source code. You can access versions of these
734 documents specific to this release by going into the "<tt>llvm/doc/</tt>"
735 directory in the LLVM tree.</p>
Chris Lattner79c3fe12003-10-02 04:57:28 +0000[diff] [blame]736
Misha Brukman500bc302003-11-22 00:38:41 +0000[diff] [blame]737<p>If you have any questions or comments about LLVM, please feel free to contact
Bill Wendling7b7fa742011-10-26 18:46:16 +0000[diff] [blame]738 us via the <a href="http://llvm.org/docs/#maillist"> mailing lists</a>.</p>
Chris Lattner79c3fe12003-10-02 04:57:28 +0000[diff] [blame]739
Misha Brukman500bc302003-11-22 00:38:41 +0000[diff] [blame]740</div>
Chris Lattner79c3fe12003-10-02 04:57:28 +0000[diff] [blame]741
742<!-- *********************************************************************** -->
Chris Lattner79c3fe12003-10-02 04:57:28 +0000[diff] [blame]743
Misha Brukman500bc302003-11-22 00:38:41 +0000[diff] [blame]744<hr>
Misha Brukman2061e892003-11-22 01:23:39 +0000[diff] [blame]745<address>
Misha Brukman38847d52003-12-21 22:53:21 +0000[diff] [blame]746 <a href="http://jigsaw.w3.org/css-validator/check/referer"><img
Misha Brukman44408702008-12-11 17:34:48 +0000[diff] [blame]747 src="http://jigsaw.w3.org/css-validator/images/vcss-blue" alt="Valid CSS"></a>
Misha Brukman2061e892003-11-22 01:23:39 +0000[diff] [blame]748 <a href="http://validator.w3.org/check/referer"><img
Misha Brukman44408702008-12-11 17:34:48 +0000[diff] [blame]749 src="http://www.w3.org/Icons/valid-html401-blue" alt="Valid HTML 4.01"></a>
Misha Brukman2061e892003-11-22 01:23:39 +0000[diff] [blame]750
Chris Lattnerb4b0ce72007-05-18 00:44:29 +0000[diff] [blame]751 <a href="http://llvm.org/">LLVM Compiler Infrastructure</a><br>
Misha Brukman500bc302003-11-22 00:38:41 +0000[diff] [blame]752 Last modified: $Date$
Misha Brukman2061e892003-11-22 01:23:39 +0000[diff] [blame]753</address>
Chris Lattner79c3fe12003-10-02 04:57:28 +0000[diff] [blame]754
Misha Brukman500bc302003-11-22 00:38:41 +0000[diff] [blame]755</body>
756</html>