From 1dfb72f92150ef86b75505bd72f81abc3fb361fe Mon Sep 17 00:00:00 2001 From: Dmitri Gribenko Date: Tue, 17 Jul 2012 18:51:47 +0000 Subject: [PATCH] Minor cleanups and additions to the users manual. UsersManual.html now validates as HTML 4.01 Strict. Patch by Jonathan Sauer! (With minor edits from me.) git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@160386 91177308-0d34-0410-b5e6-96231b3b80d8 --- docs/UsersManual.html | 30 ++++++++++++++++++------------ 1 file changed, 18 insertions(+), 12 deletions(-) diff --git a/docs/UsersManual.html b/docs/UsersManual.html index 22d44ceea1..629d9b2574 100644 --- a/docs/UsersManual.html +++ b/docs/UsersManual.html @@ -187,9 +187,10 @@ introduces the language selection and other high level options like -c, -g, etc.

-Werror=foo: Turn warning "foo" into an error.

-Wno-error=foo: Turn warning "foo" into an warning even if -Werror is specified.

-

-Wfoo: Enable warning foo

-

-Wno-foo: Disable warning foo

+

-Wfoo: Enable warning "foo".

+

-Wno-foo: Disable warning "foo".

-w: Disable all warnings.

+

-Weverything: Enable all warnings.

-pedantic: Warn on language extensions.

-pedantic-errors: Error on language extensions.

-Wsystem-headers: Enable warnings from system headers.

@@ -428,7 +429,7 @@ care if your source contains multibyte characters.

-fno-elide-type: -Turns off elision in template type printing. +Turns off elision in template type printing.

The default for template type printing is to elide as many template arguments as possible, removing those which are the same in both template types, leaving only the differences. Adding this flag will print all the template @@ -447,7 +448,7 @@ t.cc:4:5: note: candidate function not viable: no know

-fdiagnostics-show-template-tree: -Template type diffing prints a text tree. +Template type diffing prints a text tree.

For diffing large templated types, this option will cause Clang to display the templates as an indented text tree, one argument per line, with differences marked inline. This is compatible with -fno-elide-type.

@@ -496,9 +497,6 @@ the end of preprocessor directives. For example:

These extra tokens are not strictly conforming, and are usually best handled by commenting them out.

- -

This option is also enabled by -Wfoo, -Wbar, - and -Wbaz.

@@ -662,7 +660,7 @@ mapping of category names to category id's can be obtained by running 'clang

Controlling Diagnostics via Command Line Flags

-

-W flags, -pedantic, etc

+

TODO: -W flags, -pedantic, etc

Controlling Diagnostics via Pragmas

@@ -764,7 +762,6 @@ by the user via changes to the source code. See the avaliable the analyzer's FAQ page for more information. -

Precompiled Headers

@@ -1037,9 +1034,18 @@ interest in these features yet, so it's hard to say when they will be implemented.
  • clang does not support nested functions; this is a complex feature which -is infrequently used, so it is unlikely to be implemented anytime soon.
    • +is infrequently used, so it is unlikely to be implemented anytime soon. In C++11 +it can be emulated by assigning lambda functions to local variables, e.g: +
    +  auto const local_function = [&](int parameter) {
+    // Do something
+  };
+  ...
+  local_function(1);
+
    + -
  • clang does not support global register variables, this is unlikely +
  • clang does not support global register variables; this is unlikely to be implemented soon because it requires additional LLVM backend support.
    • @@ -1055,7 +1061,7 @@ in 4.3, the glibc headers will not try to use this extension with clang at the moment.
  • clang does not support the gcc extension for forward-declaring function -parameters; this has not showed up in any real-world code yet, though, so it +parameters; this has not shown up in any real-world code yet, though, so it might never be implemented.
    • -- 2.50.1