llvm-project/clang
Alp Toker 64197b9eb9 docs: clarify the role of compiler-builtin type trait primitives
Update the documentation to clarify the intent of clang's built-in type trait
facilities, their relation to user-facing C++ type traits and means to check
for availability.

Also explain that __has_feature() is not currently up to date and should not
generally be used in user code (there's a proposal to provide more consistent
checks via __has_builtin(), see cfe-dev).

llvm-svn: 199562
2014-01-18 21:49:02 +00:00
..
INPUTS
bindings [libclang/python] Add CompilationDatabase.getAllCompileCommands to the python bindings. 2013-12-20 01:34:00 +00:00
docs docs: clarify the role of compiler-builtin type trait primitives 2014-01-18 21:49:02 +00:00
examples Don't use PrintFunctionNames.exports on Windows. 2013-12-30 00:05:56 +00:00
include Make unreferenced f-group options anonymous 2014-01-18 20:45:14 +00:00
lib Driver support for -fdebug-types-sections 2014-01-18 02:02:06 +00:00
runtime Only build ARM-specific runtimes if ARM is enabled 2013-12-11 12:01:21 +00:00
test Driver support for -fdebug-types-sections 2014-01-18 02:02:06 +00:00
tools Rename QA_OVERRIDE_GCC3_OPTIONS to CCC_OVERRIDE_OPTIONS. <rdar://14578381> 2014-01-15 01:41:52 +00:00
unittests Fix string-literal to char* conversion in overload resolution for C++11 2014-01-17 21:08:52 +00:00
utils When generating Spelling enumeration values, do not generate identifiers in the reserved namespace. Strip underscores as appropriate, taking care to not create duplicate identifiers. 2014-01-16 19:44:01 +00:00
www Updating the minimum version information for Visual Studio. 2014-01-17 03:38:49 +00:00
.arcconfig
.clang-format Switch the default mode for clang-format to '-file'. Make 'LLVM' the 2013-09-02 07:42:02 +00:00
.gitignore
CMakeLists.txt LLVM's CMake is now using a feature that wasn't preasant in CMake 2.8.7, 2014-01-13 22:23:58 +00:00
CODE_OWNERS.TXT Adding myself as the code owner for the attribute subsystem. 2014-01-13 22:23:27 +00:00
INSTALL.txt Reverting test commit 2013-06-07 05:33:21 +00:00
LICENSE.TXT Update the copyright credits -- Happy new year 2014! 2014-01-01 08:27:31 +00:00
Makefile Define ENABLE_CLANG_EXAMPLES instead of relying on BUILD_EXAMPLES 2014-01-08 13:00:32 +00:00
ModuleInfo.txt
NOTES.txt
README.txt

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/