llvm-project/clang
Paul Hoad cbb726d0c5 [clang-format] Add basic support for formatting C# files
Summary:

This revision adds basic support for formatting C# files with clang-format, I know the barrier to entry is high here  so I'm sending this revision in to test the water as to whether this might be something we'd consider landing.

Tracking in Bugzilla as:
https://bugs.llvm.org/show_bug.cgi?id=40850

Justification:
C# code just looks ugly in comparison to the C++ code in our source tree which is clang-formatted.

I've struggled with Visual Studio reformatting to get a clean and consistent style, I want to format our C# code on saving like I do now for C++ and i want it to have the same style as defined in our .clang-format file, so it consistent as it can be with C++.  (Braces/Breaking/Spaces/Indent etc..)

Using clang format without this patch leaves the code in a bad state, sometimes when the BreakStringLiterals is set, it  fails to compile.

Mostly the C# is similar to Java, except instead of JavaAnnotations I try to reuse the TT_AttributeSquare.

Almost the most valuable portion is to have a new Language in order to partition the configuration for C# within a common .clang-format file, with the auto detection on the .cs extension. But there are other C# specific styles that could be added later if this is accepted. in particular how  `{ set;get }` is formatted.

Reviewers: djasper, klimek, krasimir, benhamilton, JonasToth

Reviewed By: klimek

Subscribers: llvm-commits, mgorny, jdoerfert, cfe-commits

Tags: #clang, #clang-tools-extra

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

llvm-svn: 356662
2019-03-21 13:09:22 +00:00
..
INPUTS
bindings [libclang] Expose aligned() attribute. 2019-03-13 16:16:54 +00:00
cmake [CMake] Tell libc++ that we're using compiler-rt on Apple platforms 2019-03-12 15:32:00 +00:00
docs [clang-format] Add basic support for formatting C# files 2019-03-21 13:09:22 +00:00
examples [build] Rename clang-headers to clang-resource-headers 2019-03-04 21:19:53 +00:00
include [clang-format] Add basic support for formatting C# files 2019-03-21 13:09:22 +00:00
lib [clang-format] Add basic support for formatting C# files 2019-03-21 13:09:22 +00:00
runtime [CMake] External compiler-rt-configure requires LLVMTestingSupport when including tests 2019-02-01 15:35:25 +00:00
test [CFG] [analyzer] pr41142: C++17: Skip transparent InitListExprs in constructors. 2019-03-21 00:15:07 +00:00
tools [clang-format] Add basic support for formatting C# files 2019-03-21 13:09:22 +00:00
unittests [clang-format] Add basic support for formatting C# files 2019-03-21 13:09:22 +00:00
utils creduce-clang-crash.py: preprocess file + reduce commandline 2019-03-21 01:01:53 +00:00
www [Analyzer] Checker for non-determinism caused by sorting of pointer-like elements 2019-03-08 20:13:53 +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 Add --unwindlib=[libgcc|compiler-rt] to parallel --rtlib= [take 2] 2019-03-19 20:01:59 +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 Fix typos throughout the license files that somehow I and my reviewers 2019-01-21 09:52:34 +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/