summaryrefslogtreecommitdiff
path: root/docs/UsersManual.rst
Commit message (Collapse)AuthorAge
* Add new debug kind LocTrackingOnly.Diego Novillo2014-06-24
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Summary: This new debug emission kind supports emitting line location information in all instructions, but stops code generation from emitting debug info to the final output. This mode is useful when the backend wants to track source locations during code generation, but it does not want to produce debug info. This is currently used by optimization remarks (-Rpass, -Rpass-missed and -Rpass-analysis). When one of the -Rpass flags is used, the front end will enable location tracking, only if no other debug option is enabled. To prevent debug information from being generated, a new debug info kind LocTrackingOnly causes DIBuilder::createCompileUnit() to not emit the llvm.dbg.cu annotation. This blocks final code generation from generating debug info in the back end. Depends on D4234. Reviewers: echristo, dblaikie Subscribers: cfe-commits Differential Revision: http://reviews.llvm.org/D4235 git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@211610 91177308-0d34-0410-b5e6-96231b3b80d8
* Add documentation for PGO with instrumentation to clang's User's Manual.Bob Wilson2014-06-17
| | | | | | <rdar://problem/16771671> git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@211085 91177308-0d34-0410-b5e6-96231b3b80d8
* Document Darwin-specific defaults.Adrian Prantl2014-06-13
| | | | git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@210958 91177308-0d34-0410-b5e6-96231b3b80d8
* Make these two words equally bold.Adrian Prantl2014-06-13
| | | | git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@210938 91177308-0d34-0410-b5e6-96231b3b80d8
* Copy the documentation of -fstandalone-debug from the man page to the userAdrian Prantl2014-06-13
| | | | | | | | manual. rdar://problem/17307006 git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@210936 91177308-0d34-0410-b5e6-96231b3b80d8
* Remove top-level Clang -fsanitize= flags for optional ASan features.Alexey Samsonov2014-06-13
| | | | | | | | | | | | | | Init-order and use-after-return modes can currently be enabled by runtime flags. use-after-scope mode is not really working at the moment. The only problem I see is that users won't be able to disable extra instrumentation for init-order and use-after-scope by a top-level Clang flag. But this instrumentation was implicitly enabled for quite a while and we didn't hear from users hurt by it. git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@210924 91177308-0d34-0410-b5e6-96231b3b80d8
* Add documentation for -Rpass*Diego Novillo2014-05-29
| | | | | | | | | | | | | | Summary: This adds documentation for -Rpass, -Rpass-missed and -Rpass-analysis. It also adds release notes for 3.5. Reviewers: rsmith Subscribers: cfe-commits Differential Revision: http://reviews.llvm.org/D3730 git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@209841 91177308-0d34-0410-b5e6-96231b3b80d8
* Review feedback.Diego Novillo2014-04-23
| | | | git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@206997 91177308-0d34-0410-b5e6-96231b3b80d8
* Review feedback.Diego Novillo2014-04-23
| | | | git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@206996 91177308-0d34-0410-b5e6-96231b3b80d8
* Review feedbackDiego Novillo2014-04-23
| | | | git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@206995 91177308-0d34-0410-b5e6-96231b3b80d8
* Add documentation for sample profiling support.Diego Novillo2014-04-23
| | | | | | | | | | | | | | | Summary: This documents the usage of sample profilers with Clang and the profile format expected by LLVM's optimizers. It also documents the profile conversion tool used by Linux Perf. Reviewers: doug.gregor CC: cfe-commits Differential Revision: http://reviews.llvm.org/D3402 git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@206994 91177308-0d34-0410-b5e6-96231b3b80d8
* Move the -i[no-]system-prefix options from CC1Options.td to Options.td.Alexander Kornienko2014-03-26
| | | | | | | | | | | | | | | | Summary: This allows them to be used without -cc1 the same way as -I and -isystem. Renamed the options to --system-header-prefix=/--no-system-header-prefix to avoid interference with -isystem and make the intent of the option cleaner. Reviewers: rsmith Reviewed By: rsmith CC: cfe-commits Differential Revision: http://llvm-reviews.chandlerc.com/D3185 git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@204775 91177308-0d34-0410-b5e6-96231b3b80d8
* [msan] -fsanitize-memory-track-origins=[level] flag and docs.Evgeniy Stepanov2014-03-20
| | | | | | | | | | This change turns -fsanitize-memory-track-origins into -fsanitize-memory-track-origins=[level] flag (keeping the old one for compatibility). Possible levels are 0 (off), 1 (default) and 2 (incredibly detailed). See docs (part of this patch) for more info. git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@204346 91177308-0d34-0410-b5e6-96231b3b80d8
* Kill -faddress-sanitizer, -fthread-sanitizer and -fcatch-undefined-behavior ↵Alexey Samsonov2014-03-20
| | | | | | | | | | flags. These flags are deprecated since at least Clang 3.3. Users should instead use -fsanitize= with appropriate values. git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@204330 91177308-0d34-0410-b5e6-96231b3b80d8
* Add a note in the user manual that tsan is not supported on Mac.Nico Weber2014-03-07
| | | | | | | Patch from Sean McBride <sean@rogue-research.com>! git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@203260 91177308-0d34-0410-b5e6-96231b3b80d8
* "Mac OS/X" -> "Mac OS X" spelling fixes for clang.Nico Weber2014-03-07
| | | | | | | Patch from Sean McBride <sean@rogue-research.com>! git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@203259 91177308-0d34-0410-b5e6-96231b3b80d8
* Expand documentation section on comment parsingDmitri Gribenko2014-03-06
| | | | | | | Patch by Jonathan Sauer, with a little editing by me. git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@203128 91177308-0d34-0410-b5e6-96231b3b80d8
* Add 'remark' diagnostic type in 'clang'Tobias Grosser2014-02-28
| | | | | | | | | | | | | | | | | | | | | | | A 'remark' is information that is not an error or a warning, but rather some additional information provided to the user. In contrast to a 'note' a 'remark' is an independent diagnostic, whereas a 'note' always depends on another diagnostic. A typical use case for remark nodes is information provided to the user, e.g. information provided by the vectorizer about loops that have been vectorized. This patch provides the initial implementation of 'remarks'. It includes the actual definiton of the remark nodes, their printing as well as basic parameter handling. We are reusing the existing diagnostic parameters which means a remark can be enabled with normal '-Wdiagnostic-name' flags and can be upgraded to an error using '-Werror=diagnostic-name'. '-Werror' alone does not upgrade remarks. This patch is by intention minimal in terms of parameter handling. More experience and more discussions will most likely lead to further enhancements in the parameter handling. git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@202475 91177308-0d34-0410-b5e6-96231b3b80d8
* [AArch64] Replace underscores with dashes in -mgeneral_regs_only.Amara Emerson2014-01-24
| | | | | | | This should now match the equivalent gcc option. git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@200008 91177308-0d34-0410-b5e6-96231b3b80d8
* [AArch64] Add -mgeneral_regs_only option.Amara Emerson2014-01-23
| | | | git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@199904 91177308-0d34-0410-b5e6-96231b3b80d8
* Add documentation for -m16 option on X86, fix typoDavid Woodhouse2014-01-23
| | | | git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@199894 91177308-0d34-0410-b5e6-96231b3b80d8
* Update user manual to note that implementation for C++11 and C++1y is ↵Richard Smith2013-12-12
| | | | | | complete, and fix a bunch of other issues here. git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@197120 91177308-0d34-0410-b5e6-96231b3b80d8
* Remove old -fdiagnostics-show-name optionAlp Toker2013-12-09
| | | | | | | | This had no effect since the feature was removed in r150612. I actually miss this option, maybe we can bring it back some day. git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@196782 91177308-0d34-0410-b5e6-96231b3b80d8
* Add a limit to the length of a sequence of 'operator->' functions we willRichard Smith2013-11-06
| | | | | | | | follow when building a class member access expression. Based on a patch by Rahul Jain! git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@194161 91177308-0d34-0410-b5e6-96231b3b80d8
* ARM: Add -m[no-]crc to dis/enable CRC subtargetfeature from clangBernard Ogden2013-10-29
| | | | | | | | Allow users to disable or enable CRC subtarget feature. Differential Revision: http://llvm-reviews.chandlerc.com/D2037 git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@193600 91177308-0d34-0410-b5e6-96231b3b80d8
* Document that -fsanitize=function is Linux-only.Peter Collingbourne2013-10-26
| | | | git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@193452 91177308-0d34-0410-b5e6-96231b3b80d8
* Add the __ARM_ARCH_EXT_IDIV__ predefine. It is set to 1 if we have hardware ↵Silviu Baranga2013-10-21
| | | | | | divide in the mode that we are compiling in (depending on the target features), not defined if we don't. Should be compatible with the GCC conterpart. Also adding a -hwdiv option to overide the default behavior. git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@193074 91177308-0d34-0410-b5e6-96231b3b80d8
* Implement function type checker for the undefined behavior sanitizer.Peter Collingbourne2013-10-20
| | | | | | | | | This uses function prefix data to store function type information at the function pointer. Differential Revision: http://llvm-reviews.chandlerc.com/D1338 git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@193058 91177308-0d34-0410-b5e6-96231b3b80d8
* clang-cl: Add support for asm listings (/FA and /Fa)Hans Wennborg2013-10-17
| | | | | | | | | | This adds support for outputing the assembly to a file during compilation. It does this by changing the compilation pipeling to not use the integrated assembler, and keep the intermediate assembler file. Differential Revision: http://llvm-reviews.chandlerc.com/D1946 git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@192902 91177308-0d34-0410-b5e6-96231b3b80d8
* Add a section about clang-cl to UsersManual.rstHans Wennborg2013-10-10
| | | | | | Differential Revision: http://llvm-reviews.chandlerc.com/D1881 git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@192337 91177308-0d34-0410-b5e6-96231b3b80d8
* Update -fmsc-version docs for r190908, which set the default to 1700Reid Kleckner2013-09-20
| | | | git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@191098 91177308-0d34-0410-b5e6-96231b3b80d8
* Fix ReST links I just added to the manualReid Kleckner2013-09-20
| | | | git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@191097 91177308-0d34-0410-b5e6-96231b3b80d8
* Clarify that we silently ignore some MS extensions like IDL attributesReid Kleckner2013-09-20
| | | | git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@191096 91177308-0d34-0410-b5e6-96231b3b80d8
* Use -fms-compatibility to trigger lookup into dep. basesReid Kleckner2013-09-20
| | | | | | | Update the docs for -fms-extensions and -fms-compatibility to try to clarify the difference between the two. git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@191095 91177308-0d34-0410-b5e6-96231b3b80d8
* Clarify the status of PowerPC support.Roman Divacky2013-09-11
| | | | git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@190533 91177308-0d34-0410-b5e6-96231b3b80d8
* Add -fansi-escape-codes optionNico Rieck2013-09-11
| | | | | | | | | | | | | Some build systems use pipes for stdin/stderr. On nix-ish platforms colored output can be forced by -fcolor-diagnostics. On Windows this option has no effect in these cases because LLVM uses the console API (which only operates on the console buffer) even if a console wrapper capable of interpreting ANSI escape codes is used. The -fansi-escape-codes option allows switching from the console API to ANSI escape codes. It has no effect on other platforms. git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@190464 91177308-0d34-0410-b5e6-96231b3b80d8
* manual: Fix RST reference to MS extension supportReid Kleckner2013-09-05
| | | | git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@190101 91177308-0d34-0410-b5e6-96231b3b80d8
* Fix typo in template diffing docs.Richard Trieu2013-08-09
| | | | git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@188120 91177308-0d34-0410-b5e6-96231b3b80d8
* DataFlowSanitizer; Clang changes.Peter Collingbourne2013-08-07
| | | | | | | | | | | | | DataFlowSanitizer is a generalised dynamic data flow analysis. Unlike other Sanitizer tools, this tool is not designed to detect a specific class of bugs on its own. Instead, it provides a generic dynamic data flow analysis framework to be used by clients to help detect application-specific issues within their own code. Differential Revision: http://llvm-reviews.chandlerc.com/D966 git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@187925 91177308-0d34-0410-b5e6-96231b3b80d8
* Documentation for sanitizer special case list format and ↵Alexey Samsonov2013-08-07
| | | | | | -f(no-)?sanitize-blacklist flag git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@187871 91177308-0d34-0410-b5e6-96231b3b80d8
* Update users manual to indicate:Richard Smith2013-07-19
| | | | | | | | 1) clang++ must be used when linking C++ programs using -fsanitize=undefined, and 2) MSan can't be combined with TSan or ASan. git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@186711 91177308-0d34-0410-b5e6-96231b3b80d8
* [docs] `-fno-sanitize=` is accepted too.Sean Silva2013-06-21
| | | | git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@184611 91177308-0d34-0410-b5e6-96231b3b80d8
* Document -fno-sanitize-recover and -fsanitize-undefined-trap-on-error and ↵Richard Smith2013-05-29
| | | | | | attempt to explain the difference between them. git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@182890 91177308-0d34-0410-b5e6-96231b3b80d8
* Document Clang's support for #pragma comment(lib/linker) with -fms-extensionsReid Kleckner2013-05-08
| | | | | | As suggested by Dmitri Gribenko. git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@181433 91177308-0d34-0410-b5e6-96231b3b80d8
* Implemented #pragma GCC warning/error in the same mould as #pragma message.Andy Gibbs2013-04-17
| | | | git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@179687 91177308-0d34-0410-b5e6-96231b3b80d8
* Add an option to parse all comments as documentation commentsDmitri Gribenko2013-04-10
| | | | | | | Patch by Amin Shali. git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@179180 91177308-0d34-0410-b5e6-96231b3b80d8
* [ASan] Update docs for -fsanitize=init-order optionAlexey Samsonov2013-03-14
| | | | git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@177062 91177308-0d34-0410-b5e6-96231b3b80d8
* [docs] Add ellipsis.Sean Silva2013-03-11
| | | | git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@176810 91177308-0d34-0410-b5e6-96231b3b80d8
* Add -fbracket-depth=N, analogous to -ftemplate-depth= and -fconstexpr-depth=,Richard Smith2013-02-22
| | | | | | | | | | | | to control the check for the C 5.2.4.1 / C++ [implimits] restriction on nesting levels for parentheses, brackets and braces. Some code with heavy macro use exceeds the default limit of 256, but we don't want to increase it generally to avoid stack overflow on stack-constrained systems. git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@175855 91177308-0d34-0410-b5e6-96231b3b80d8
* [docs] The stat cache has been removed from the PCH, update the docs to ↵Argyrios Kyrtzidis2013-02-14
| | | | | | remove mentions of it. git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@175109 91177308-0d34-0410-b5e6-96231b3b80d8