llvm-project/clang
Joel E. Denny ddde0ec1e4 [PragmaHandler] Expose `#pragma` location
Currently, a pragma AST node's recorded location starts at the
namespace token (such as `omp` in the case of OpenMP) after the
`#pragma` token, and the `#pragma` location isn't available.  However,
the `#pragma` location can be useful when, for example, rewriting a
directive using Clang's Rewrite facility.

This patch makes `#pragma` locations available in any `PragmaHandler`
but it doesn't yet make use of them.

This patch also uses the new `struct PragmaIntroducer` to simplify
`Preprocessor::HandlePragmaDirective`.  It doesn't do the same for
`PPCallbacks::PragmaDirective` because that changes the API documented
in `clang-tools-extra/docs/pp-trace.rst`, and I'm not sure about
backward compatibility guarantees there.

Reviewed By: ABataev, lebedev.ri, aaron.ballman

Differential Revision: https://reviews.llvm.org/D61643

llvm-svn: 361335
2019-05-21 23:51:38 +00:00
..
INPUTS
bindings [CodeComplete] Update python tests after r360042 2019-05-06 14:56:24 +00:00
cmake Fix BUILD_SHARED_LIBS for clang which broke in D61909 2019-05-21 15:56:17 +00:00
docs [PragmaHandler] Expose `#pragma` location 2019-05-21 23:51:38 +00:00
examples [PragmaHandler] Expose `#pragma` location 2019-05-21 23:51:38 +00:00
include [PragmaHandler] Expose `#pragma` location 2019-05-21 23:51:38 +00:00
lib [PragmaHandler] Expose `#pragma` location 2019-05-21 23:51:38 +00:00
runtime [cmake] Change deprecated $<CONFIG> to $<CONFIGURATION>. NFC 2019-03-30 14:38:51 +00:00
test [c++20] P1330R0: permit simple-assignments that change the active member 2019-05-21 23:15:20 +00:00
tools Fix target property to make BUILD_SHARED_LIBS work 2019-05-21 23:50:15 +00:00
unittests [LibTooling] Address post-commit feedback for r361152 2019-05-21 18:48:58 +00:00
utils Make clang/utils/creduce-clang-crash.py executable 2019-05-01 20:15:39 +00:00
www [c++20] P1330R0: permit simple-assignments that change the active member 2019-05-21 23:15:20 +00:00
.arcconfig
.clang-format
.clang-tidy Disable tidy checks with too many hits 2019-02-01 11:20:13 +00:00
.gitignore Adjust documentation for git migration. 2019-01-29 16:37:27 +00:00
CMakeLists.txt Moved everything SMT-related to LLVM and updated the cmake scripts. 2019-03-25 17:47:45 +00:00
CODE_OWNERS.TXT
INSTALL.txt
LICENSE.TXT Fix typos throughout the license files that somehow I and my reviewers 2019-01-21 09:52:34 +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.llvm.org/mailman/listinfo/cfe-dev

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