llvm-project/clang
Birunthan Mohanathas b001a0ba5e clang-format: Add MacroBlock{Begin,End} options
The MacroBlockBegin and MacroBlockEnd options make matching macro identifiers
behave like '{' and '}', respectively, in terms of indentation.

Mozilla code, for example, uses several macros that begin and end a scope.
Previously, Clang-Format removed the indentation resulting in:

    MACRO_BEGIN(...)
    MACRO_ENTRY(...)
    MACRO_ENTRY(...)
    MACRO_END

Now, using the options

    MacroBlockBegin: "^[A-Z_]+_BEGIN$"
    MacroBlockEnd: "^[A-Z_]+_END$"

will yield the expected result:

    MACRO_BEGIN(...)
      MACRO_ENTRY(...)
      MACRO_ENTRY(...)
    MACRO_END

Differential Revision: http://reviews.llvm.org/D10840

llvm-svn: 241363
2015-07-03 17:25:16 +00:00
..
INPUTS
bindings [libclang] Add functions to get information about fields. 2015-04-13 16:55:04 +00:00
cmake/modules Make it easier to build against a pre-built Clang package with CMake 2014-11-05 23:14:59 +00:00
docs clang-format: Add MacroBlock{Begin,End} options 2015-07-03 17:25:16 +00:00
examples Fixing a build bot break from r240400. 2015-06-23 13:29:33 +00:00
include clang-format: Add MacroBlock{Begin,End} options 2015-07-03 17:25:16 +00:00
lib clang-format: Add MacroBlock{Begin,End} options 2015-07-03 17:25:16 +00:00
runtime [UBSan] Use shared library for UBSan on OS X (Clang part). 2015-03-23 23:14:05 +00:00
test [OPENMP 4.0] Fixed codegen for 'cancellation point' construct. 2015-07-03 09:56:58 +00:00
tools Switch users of the 'for (StmtRange range = stmt->children(); range; ++range)‘ pattern to range for loops. 2015-07-02 21:03:14 +00:00
unittests clang-format: Add MacroBlock{Begin,End} options 2015-07-03 17:25:16 +00:00
utils [Static Analyzer] No longer include the full path of the source file in the single file tests' bug identifiers. 2015-07-02 19:20:46 +00:00
www Fix "the the" in comments/documentation/etc. 2015-06-19 01:52:53 +00:00
.arcconfig
.clang-format
.clang-tidy
.gitignore [.gitignore] ignore vim swap files harder 2015-06-17 02:21:35 +00:00
CMakeLists.txt Use Clang version numbers for the Windows VERSIONINFO resource. 2015-06-12 16:33:38 +00:00
CODE_OWNERS.TXT List Alexey Bataev as code owner for Clang's OpenMP support, as discussed offline. 2015-05-12 20:29:41 +00:00
INSTALL.txt
LICENSE.TXT Update copyright year to 2015. 2015-03-12 01:36:10 +00:00
Makefile
ModuleInfo.txt
NOTES.txt
README.txt Reverting test commit. 2015-04-10 08:43:58 +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/