wangtao
/
llvm-project
forked from OSchip/llvm-project
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update Clang C++ status, with a more project-centric focus. 

llvm-svn: 95455
This commit is contained in:
Douglas Gregor 2010-02-05 23:51:14 +00:00
parent 5f9ead2714
commit bb26a92239
4 changed files with 87 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
clang/docs/UsersManual.html
View File

@ -789,14 +789,12 @@ definition.</li>
<h2 id="cxx">C++ Language Features</h2>
<!-- ======================================================================= -->
<p>At this point, Clang C++ is not generally useful. However, Clang C++ support
<p>At this point, Clang C++ is not production-quality and is not recommended for use beyond experimentation. However, Clang C++ support
is under active development and is progressing rapidly. Please see the <a
href="http://clang.llvm.org/cxx_status.html">C++ Status</a> page for details or
ask on the mailing list about how you can help.</p>
<p>Note that the clang driver will refuse to even try to use clang to compile
C++ code unless you pass the <tt>-ccc-clang-cxx</tt> option to the driver. If
you really want to play with Clang's C++ support, please pass that flag. </p>
<p>Note that released Clang compilers will refuse to even try to use clang to compile C++ code unless you pass the <tt>-ccc-clang-cxx</tt> option to the driver. To turn on Clang's C++ support, please pass that flag. Clang compilers built from the Subversion trunk enable C++ support by default, and do not require the <tt>-ccc-clang-cxx</tt> flag.</p>
<!-- ======================================================================= -->
<h2 id="objcxx">Objective C++ Language Features</h2>

3
clang/www/comparison.html
View File

@ -51,8 +51,7 @@
<li>GCC supports languages that clang does not aim to, such as Java, Ada,
FORTRAN, etc.</li>
<li>GCC front-ends are very mature and already support C++.
<a href="cxx_status.html">clang's support for C++</a> is nowhere near
what GCC supports.</li>
<a href="cxx_status.html">clang's support for C++</a> is further behind.</li>
<li>GCC supports more targets than LLVM.</li>
<li>GCC is popular and widely adopted.</li>
<li>GCC does not require a C++ compiler to build it.</li>

78
clang/www/cxx_status.html
View File

@ -26,9 +26,75 @@
<!--*************************************************************************-->
<p>Last updated: $Date$</p>
<p>
This page tracks the status of C++ support in Clang.<br>
Clang implements the majority of C++ features, although there are many bugs remaining and Clang is not yet generally useful as a C++ compiler. If you are looking to <a href="get_involved.html">get involved with Clang development</a> to help work on support for C++, please also look at our <a href="OpenProjects.html">Open Projects</a> page and the <a href="http://llvm.org/bugs/">LLVM bug tracker</a> for some specific ideas.</p>
<h1>Clang C++ Status</h1>
<ul>
<li><a href="#projects">Projects Building with Clang</a></li>
<li><a href="#specification">Implementation Status by Section</a></li>
<li><a href="#cxx0x">C++0x Status</a></li>
</ul>
<p>Clang currently implements nearly all of the ISO C++ 1998 standard
(including the defects addressed in the ISO C++ 2003 standard), with
the few notable exceptions listed below. However, the implementation
of Clang C++ is still quite immature, with many remaining bugs that
are likely to cause compiler crashes, erroneous errors and warnings,
and miscompiled code. The <a href="http://llvm.org/bugs/">LLVM bug
tracker</a> contains a Clang C++ component that tracks known Clang C++
bugs.</p>
<p>Clang is currently missing implementations of the following C++98/03 features and common extensions:</p>
<ul>
<li>Access control: Clang does not perform access-control checking
at this time, so it will fail to diagnose invalid accesses. Work
is underway to implement this feature.</li>
<li>Friends and friend templates: Clang parses friends and friend
templates for the most part, but they are not used in access
control and there are a number of problems with friend templates
and friends within class templates.</li>
<li>GNU <a href="http://gcc.gnu.org/onlinedocs/gcc-4.1.2/gcc/Strong-Using.html">strong using</a> extension.</li>
<li>Qualified member accesses that disambiguate the base class in a diamond-shaped inheritance hierarchy.</li>
</ul>
<h2 id="projects">Projects Building with Clang</h2>
<p>Clang is now capable of compiling some language C++ projects, or
large pieces of such projects. The following table describes various
projects that we have attempted to compile with Clang along with the results of that attempt.</p>
<p> At this point in time, each new C++ project typically uncovers
new bugs. We keep track of these in the <a
href="http://llvm.org/bugs/">LLVM bug tracker</a> via tracking bugs,
which are used to relate all of the bugs known to affect that
particular project. Introducing a new project in this list typically requires a liason familiar with LLVM or Clang development, who is able to provide detailed bug reports and track progress for the particular project.</p>
<table width="689" border="1" cellspacing="0">
<tr>
<th>Project</th>
<th>Status</th>
<th>Last Tested</th>
<th>Tracking Bug</th>
</tr>
<tr>
<td><a href="http://clang.llvm.org">Clang</a> and <a href="http://llvm.org">LLVM</a></td>
<td>Successful self-hosting achieved</td>
<td>Continually</td>
<td></td>
</tr>
<tr>
<td><a href="http://www.boost.org">Boost</a></td>
<td>Some libraries (e.g., Boost.MPL) successfully build and pass regression tests, the majority still fail.</td>
<td>February 5, 2010</td>
<td><a href="http://llvm.org/bugs/show_bug.cgi?id=6023">PR6023</a></td>
</tr>
</table>
<h2 id="specification">Implementation Status by Section</h2>
<!-- Within this table: The colors we're using to color-code our level
@ -2297,6 +2363,12 @@ welcome!</p>
<tr><td>&nbsp;&nbsp;D.5 [depr.c.headers]</td><td></td><td></td><td></td><td></td><td></td></tr>
<tr><td>E [extendid]</td><td></td><td></td><td></td><td></td><td></td></tr>
<tr>
</table>
<h2 id="cxx0x">C++0x Implementation status</h2>
<p>Clang's development effort is focused primarily on supporting the current ISO C++ standard (1998/2003). This section tracks the status of various C++0x features. In general, the implementations of these features are far less developed than C++98/03 features.</p>
<table width="689" border="1" cellspacing="0">
<td colspan="6" align="center" bgcolor="#ffffcc">C++0x Features</td>
</tr>
<tr>

16
clang/www/index.html
View File

@ -89,13 +89,15 @@
<h2>Current Status</h2>
<!--=====================================================================-->
<p>Clang is still under heavy development. Clang is considered to be
a production quality C and Objective-C compiler when targetting X86-32 and X86-64
(other targets may have caveats, but are usually easy to fix). If you are
looking for source
analysis or source-to-source transformation tools, clang is probably
a great solution for you. If you are interested in C++,
<a href="cxx_status.html">full support</a> is still way off.</p>
<p>Clang is still under heavy development. Clang is considered to
be a production quality C and Objective-C compiler when targetting
X86-32 and X86-64 (other targets may have caveats, but are usually
easy to fix). If you are looking for source analysis or
source-to-source transformation tools, clang is probably a great
solution for you. Clang's C++ support is currently alpha quality
at best, but is evolving rapidly: see the <a
href="cxx_status.html">C++ status</a> page for more
information.</p>
<!--=====================================================================-->
<h2>Get it and get involved!</h2>