llvm-project/clang
Scott Linder de6beb02a5 Implement -frecord-command-line (-frecord-gcc-switches)
Implement options in clang to enable recording the driver command-line
in an ELF section.

Implement a new special named metadata, llvm.commandline, to support
frontends embedding their command-line options in IR/ASM/ELF.

This differs from the GCC implementation in some key ways:

* In GCC there is only one command-line possible per compilation-unit,
  in LLVM it mirrors llvm.ident and multiple are allowed.
* In GCC individual options are separated by NULL bytes, in LLVM entire
  command-lines are separated by NULL bytes. The advantage of the GCC
  approach is to clearly delineate options in the face of embedded
  spaces. The advantage of the LLVM approach is to support merging
  multiple command-lines unambiguously, while handling embedded spaces
  with escaping.

Differential Revision: https://reviews.llvm.org/D54487
Clang Differential Revision: https://reviews.llvm.org/D54489

llvm-svn: 349155
2018-12-14 15:38:15 +00:00
..
INPUTS
bindings Revert "Try to update the test to fix the breakage With the new warning, we are showing one more output in the test." 2018-12-14 00:43:36 +00:00
cmake [Driver] Support XRay on Fuchsia 2018-11-22 02:36:47 +00:00
docs Implement -frecord-command-line (-frecord-gcc-switches) 2018-12-14 15:38:15 +00:00
examples Test commit - delete trailing space. 2018-11-19 12:16:05 +00:00
include Implement -frecord-command-line (-frecord-gcc-switches) 2018-12-14 15:38:15 +00:00
lib Implement -frecord-command-line (-frecord-gcc-switches) 2018-12-14 15:38:15 +00:00
runtime [CMake] Make bootstrap and compiler-rt depend on cxx-headers. 2018-06-28 18:35:25 +00:00
test Implement -frecord-command-line (-frecord-gcc-switches) 2018-12-14 15:38:15 +00:00
tools Update the scan-build to generate SARIF. 2018-12-13 20:55:34 +00:00
unittests Attempt to fix code completion test to handle LLP64 platforms 2018-12-13 21:41:07 +00:00
utils Portable Python script across Python version 2018-12-13 07:44:19 +00:00
www [constexpr][c++2a] Try-catch blocks in constexpr functions 2018-12-10 19:03:12 +00:00
.arcconfig
.clang-format
.clang-tidy
.gitignore NFC: Add .vscode to .gitignore 2018-12-03 22:51:07 +00:00
CMakeLists.txt inhereit LLVM_ENABLE_LIBXML2 2018-11-29 14:57:14 +00:00
CODE_OWNERS.TXT Add myself as code owner for OpenBSD driver 2018-11-30 21:42:34 +00:00
INSTALL.txt
LICENSE.TXT Update copyright year to 2018. 2018-06-18 12:22:17 +00:00
ModuleInfo.txt
NOTES.txt PTH-- Remove feature entirely- 2018-12-04 14:34:09 +00:00
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/