llvm-project/clang
Douglas Gregor f718062f25 Introduce the local -> global declaration ID mapping into the AST
reader, to allow AST files to be loaded with their declarations
remapped to different ID numbers. Fix a number of places where we were
either failing to map local declaration IDs into global declaration
IDs or where interpreting the local declaration IDs within the wrong
module. 

I've tested this via the usual "random gaps" method. It works well
except for the preamble tests, because our handling of the precompiled
preamble requires declaration and preprocessed entity to be stable
when parsing code and then loading that back into memory. This
property will hold in general, but my randomized testing naturally
breaks this property to get more coverage. In the future, I expect
that the precompiled preamble logic won't need this property.

I am very unhappy with the current handling of the translation unit,
which is a rather egregious hack. We're going to have to do something
very different here for loading multiple AST files, because we don't
want to have to cope with merging two translation units. Likely, we'll
just handle translation units entirely via "update" records, and
predefine a single, fixed declaration ID for the translation
unit. That will come later.

llvm-svn: 136779
2011-08-03 15:48:04 +00:00
..
INPUTS Add several CFG-stress-testing input source files. These use the 2011-07-08 11:20:51 +00:00
bindings/python Improve the Python bindings for libclang in a few ways, from Eli 2011-07-06 03:00:34 +00:00
clang.xcodeproj Remove BoostCon-specific code from Clang. FWIW, I'm a fan of things like this living in a separate branch. 2011-07-07 22:40:15 +00:00
docs Added basic parsing for all remaining attributes, thread safety 2011-07-28 20:12:35 +00:00
examples Reverts the Tooling changes as requested by Chris. 2011-06-02 16:58:33 +00:00
include Introduce the local -> global declaration ID mapping into the AST 2011-08-03 15:48:04 +00:00
lib Introduce the local -> global declaration ID mapping into the AST 2011-08-03 15:48:04 +00:00
runtime Build and use libcompiler_rt whenever possible. 2011-06-22 17:41:40 +00:00
test In ARC, don't try to reclaim the result of a call to performSelector 2011-08-03 07:02:44 +00:00
tools When the compiler crashes, the compiler driver now produces diagnostic 2011-08-02 17:58:04 +00:00
unittests Define DiagnosticBuilder<<APValue so it's easy to include APValues in 2011-07-18 16:43:53 +00:00
utils Easier debugging with Visual Studio Visualizers, from Nikola Smiljanic! 2011-07-27 05:22:46 +00:00
www Update C++0x status page to reflect support for unicode string and character literals, from Craig Topper 2011-07-27 15:10:09 +00:00
.gitignore Add .gitignore file. 2011-07-18 23:05:36 +00:00
CMakeLists.txt Fix cmake for r136702 (at least for the most part). Chandler has been kind 2011-08-02 20:44:34 +00:00
INSTALL.txt
LICENSE.TXT My calendar says it's 2011. 2011-06-12 15:26:54 +00:00
Makefile Basic: Add support for a build variable to set the repository path that goes 2011-03-31 00:32:50 +00:00
ModuleInfo.txt
NOTES.txt Make a note about a missing optimization. 2011-07-28 07:41:22 +00:00
README.txt
TODO.txt Test commit; added blank line to TODO.txt 2011-01-04 19:19:20 +00:00

README.txt

//===----------------------------------------------------------------------===//
// C Language Family Front-end
//===----------------------------------------------------------------------===//

Welcome to Clang.  This is a compiler front-end for the C family of languages
(C, C++, Objective-C, and Objective-C++) which is built as part of the LLVM
compiler infrastructure project.

Unlike many other compiler frontends, Clang is useful for a number of things
beyond just compiling code: we intend for Clang to be host to a number of
different source level tools.  One example of this is the Clang Static Analyzer.

If you're interested in more (including how to build Clang) it is best to read
the relevant web sites.  Here are some pointers:

Information on Clang:              http://clang.llvm.org/
Building and using Clang:          http://clang.llvm.org/get_started.html
Clang Static Analyzer:             http://clang-analyzer.llvm.org/
Information on the LLVM project:   http://llvm.org/

If you have questions or comments about Clang, a great place to discuss them is
on the Clang development mailing list:
  http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev

If you find a bug in Clang, please file it in the LLVM bug tracker:
  http://llvm.org/bugs/