blob: 85398d4fca68b848118cd3309f3af78eac2b84c3 [file] [log] [blame]
Reid Spencerab926de2006-03-23 06:45:42 +00001<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
2 "http://www.w3.org/TR/html4/strict.dtd">
3<html>
4<head>
5 <title>How To Release LLVM To The Public</title>
6 <link rel="stylesheet" href="llvm.css" type="text/css">
7</head>
8<body>
9
10<div class="doc_title">How To Release LLVM To The Public</div>
Reid Spencerab926de2006-03-23 06:45:42 +000011<ol>
12 <li><a href="#introduction">Introduction</a></li>
Tanya Lattner7fb16162009-08-18 22:33:28 +000013 <li><a href="#criteria">Qualification Criteria</a></li>
Tanya Lattner586eb8e2007-09-28 22:50:54 +000014 <li><a href="#introduction">Release Timeline</a></li>
Misha Brukman3df07812006-04-10 21:43:05 +000015 <li><a href="#process">Release Process</a></li>
Reid Spencerab926de2006-03-23 06:45:42 +000016</ol>
17<div class="doc_author">
Tanya Lattner7fb16162009-08-18 22:33:28 +000018 <p>Written by <a href="mailto:tonic@nondot.org">Tanya Lattner</a>,
19 <a href="mailto:rspencer@x10sys.com">Reid Spencer</a>,
Bill Wendlingb3294fa2011-02-28 01:10:44 +000020 <a href="mailto:criswell@cs.uiuc.edu">John Criswell</a>, &amp;
21 <a href="mailto:wendling@apple.com">Bill Wendling</a>
Tanya Lattner7fb16162009-08-18 22:33:28 +000022 </p>
Reid Spencerab926de2006-03-23 06:45:42 +000023</div>
24
25<!-- *********************************************************************** -->
26<div class="doc_section"><a name="introduction">Introduction</a></div>
27<!-- *********************************************************************** -->
28
29<div class="doc_text">
Bill Wendlingb3294fa2011-02-28 01:10:44 +000030
31<p>This document contains information about successfully releasing LLVM &mdash;
32 including subprojects: e.g., <tt>llvm-gcc</tt> and <tt>clang</tt> &mdash; to
33 the public. It is the Release Manager's responsibility to ensure that a high
34 quality build of LLVM is released.</p>
35
Reid Spencerab926de2006-03-23 06:45:42 +000036</div>
37
38<!-- *********************************************************************** -->
Tanya Lattner586eb8e2007-09-28 22:50:54 +000039<div class="doc_section"><a name="process">Release Timeline</a></div>
40<!-- *********************************************************************** -->
41<div class="doc_text">
Tanya Lattner586eb8e2007-09-28 22:50:54 +000042
Bill Wendlingb3294fa2011-02-28 01:10:44 +000043<p>LLVM is released on a time based schedule &mdash; roughly every 6 months. We
44 do not normally have dot releases because of the nature of LLVM's incremental
45 development philosophy. That said, the only thing preventing dot releases for
46 critical bug fixes from happening is a lack of resources &mdash; testers,
47 machines, time, etc. And, because of the high quality we desire for LLVM
48 releases, we cannot allow for a truncated form of release qualification.</p>
49
50<p>The release process is roughly as follows:</p>
51
52<ul>
53 <li><p>Set code freeze and branch creation date for 6 months after last code
54 freeze date. Announce release schedule to the LLVM community and update
55 the website.</p></li>
56
57 <li><p>Create release branch and begin release process.</p></li>
58
59 <li><p>Send out release candidate sources for first round of testing. Testing
60 lasts 7-10 days. During the first round of testing, any regressions found
61 should be fixed. Patches are merged from mainline into the release
62 branch. Also, all features need to be completed during this time. Any
63 features not completed at the end of the first round of testing will be
64 removed or disabled for the release.</p></li>
65
66 <li><p>Generate and send out the second release candidate sources. Only
67 <em>critial</em> bugs found during this testing phase will be fixed. Any
68 bugs introduced by merged patches will be fixed. If so a third round of
69 testing is needed.</p></li>
70
71 <li><p>The release notes are updated.</p></li>
72
73 <li><p>Finally, release!</p></li>
74</ul>
75
76</div>
Tanya Lattner586eb8e2007-09-28 22:50:54 +000077
78<!-- *********************************************************************** -->
Reid Spencerab926de2006-03-23 06:45:42 +000079<div class="doc_section"><a name="process">Release Process</a></div>
80<!-- *********************************************************************** -->
81
Reid Spencerab926de2006-03-23 06:45:42 +000082<div class="doc_text">
Bill Wendlingb3294fa2011-02-28 01:10:44 +000083
84<ol>
NAKAMURA Takumi6bd36d52011-04-09 09:51:57 +000085 <li><a href="#release-admin">Release Administrative Tasks</a>
Reid Spencerab926de2006-03-23 06:45:42 +000086 <ol>
Tanya Lattner586eb8e2007-09-28 22:50:54 +000087 <li><a href="#branch">Create Release Branch</a></li>
Tanya Lattner7fb16162009-08-18 22:33:28 +000088 <li><a href="#verchanges">Update Version Numbers</a></li>
Bill Wendlingb3294fa2011-02-28 01:10:44 +000089 </ol>
NAKAMURA Takumi6bd36d52011-04-09 09:51:57 +000090 </li>
91 <li><a href="#release-build">Building the Release</a>
Bill Wendlingb3294fa2011-02-28 01:10:44 +000092 <ol>
Tanya Lattner586eb8e2007-09-28 22:50:54 +000093 <li><a href="#dist">Build the LLVM Source Distributions</a></li>
Misha Brukman3df07812006-04-10 21:43:05 +000094 <li><a href="#build">Build LLVM</a></li>
Tanya Lattner7fb16162009-08-18 22:33:28 +000095 <li><a href="#llvmgccbin">Build the LLVM-GCC Binary Distribution</a></li>
96 <li><a href="#clangbin">Build the Clang Binary Distribution</a></li>
97 <li><a href="#target-build">Target Specific Build Details</a></li>
Bill Wendlingb3294fa2011-02-28 01:10:44 +000098 </ol>
NAKAMURA Takumi6bd36d52011-04-09 09:51:57 +000099 </li>
100 <li><a href="#release-qualify">Release Qualification Criteria</a>
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000101 <ol>
Tanya Lattner7fb16162009-08-18 22:33:28 +0000102 <li><a href="#llvm-qualify">Qualify LLVM</a></li>
103 <li><a href="#llvmgcc-qualify">Qualify LLVM-GCC</a></li>
104 <li><a href="#clang-qualify">Qualify Clang</a></li>
105 <li><a href="#targets">Specific Target Qualification Details</a></li>
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000106 </ol>
NAKAMURA Takumi6bd36d52011-04-09 09:51:57 +0000107 </li>
Tanya Lattner7fb16162009-08-18 22:33:28 +0000108
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000109 <li><a href="#commTest">Community Testing</a></li>
110 <li><a href="#release-patch">Release Patch Rules</a></li>
NAKAMURA Takumi6bd36d52011-04-09 09:51:57 +0000111 <li><a href="#release-final">Release final tasks</a>
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000112 <ol>
Tanya Lattner586eb8e2007-09-28 22:50:54 +0000113 <li><a href="#updocs">Update Documentation</a></li>
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000114 <li><a href="#tag">Tag the LLVM Final Release</a></li>
Tanya Lattner586eb8e2007-09-28 22:50:54 +0000115 <li><a href="#updemo">Update the LLVM Demo Page</a></li>
Tanya Lattnerb3b1dab2006-08-10 00:23:05 +0000116 <li><a href="#webupdates">Update the LLVM Website</a></li>
Tanya Lattner586eb8e2007-09-28 22:50:54 +0000117 <li><a href="#announce">Announce the Release</a></li>
Reid Spencerab926de2006-03-23 06:45:42 +0000118 </ol>
NAKAMURA Takumi6bd36d52011-04-09 09:51:57 +0000119 </li>
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000120</ol>
121
Reid Spencerab926de2006-03-23 06:45:42 +0000122</div>
123
124<!-- ======================================================================= -->
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000125<div class="doc_subsection"><a name="release-admin">Release Administrative Tasks</a></div>
Tanya Lattner7fb16162009-08-18 22:33:28 +0000126
127<div class="doc_text">
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000128
129<p>This section describes a few administrative tasks that need to be done for
130 the release process to begin. Specifically, it involves:</p>
131
132<ul>
133 <li>Creating the release branch,</li>
134 <li>Setting version numbers, and</li>
135 <li>Tagging release candidates for the release team to begin testing</li>
136</ul>
137
Tanya Lattner7fb16162009-08-18 22:33:28 +0000138</div>
139
140<!-- ======================================================================= -->
141<div class="doc_subsubsection"><a name="branch">Create Release Branch</a></div>
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000142
John Criswell4b8dfb92006-04-11 20:24:28 +0000143<div class="doc_text">
John Criswell4b8dfb92006-04-11 20:24:28 +0000144
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000145<p>Branch the Subversion trunk using the following procedure:</p>
John Criswell4b8dfb92006-04-11 20:24:28 +0000146
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000147<ol>
148 <li><p>Remind developers that the release branching is imminent and to refrain
149 from committing patches that might break the build. E.g., new features,
150 large patches for works in progress, an overhaul of the type system, an
151 exciting new TableGen feature, etc.</p></li>
152
153 <li><p>Verify that the current Subversion trunk is in decent shape by
154 examining nightly tester and buildbot results.</p></li>
155
156 <li><p>Create the release branch for <tt>llvm</tt>, <tt>llvm-gcc-4.2</tt>,
157 <tt>clang</tt>, and the <tt>test-suite</tt> from the last known good
158 revision. The branch's name is <tt>release_XY</tt>, where <tt>X</tt> is
159 the major and <tt>Y</tt> the minor release numbers. The branches should be
160 created using the following commands:</p>
161
Bill Wendling922169c2007-07-23 04:41:42 +0000162<div class="doc_code">
163<pre>
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000164$ svn copy https://llvm.org/svn/llvm-project/llvm/trunk \
165 https://llvm.org/svn/llvm-project/llvm/branches/release_<i>XY</i>
166
167$ svn copy https://llvm.org/svn/llvm-project/llvm-gcc-4.2/trunk \
168 https://llvm.org/svn/llvm-project/llvm-gcc-4.2/branches/release_<i>XY</i>
169
170$ svn copy https://llvm.org/svn/llvm-project/test-suite/trunk \
171 https://llvm.org/svn/llvm-project/test-suite/branches/release_<i>XY</i>
172
173$ svn copy https://llvm.org/svn/llvm-project/cfe/trunk \
174 https://llvm.org/svn/llvm-project/cfe/branches/release_<i>XY</i>
Bill Wendling922169c2007-07-23 04:41:42 +0000175</pre>
Bill Wendling803a6392007-07-23 04:44:02 +0000176</div></li>
Tanya Lattner586eb8e2007-09-28 22:50:54 +0000177
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000178 <li><p>Advise developers that they may now check their patches into the
179 Subversion tree again.</p></li>
180
181 <li><p>The Release Manager should switch to the release branch, because all
182 changes to the release will now be done in the branch. The easiest way to
183 do this is to grab a working copy using the following commands:</p>
184
185<div class="doc_code">
186<pre>
187$ svn co https://llvm.org/svn/llvm-project/llvm/branches/release_<i>XY</i> llvm-<i>X.Y</i>
188
189$ svn co https://llvm.org/svn/llvm-project/llvm-gcc-4.2/branches/release_<i>XY</i> llvm-gcc-4.2-<i>X.Y</i>
190
191$ svn co https://llvm.org/svn/llvm-project/test-suite/branches/release_<i>XY</i> test-suite-<i>X.Y</i>
192
193$ svn co https://llvm.org/svn/llvm-project/cfe/branches/release_<i>XY</i> clang-<i>X.Y</i>
194</pre>
195</div></li>
196</ol>
197
Reid Spencerab926de2006-03-23 06:45:42 +0000198</div>
199
200<!-- ======================================================================= -->
Tanya Lattner7fb16162009-08-18 22:33:28 +0000201<div class="doc_subsubsection"><a name="verchanges">Update LLVM Version</a></div>
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000202
Tanya Lattnerb3b1dab2006-08-10 00:23:05 +0000203<div class="doc_text">
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000204
205<p>After creating the LLVM release branch, update the release branches'
206 <tt>autoconf</tt> and <tt>configure.ac</tt> versions from '<tt>X.Ysvn</tt>'
207 to '<tt>X.Y</tt>'. Update it on mainline as well to be the next version
208 ('<tt>X.Y+1svn</tt>'). Regenerate the configure scripts for both
209 <tt>llvm</tt> and the <tt>test-suite</tt>.</p>
210
211<p>In addition, the version numbers of all the Bugzilla components must be
212 updated for the next release.</p>
213
Reid Spencerab926de2006-03-23 06:45:42 +0000214</div>
215
216<!-- ======================================================================= -->
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000217<div class="doc_subsubsection"><a name="dist">Build the LLVM Release Candidates</a></div>
218
Reid Spencerab926de2006-03-23 06:45:42 +0000219<div class="doc_text">
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000220
221<p>Create release candidates for <tt>llvm</tt>, <tt>llvm-gcc</tt>,
222 <tt>clang</tt>, and the LLVM <tt>test-suite</tt> by tagging the branch with
223 the respective release candidate number. For instance, to create <b>Release
224 Candidate 1</b> you would issue the following commands:</p>
Reid Spencerab926de2006-03-23 06:45:42 +0000225
Bill Wendling922169c2007-07-23 04:41:42 +0000226<div class="doc_code">
227<pre>
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000228$ svn mkdir https://llvm.org/svn/llvm-project/llvm/tags/RELEASE_<i>XY</i>
229$ svn copy https://llvm.org/svn/llvm-project/llvm/branches/release_<i>XY</i> \
Bill Wendling47858852011-03-07 07:37:12 +0000230 https://llvm.org/svn/llvm-project/llvm/tags/RELEASE_<i>XY</i>/rc1
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000231
232$ svn mkdir https://llvm.org/svn/llvm-project/llvm-gcc-4.2/tags/RELEASE_<i>XY</i>
233$ svn copy https://llvm.org/svn/llvm-project/llvm-gcc-4.2/branches/release_<i>XY</i> \
Bill Wendling47858852011-03-07 07:37:12 +0000234 https://llvm.org/svn/llvm-project/llvm-gcc-4.2/tags/RELEASE_<i>XY</i>/rc1
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000235
236$ svn mkdir https://llvm.org/svn/llvm-project/test-suite/tags/RELEASE_<i>XY</i>
237$ svn copy https://llvm.org/svn/llvm-project/test-suite/branches/release_<i>XY</i> \
Bill Wendling47858852011-03-07 07:37:12 +0000238 https://llvm.org/svn/llvm-project/test-suite/tags/RELEASE_<i>XY</i>/rc1
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000239
240$ svn mkdir https://llvm.org/svn/llvm-project/cfe/tags/RELEASE_<i>XY</i>
241$ svn copy https://llvm.org/svn/llvm-project/cfe/branches/release_<i>XY</i> \
Bill Wendling47858852011-03-07 07:37:12 +0000242 https://llvm.org/svn/llvm-project/cfe/tags/RELEASE_<i>XY</i>/rc1
Bill Wendling922169c2007-07-23 04:41:42 +0000243</pre>
244</div>
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000245
246<p>Similarly, <b>Release Candidate 2</b> would be named <tt>RC2</tt> and so
247 on. This keeps a permanent copy of the release candidate around for people to
248 export and build as they wish. The final released sources will be tagged in
249 the <tt>RELEASE_<i>XY</i></tt> directory as <tt>Final</tt>
250 (c.f. <a href="#tag">Tag the LLVM Final Release</a>).</p>
251
252<p>The Release Manager may supply pre-packaged source tarballs for users. This
253 can be done with the following commands:</p>
254
255<div class="doc_code">
256<pre>
Bill Wendling47858852011-03-07 07:37:12 +0000257$ svn export https://llvm.org/svn/llvm-project/llvm/tags/RELEASE_<i>XY</i>/rc1 llvm-<i>X.Y</i>rc1
258$ svn export https://llvm.org/svn/llvm-project/llvm-gcc-4.2/tags/RELEASE_<i>XY</i>/rc1 llvm-gcc4.2-<i>X.Y</i>rc1
259$ svn export https://llvm.org/svn/llvm-project/test-suite/tags/RELEASE_<i>XY</i>/rc1 llvm-test-<i>X.Y</i>rc1
260$ svn export https://llvm.org/svn/llvm-project/cfe/tags/RELEASE_<i>XY</i>/rc1 clang-<i>X.Y</i>rc1
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000261
Bill Wendlingce2fccf2011-03-25 06:43:59 +0000262$ tar -cvf - llvm-<i>X.Y</i>rc1 | gzip &gt; llvm-<i>X.Y</i>rc1.src.tar.gz
263$ tar -cvf - llvm-test-<i>X.Y</i>rc1 | gzip &gt; llvm-test-<i>X.Y</i>rc1.src.tar.gz
264$ tar -cvf - llvm-gcc4.2-<i>X.Y</i>rc1 | gzip &gt; llvm-gcc-4.2-<i>X.Y</i>rc1.src.tar.gz
265$ tar -cvf - clang-<i>X.Y</i>rc1 | gzip &gt; clang-<i>X.Y</i>rc1.src.tar.gz
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000266</pre>
267</div>
268
Reid Spencer34ddd282006-08-16 00:54:50 +0000269</div>
Reid Spencerab926de2006-03-23 06:45:42 +0000270
Reid Spencer34ddd282006-08-16 00:54:50 +0000271<!-- ======================================================================= -->
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000272<div class="doc_subsection"><a name="release-build">Building the Release</a></div>
Tanya Lattner7fb16162009-08-18 22:33:28 +0000273
274<div class="doc_text">
Tanya Lattner82e57a62009-08-23 04:36:30 +0000275
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000276<p>The builds of <tt>llvm</tt>, <tt>llvm-gcc</tt>, and <tt>clang</tt>
277 <em>must</em> be free of errors and warnings in Debug, Release+Asserts, and
278 Release builds. If all builds are clean, then the release passes Build
279 Qualification.</p>
280
281<p>The <tt>make</tt> options for building the different modes:</p>
282
283<table>
284 <tr><th>Mode</th><th>Options</th></tr>
285 <tr align="left"><td>Debug</td><td><tt>ENABLE_OPTIMIZED=0</tt></td></tr>
286 <tr align="left"><td>Release+Asserts</td><td><tt>ENABLE_OPTIMIZED=1</tt></td></tr>
287 <tr align="left"><td>Release</td><td><tt>ENABLE_OPTIMIZED=1 DISABLE_ASSERTIONS=1</tt></td></tr>
288</table>
289
Tanya Lattner7fb16162009-08-18 22:33:28 +0000290</div>
291
292<!-- ======================================================================= -->
293<div class="doc_subsubsection"><a name="build">Build LLVM</a></div>
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000294
Tanya Lattner586eb8e2007-09-28 22:50:54 +0000295<div class="doc_text">
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000296
297<p>Build <tt>Debug</tt>, <tt>Release+Asserts</tt>, and <tt>Release</tt> versions
298 of <tt>llvm</tt> on all supported platforms. Directions to build
299 <tt>llvm</tt> are
NAKAMURA Takumica46f5a2011-04-09 02:13:37 +0000300 <a href="GettingStarted.html#quickstart">here</a>.</p>
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000301
Tanya Lattner586eb8e2007-09-28 22:50:54 +0000302</div>
303
304<!-- ======================================================================= -->
Tanya Lattner7fb16162009-08-18 22:33:28 +0000305<div class="doc_subsubsection"><a name="llvmgccbin">Build the LLVM GCC Binary Distribution</a></div>
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000306
Tanya Lattner586eb8e2007-09-28 22:50:54 +0000307<div class="doc_text">
Tanya Lattner586eb8e2007-09-28 22:50:54 +0000308
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000309<p>Creating the <tt>llvm-gcc</tt> binary distribution (Release/Optimized)
310 requires performing the following steps for each supported platform:</p>
Tanya Lattner586eb8e2007-09-28 22:50:54 +0000311
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000312<ol>
313 <li><p>Build the <tt>llvm-gcc</tt> front-end by following the directions in
314 the <tt>README.LLVM</tt> file. The front-end must be compiled with C, C++,
315 Objective-C (Mac only), Objective-C++ (Mac only), and Fortran
316 support.</p></li>
317
318 <li><p>Boostrapping must be enabled.</p></li>
319
320 <li><p>Be sure to build with <tt>LLVM_VERSION_INFO=X.Y</tt>, where <tt>X</tt>
321 is the major and <tt>Y</tt> is the minor release numbers.</p></li>
322
323 <li><p>Copy the installation directory to a directory named for the specific
324 target. For example on Red Hat Enterprise Linux, the directory would be
325 named <tt>llvm-gcc4.2-2.6-x86-linux-RHEL4</tt>. Archive and compress the
326 new directory.</p></li>
327</ol>
328
Tanya Lattner586eb8e2007-09-28 22:50:54 +0000329</div>
330
331<!-- ======================================================================= -->
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000332<div class="doc_subsubsection"><a name="clangbin">Build Clang Binary Distribution</a></div>
333
Tanya Lattner586eb8e2007-09-28 22:50:54 +0000334<div class="doc_text">
Tanya Lattner586eb8e2007-09-28 22:50:54 +0000335
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000336<p>Creating the <tt>clang</tt> binary distribution
337 (Debug/Release+Asserts/Release) requires performing the following steps for
338 each supported platform:</p>
Tanya Lattner7fb16162009-08-18 22:33:28 +0000339
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000340<ol>
341 <li>Build clang according to the directions
342 <a href="http://clang.llvm.org/get_started.html">here</a>.</li>
343
344 <li>Build both a debug and release version of clang. The binary will be the
345 release build.</lI>
346
347 <li>Package <tt>clang</tt> (details to follow).</li>
348</ol>
349
Tanya Lattner7fb16162009-08-18 22:33:28 +0000350</div>
351
Tanya Lattner7fb16162009-08-18 22:33:28 +0000352<!-- ======================================================================= -->
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000353<div class="doc_subsubsection"><a name="target-build">Target Specific Build Details</a></div>
354
Tanya Lattner7fb16162009-08-18 22:33:28 +0000355<div class="doc_text">
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000356
357<p>The table below specifies which compilers are used for each Arch/OS
358 combination when qualifying the build of <tt>llvm</tt>, <tt>llvm-gcc</tt>,
359 and <tt>clang</tt>.</p>
360
361<table>
Tanya Lattnerda94af72009-08-19 23:07:37 +0000362 <tr><th>Architecture</th><th>OS</th><th>compiler</th></tr>
363 <tr><td>x86-32</td><td>Mac OS 10.5</td><td>gcc 4.0.1</td></tr>
364 <tr><td>x86-32</td><td>Linux</td><td>gcc 4.2.X, gcc 4.3.X</td></tr>
Tanya Lattner82e57a62009-08-23 04:36:30 +0000365 <tr><td>x86-32</td><td>FreeBSD</td><td>gcc 4.2.X</td></tr>
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000366 <tr><td>x86-32</td><td>mingw</td><td>gcc 3.4.5</td></tr>
Tanya Lattnerda94af72009-08-19 23:07:37 +0000367 <tr><td>x86-64</td><td>Mac OS 10.5</td><td>gcc 4.0.1</td></tr>
368 <tr><td>x86-64</td><td>Linux</td><td>gcc 4.2.X, gcc 4.3.X</td></tr>
Tanya Lattner82e57a62009-08-23 04:36:30 +0000369 <tr><td>x86-64</td><td>FreeBSD</td><td>gcc 4.2.X</td></tr>
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000370</table>
Tanya Lattnerda94af72009-08-19 23:07:37 +0000371
Tanya Lattner586eb8e2007-09-28 22:50:54 +0000372</div>
373
Tanya Lattner7fb16162009-08-18 22:33:28 +0000374<!-- ======================================================================= -->
375<div class="doc_subsection"><a name="release-qualify">
376Building the Release</a></div>
377
378<div class="doc_text">
Tanya Lattner7fb16162009-08-18 22:33:28 +0000379
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000380<p>A release is qualified when it has no regressions from the previous release
381 (or baseline). Regressions are related to correctness first and performance
382 second. (We may tolerate some minor performance regressions if they are
383 deemed necessary for the general quality of the compiler.)</p>
384
385<p><b>Regressions are new failures in the set of tests that are used to qualify
386 each product and only include things on the list. Every release will have
387 some bugs in it. It is the reality of developing a complex piece of
388 software. We need a very concrete and definitive release criteria that
389 ensures we have monotonically improving quality on some metric. The metric we
390 use is described below. This doesn't mean that we don't care about other
391 criteria, but these are the criteria which we found to be most important and
392 which must be satisfied before a release can go out</b></p>
393
394</div>
Tanya Lattner7fb16162009-08-18 22:33:28 +0000395
396<!-- ======================================================================= -->
397<div class="doc_subsubsection"><a name="llvm-qualify">Qualify LLVM</a></div>
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000398
Tanya Lattner7fb16162009-08-18 22:33:28 +0000399<div class="doc_text">
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000400
401<p>LLVM is qualified when it has a clean test run without a front-end. And it
402 has no regressions when using either <tt>llvm-gcc</tt> or <tt>clang</tt> with
403 the <tt>test-suite</tt> from the previous release.</p>
404
Tanya Lattner7fb16162009-08-18 22:33:28 +0000405</div>
406
Tanya Lattner586eb8e2007-09-28 22:50:54 +0000407<!-- ======================================================================= -->
Tanya Lattner7fb16162009-08-18 22:33:28 +0000408<div class="doc_subsubsection"><a name="llvmgcc-qualify">Qualify LLVM-GCC</a></div>
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000409
Tanya Lattner586eb8e2007-09-28 22:50:54 +0000410<div class="doc_text">
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000411
412<p><tt>LLVM-GCC</tt> is qualified when front-end specific tests in the
413 <tt>llvm</tt> regression test suite all pass and there are no regressions in
414 the <tt>test-suite</tt>.</p>
415
416<p>We do not use the GCC DejaGNU test suite as release criteria.</p>
417
Tanya Lattner586eb8e2007-09-28 22:50:54 +0000418</div>
419
420<!-- ======================================================================= -->
Tanya Lattner7fb16162009-08-18 22:33:28 +0000421<div class="doc_subsubsection"><a name="clang-qualify">Qualify Clang</a></div>
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000422
Reid Spencer34ddd282006-08-16 00:54:50 +0000423<div class="doc_text">
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000424
425<p><tt>Clang</tt> is qualified when front-end specific tests in the
426 <tt>llvm</tt> dejagnu test suite all pass, clang's own test suite passes
427 cleanly, and there are no regressions in the <tt>test-suite</tt>.</p>
428
Reid Spencerab926de2006-03-23 06:45:42 +0000429</div>
430
431<!-- ======================================================================= -->
Tanya Lattner7fb16162009-08-18 22:33:28 +0000432<div class="doc_subsubsection"><a name="targets">Specific Target
433Qualification Details</a></div>
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000434
Tanya Lattner7fb16162009-08-18 22:33:28 +0000435<div class="doc_text">
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000436
437<table>
438 <tr><th>Architecture</th><th>OS</th><th>llvm-gcc baseline</th><th>clang baseline</th><th>tests</th></tr>
Tanya Lattnere30614c2010-04-05 18:35:37 +0000439 <tr><td>x86-32</td><td>Linux</td><td>last release</td><td>last release</td><td>llvm dejagnu, clang tests, test-suite (including spec)</td></tr>
440 <tr><td>x86-32</td><td>FreeBSD</td><td>none</td><td>last release</td><td>llvm dejagnu, clang tests, test-suite</td></tr>
Tanya Lattnerda94af72009-08-19 23:07:37 +0000441 <tr><td>x86-32</td><td>mingw</td><td>last release</td><td>none</td><td>QT</td></tr>
Tanya Lattnere30614c2010-04-05 18:35:37 +0000442 <tr><td>x86-64</td><td>Mac OS 10.X</td><td>last release</td><td>last release</td><td>llvm dejagnu, clang tests, test-suite (including spec)</td></tr>
443 <tr><td>x86-64</td><td>Linux</td><td>last release</td><td>last release</td><td>llvm dejagnu, clang tests, test-suite (including spec)</td></tr>
444 <tr><td>x86-64</td><td>FreeBSD</td><td>none</td><td>last release</td><td>llvm dejagnu, clang tests, test-suite</td></tr>
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000445</table>
446
Tanya Lattner7fb16162009-08-18 22:33:28 +0000447</div>
448
449<!-- ======================================================================= -->
450<div class="doc_subsection"><a name="commTest">Community Testing</a></div>
John Criswell4b8dfb92006-04-11 20:24:28 +0000451<div class="doc_text">
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000452
453<p>Once all testing has been completed and appropriate bugs filed, the release
454 candidate tarballs are put on the website and the LLVM community is
455 notified. Ask that all LLVM developers test the release in 2 ways:</p>
456
457<ol>
458 <li>Download <tt>llvm-<i>X.Y</i></tt>, <tt>llvm-test-<i>X.Y</i></tt>, and the
459 appropriate <tt>llvm-gcc</tt> and/or <tt>clang</tt> binary. Build
460 LLVM. Run <tt>make check</tt> and the full LLVM test suite (<tt>make
461 TEST=nightly report</tt>).</li>
462
463 <li>Download <tt>llvm-<i>X.Y</i></tt>, <tt>llvm-test-<i>X.Y</i></tt>, and the
464 <tt>llvm-gcc</tt> and/or <tt>clang</tt> source. Compile everything. Run
465 <tt>make check</tt> and the full LLVM test suite (<tt>make TEST=nightly
466 report</tt>).</li>
467</ol>
468
469<p>Ask LLVM developers to submit the test suite report and <tt>make check</tt>
470 results to the list. Verify that there are no regressions from the previous
471 release. The results are not used to qualify a release, but to spot other
472 potential problems. For unsupported targets, verify that <tt>make check</tt>
473 is at least clean.</p>
Tanya Lattner586eb8e2007-09-28 22:50:54 +0000474
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000475<p>During the first round of testing, all regressions must be fixed before the
476 second release candidate is tagged.</p>
Tanya Lattner586eb8e2007-09-28 22:50:54 +0000477
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000478<p>If this is the second round of testing, the testing is only to ensure that
479 bug fixes previously merged in have not created new major problems. <i>This
480 is not the time to solve additional and unrelated bugs!</i> If no patches are
481 merged in, the release is determined to be ready and the release manager may
482 move onto the next stage.</p>
483
John Criswell4b8dfb92006-04-11 20:24:28 +0000484</div>
485
Tanya Lattner7fb16162009-08-18 22:33:28 +0000486<!-- ======================================================================= -->
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000487<div class="doc_subsection"><a name="release-patch">Release Patch Rules</a></div>
Tanya Lattner7fb16162009-08-18 22:33:28 +0000488
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000489<div class="doc_text">
490
491<p>Below are the rules regarding patching the release branch:</p>
492
493<ol>
494 <li><p>Patches applied to the release branch may only be applied by the
495 release manager.</p></li>
496
497 <li><p>During the first round of testing, patches that fix regressions or that
498 are small and relatively risk free (verified by the appropriate code
499 owner) are applied to the branch. Code owners are asked to be very
500 conservative in approving patches for the branch. We reserve the right to
501 reject any patch that does not fix a regression as previously
502 defined.</p></li>
503
504 <li><p>During the remaining rounds of testing, only patches that fix critical
505 regressions may be applied.</p></li>
506</ol>
507
508</div>
Tanya Lattnerb3b1dab2006-08-10 00:23:05 +0000509
510<!-- ======================================================================= -->
Tanya Lattner7fb16162009-08-18 22:33:28 +0000511<div class="doc_subsection"><a name="release-final">Release Final Tasks
512</a></div>
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000513
Tanya Lattner7fb16162009-08-18 22:33:28 +0000514<div class="doc_text">
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000515
516<p>The final stages of the release process involves tagging the "final" release
517 branch, updating documentation that refers to the release, and updating the
518 demo page.</p>
519
Tanya Lattner7fb16162009-08-18 22:33:28 +0000520</div>
521
522
523<!-- ======================================================================= -->
Tanya Lattnerda94af72009-08-19 23:07:37 +0000524<div class="doc_subsubsection"><a name="updocs">Update Documentation</a></div>
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000525
Tanya Lattnerda94af72009-08-19 23:07:37 +0000526<div class="doc_text">
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000527
528<p>Review the documentation and ensure that it is up to date. The "Release
529 Notes" must be updated to reflect new features, bug fixes, new known issues,
530 and changes in the list of supported platforms. The "Getting Started Guide"
531 should be updated to reflect the new release version number tag avaiable from
532 Subversion and changes in basic system requirements. Merge both changes from
533 mainline into the release branch.</p>
534
Tanya Lattnerda94af72009-08-19 23:07:37 +0000535</div>
536
537<!-- ======================================================================= -->
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000538<div class="doc_subsubsection"><a name="tag">Tag the LLVM Final Release</a></div>
539
Tanya Lattner586eb8e2007-09-28 22:50:54 +0000540<div class="doc_text">
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000541
542<p>Tag the final release sources using the following procedure:</p>
543
Tanya Lattner586eb8e2007-09-28 22:50:54 +0000544<div class="doc_code">
545<pre>
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000546$ svn copy https://llvm.org/svn/llvm-project/llvm/branches/release_XY \
547 https://llvm.org/svn/llvm-project/llvm/tags/RELEASE_<i>XY</i>/Final
548
549$ svn copy https://llvm.org/svn/llvm-project/llvm-gcc-4.2/branches/release_XY \
550 https://llvm.org/svn/llvm-project/llvm-gcc-4.2/tags/RELEASE_<i>XY</i>/Final
551
552$ svn copy https://llvm.org/svn/llvm-project/test-suite/branches/release_XY \
553 https://llvm.org/svn/llvm-project/test-suite/tags/RELEASE_<i>XY</i>/Final
554
555$ svn copy https://llvm.org/svn/llvm-project/cfe/branches/release_XY \
556 https://llvm.org/svn/llvm-project/cfe/tags/RELEASE_<i>XY</i>/Final
Tanya Lattner586eb8e2007-09-28 22:50:54 +0000557</pre>
558</div>
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000559
Tanya Lattner586eb8e2007-09-28 22:50:54 +0000560</div>
561
Tanya Lattner586eb8e2007-09-28 22:50:54 +0000562<!-- ======================================================================= -->
563<div class="doc_subsection"><a name="updemo">Update the LLVM Demo Page</a></div>
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000564
Tanya Lattner586eb8e2007-09-28 22:50:54 +0000565<div class="doc_text">
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000566
567<p>The LLVM demo page must be updated to use the new release. This consists of
568 using the new <tt>llvm-gcc</tt> binary and building LLVM.</p>
569
Tanya Lattner586eb8e2007-09-28 22:50:54 +0000570</div>
571
572<!-- ======================================================================= -->
Tanya Lattner7fb16162009-08-18 22:33:28 +0000573<div class="doc_subsubsection"><a name="webupdates">Update the LLVM Website</a></div>
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000574
Tanya Lattnerb3b1dab2006-08-10 00:23:05 +0000575<div class="doc_text">
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000576
577<p>The website must be updated before the release announcement is sent out. Here
578 is what to do:</p>
579
580<ol>
581 <li>Check out the <tt>www</tt> module from Subversion.</li>
582
583 <li>Create a new subdirectory <tt>X.Y</tt> in the releases directory.</li>
584
585 <li>Commit the <tt>llvm</tt>, <tt>test-suite</tt>, <tt>llvm-gcc</tt> source,
586 <tt>clang source</tt>, <tt>clang binaries</tt>, and <tt>llvm-gcc</tt>
587 binaries in this new directory.</li>
588
589 <li>Copy and commit the <tt>llvm/docs</tt> and <tt>LICENSE.txt</tt> files
590 into this new directory. The docs should be built with
591 <tt>BUILD_FOR_WEBSITE=1</tt>.</li>
592
593 <li>Commit the <tt>index.html</tt> to the <tt>release/X.Y</tt> directory to
594 redirect (use from previous release.</li>
595
596 <li>Update the <tt>releases/download.html</tt> file with the new release.</li>
597
598 <li>Update the <tt>releases/index.html</tt> with the new release and link to
599 release documentation.</li>
600
601 <li>Finally, update the main page (<tt>index.html</tt> and sidebar) to point
602 to the new release and release announcement. Make sure this all gets
603 committed back into Subversion.</li>
604</ol>
605
Tanya Lattnerb3b1dab2006-08-10 00:23:05 +0000606</div>
607
Tanya Lattner586eb8e2007-09-28 22:50:54 +0000608<!-- ======================================================================= -->
Tanya Lattner7fb16162009-08-18 22:33:28 +0000609<div class="doc_subsubsection"><a name="announce">Announce the Release</a></div>
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000610
Reid Spencerab926de2006-03-23 06:45:42 +0000611<div class="doc_text">
Bill Wendlingb3294fa2011-02-28 01:10:44 +0000612
613<p>Have Chris send out the release announcement when everything is finished.</p>
614
Reid Spencerab926de2006-03-23 06:45:42 +0000615</div>
Reid Spencerab926de2006-03-23 06:45:42 +0000616
617<!-- *********************************************************************** -->
Reid Spencerab926de2006-03-23 06:45:42 +0000618<hr>
619<address>
620 <a href="http://jigsaw.w3.org/css-validator/check/referer"><img
Misha Brukman86242e12008-12-11 17:34:48 +0000621 src="http://jigsaw.w3.org/css-validator/images/vcss-blue" alt="Valid CSS"></a>
Reid Spencerab926de2006-03-23 06:45:42 +0000622 <a href="http://validator.w3.org/check/referer"><img
Misha Brukman21a63702008-12-11 18:23:24 +0000623 src="http://www.w3.org/Icons/valid-html401-blue" alt="Valid HTML 4.01"></a>
NAKAMURA Takumica46f5a2011-04-09 02:13:37 +0000624 <a href="http://llvm.org/">The LLVM Compiler Infrastructure</a>
Misha Brukman21a63702008-12-11 18:23:24 +0000625 <br>
Reid Spencerab926de2006-03-23 06:45:42 +0000626 Last modified: $Date$
627</address>
628</body>
629</html>