llvm-project/clang
Alexander Kornienko 547a9f5264 Better block comment formatting.
Summary:
1. When splitting one-line block comment, use indentation and *s.
2. Remove trailing whitespace from all lines of a comment, not only the ones being splitted.
3. Add backslashes for all lines if a comment is used insed a preprocessor directive.

Reviewers: djasper

Reviewed By: djasper

CC: cfe-commits, klimek

Differential Revision: http://llvm-reviews.chandlerc.com/D557

llvm-svn: 177635
2013-03-21 12:28:10 +00:00
..
INPUTS Revert 'Fix a typo 'iff' => 'if''. iff is an abreviation of if and only if. See: http://en.wikipedia.org/wiki/If_and_only_if Commit 164766 2012-09-27 10:16:10 +00:00
bindings cindex.py: Handle NULL pointers when parsing translation units 2013-03-19 15:30:48 +00:00
docs [docs] Point inquisitive users to existing module.map files. 2013-03-20 18:37:47 +00:00
examples Nuke SetUpBuildDumpLog. 2013-01-20 01:58:28 +00:00
include Fix a typo. 2013-03-21 06:09:09 +00:00
lib Better block comment formatting. 2013-03-21 12:28:10 +00:00
runtime Split ubsan runtime into three pieces (clang part): 2013-03-20 23:49:07 +00:00
test <rdar://problem/13037793> Allow the names of modules to differ from the name of their subdirectory in the include path. 2013-03-21 01:08:50 +00:00
tools Add clang-format binary to cfe. 2013-03-20 09:53:23 +00:00
unittests Better block comment formatting. 2013-03-21 12:28:10 +00:00
utils Documentation parsing. Some refactoring and code 2013-03-08 23:59:23 +00:00
www Add a linebreak. Linebreaks are cool. 2013-03-18 21:57:52 +00:00
.arcconfig Add .arcconfig to the repository. Useful if someone wants to use phabricator's command line tool. 2012-12-01 12:08:08 +00:00
.gitignore Reverted unintendedly-committed file. 2013-01-31 19:05:31 +00:00
CMakeLists.txt CMake: -Wno-nested-anon-types for Clang. 2013-03-02 00:49:47 +00:00
CODE_OWNERS.TXT Duplicate some common owners between Clang and LLVM. 2012-11-27 00:48:12 +00:00
INSTALL.txt Minor tweak to install docs 2013-02-05 22:01:16 +00:00
LICENSE.TXT Update the copyright coredits -- Happy new year 2013! 2013-01-01 10:00:19 +00:00
Makefile The top-level clang Makefile is #included into other Makefiles. (sigh) So we 2012-10-03 08:39:19 +00:00
ModuleInfo.txt
NOTES.txt Remove an uninteresting note 2013-02-05 21:13:55 +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.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/