llvm-project/clang
Martin Probst b4cdb65e5f clang-format: [JS] do not wrap @see tags.
Summary:
@see is special among JSDoc tags in that it is commonly followed by URLs. The JSDoc spec suggests that users should wrap URLs in an additional {@link url...} tag (@see http://usejsdoc.org/tags-see.html), but this is very commonly violated, with @see being followed by a "naked" URL.

This change special cases all JSDoc lines that contain an @see not to be wrapped to account for that.

Reviewers: djasper

Subscribers: klimek, cfe-commits

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

llvm-svn: 297607
2017-03-13 09:39:23 +00:00
..
INPUTS
bindings [libclang] [OpenCL] Expose half type. 2017-02-10 15:51:11 +00:00
cmake Add a cmake cache file for a stage-2 build with ThinLTO 2017-03-09 01:18:31 +00:00
docs [clang-format] Add option to break before inheritance separation operator in class declaration. 2017-03-10 15:10:37 +00:00
examples Add LLVMOption to clang-interpreter, corresponding to r291938. 2017-01-14 08:54:05 +00:00
include Allow the nonnull attribute to be inherited as a parameter in the redefinition of a function. Fixes PR30828. 2017-03-12 22:30:07 +00:00
lib clang-format: [JS] do not wrap @see tags. 2017-03-13 09:39:23 +00:00
runtime [sanitizer] Passthrough CMAKE_OSX_DEPLOYMENT_TARGET and CMAKE_OSX_SYSROOT when building compiler-rt from clang/runtime/CMakeLists.txt 2016-12-15 23:20:54 +00:00
test Allow the nonnull attribute to be inherited as a parameter in the redefinition of a function. Fixes PR30828. 2017-03-12 22:30:07 +00:00
tools Add -cc1 flag -ast-dump-all to perform an AST dump including entities that haven't yet been deserialized. 2017-03-09 22:00:01 +00:00
unittests clang-format: [JS] do not wrap @see tags. 2017-03-13 09:39:23 +00:00
utils Improve workaround for Sphinx's lack of support for command line options containing '+', '.' etc. to be more stable as the set of options changes. 2017-01-27 01:54:42 +00:00
www [analyzer] Extend block in critical section check with C11 and Pthread APIs. 2017-03-10 14:50:12 +00:00
.arcconfig
.clang-format
.clang-tidy
.gitignore
CMakeLists.txt Define LLVM_ENABLE_WARNINGS when building standalone clang to ensure warnings get enabled 2017-03-07 00:15:18 +00:00
CODE_OWNERS.TXT
INSTALL.txt
LICENSE.TXT
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/