ae88b72ac8
AttributeReference: Document __single_inhertiance, __multiple_inheritance, __virtual_inheritance
...
Add documentation for these attributes, it includes:
- Motivation for their existence.
- Examples on how to use them.
- Examples on how to misuse them.
llvm-svn: 202121
2014-02-25 08:28:55 +00:00
27d8b20ee5
Modules: Fix malformed reStructuredText
...
llvm-svn: 202117
2014-02-25 06:22:25 +00:00
6fe8a7fe8a
AttributeReference: Fix a typo
...
llvm-svn: 202112
2014-02-25 05:33:01 +00:00
f45fa3dca5
Fix typos
...
llvm-svn: 202108
2014-02-25 04:21:44 +00:00
c523dcff29
Clarifying the wording for the noduplicate attribute.
...
Patch by Marcello Maggioni!
llvm-svn: 202035
2014-02-24 13:46:15 +00:00
0389269a7d
Fix AST matcher documentation for overloaded matchers.
...
Before this patch we would only use the fist occurance of a matcher
function in the documentation, for example leaving out
hasType(Matcher<QualType>).
llvm-svn: 202019
2014-02-24 10:40:22 +00:00
4f8f890ade
Fix docs generation for the AST matchers:
...
1. Move internal functions into ASTMatchersInternal.
2. Adapt dump_ast_matchers.py to the new VariadicOperatorMatcherFunc
signature.
3. Update the actual docs with the updated tool / code.
llvm-svn: 202017
2014-02-24 10:28:36 +00:00
5afdd1d770
Fixing the indentation of the RST content in the release notes. Fixes two warnings when building the HTML content and improves the format of the resulting content.
...
llvm-svn: 201987
2014-02-23 16:27:21 +00:00
3aa840e685
Release Notes: document -f{,no-}integrate-as
...
Now that the integrated assembler is considered a first class feature of the
compiler and has a proper feature flag, document the change in the compiler
flags. Ensure that we indicate that the legacy flags are still available, but,
encourage users to switch to the feature flags.
llvm-svn: 201964
2014-02-23 02:08:45 +00:00
19c02d29f5
Adding manual headings to the new capability attributes' documentation.
...
llvm-svn: 201942
2014-02-22 19:04:55 +00:00
7c19ab17c7
Exposing the noduplicate attribute within Clang, which marks functions so that the optimizer does not duplicate code.
...
Patch thanks to Marcello Maggioni!
llvm-svn: 201941
2014-02-22 16:59:24 +00:00
5ee46d2a9e
Moving the documentation for the format attribute into AttrDocs.
...
llvm-svn: 201857
2014-02-21 14:36:13 +00:00
ea6668c4e8
Moving the documentation for the type safety checking attributes into AttrDocs. If a custom heading is provided, do not automatically generate the alternate spelling list. This is necessary because some attributes have distinct semantic spellings and meanings, but use the same semantic attribute internally. Such attributes should have multiple elements in their documentation list, but not show all spellings. At some point, it would be nice to have a way to attach the documentation element to a specific spelling for these cases.
...
llvm-svn: 201851
2014-02-21 14:14:04 +00:00
7803b888c4
Moving the documentation for the sanitizer negation attributes into AttrDocs.
...
llvm-svn: 201850
2014-02-21 13:44:43 +00:00
68893db056
Doing some temporary touch-up on the gnu namespace attribute documentation, from a post-commit review comment.
...
Ideally, this content will eventually find a home with the rest of the attribute documentation.
llvm-svn: 201736
2014-02-19 23:21:40 +00:00
5142a2c03a
Until attribute documentation is implemented as a server-side feature, I will be manually committing AttributeReference.rst so that attribute documentation can be on the live server instead of simply disappearing from the language extensions page without obvious replacement.
...
This is a temporary stop-gap solution until server-side generation is implemented, at which point the AttributeReference.rst will go back to holding placeholder text.
llvm-svn: 201733
2014-02-19 23:09:37 +00:00
4de1b584cd
Refactored the way attribute category headers are handled so that it is possible to use custom categories. This allows for moving the consumable attributes (consumable, callable_when, return_typestate, etc) to be grouped together, with a content heading, like they were in the language extensions documentation. Moved the consumable attribute documentation from the language extensions into the attribute documentation table.
...
llvm-svn: 201732
2014-02-19 22:59:32 +00:00
0e4aa52e88
Moving the documentation for the ARM interrupt attribute into AttrDocs.
...
llvm-svn: 201716
2014-02-19 21:12:23 +00:00
896bace47f
Moving the documentation for the clang::fallthrough attribute into AttrDocs.
...
llvm-svn: 201715
2014-02-19 20:56:51 +00:00
0580cd4ff5
Some of these headings had the incorrect number of "underlines" and so would get warnings when generating the content from Sphinx. No functional changes intended.
...
llvm-svn: 201713
2014-02-19 20:43:58 +00:00
9751a7285e
Moving the documentation for the availability attribute into AttrDocs.
...
llvm-svn: 201712
2014-02-19 20:39:48 +00:00
aa7bca15f0
Updated tutorial code according to the changes in r197139.
...
Thanks to Konrad Kleine for reporting the inconsistency!
llvm-svn: 201693
2014-02-19 16:11:38 +00:00
840cef3e0d
Moving the documentation for the objc_requires_super attribute into AttrDocs.
...
llvm-svn: 201687
2014-02-19 15:45:13 +00:00
c0331f5fe0
Moving the documentation for the objc_method_family attribute into AttrDocs.
...
llvm-svn: 201686
2014-02-19 15:38:02 +00:00
683ea9cb12
Moving the documentation for the overloadable attribute into AttrDocs.
...
llvm-svn: 201678
2014-02-19 14:53:20 +00:00
20750f591d
Moving the documentation for the enable_if attribute into AttrDocs. Removed the "clang introduces" phrase for style consistency, but otherwise the documentation is identical.
...
llvm-svn: 201677
2014-02-19 14:48:31 +00:00
c51e08c7ea
Updated documentation for Thread Safety Analysis.
...
llvm-svn: 201598
2014-02-18 19:42:01 +00:00
97dba048a3
Implements a declarative approach to documenting individual attributes in Clang via a Documentation tablegen class. Also updates the internals manual with information about how to use this new, required, documentation feature.
...
This patch adds some very, very sparse initial documentation for some attributes. Additional effort from attribute authors is greatly appreciated.
llvm-svn: 201515
2014-02-17 15:27:10 +00:00
ee107adb7d
clang-format: Improve documentation of DerivePointerBinding.
...
For reference: llvm.org/PR18690.
Also updated generated help page and page creation script.
llvm-svn: 201323
2014-02-13 12:51:50 +00:00
2220dfadda
Fix indentation of a code example in LibTooling's documentation.
...
llvm-svn: 200944
2014-02-06 20:16:05 +00:00
4fa81df455
Changed OptionCategory variables to be static.
...
llvm-svn: 200876
2014-02-05 21:28:03 +00:00
870baf8cb3
[sanitizer] update the list of supported platforms in the docs
...
llvm-svn: 200529
2014-01-31 10:49:34 +00:00
8993f26550
Clarify. Thanks to Sean Silva and Warren Hunt for help wordsmithing!
...
llvm-svn: 200292
2014-01-28 07:03:46 +00:00
b05a8440cc
Fix always-false conditional thinko in documentation.
...
llvm-svn: 200289
2014-01-28 06:20:56 +00:00
4af8fa9ae4
Remove buggy example code from the documentation
...
Instead point readers to the latest, correct example code in SVN until we find
a way to automatically include example sources into the documentation (or until
someone steps up to maintain these actively).
This ensures that the examples are up-to-date, buildable, and most of all that
readers don't pick up incorrect usage.
llvm-svn: 200125
2014-01-26 05:08:07 +00:00
c158c5a029
Remove HTML codes from a .rst file. The proper HTML code will be added back
...
when the .html file is generated.
llvm-svn: 200060
2014-01-25 01:32:39 +00:00
05d816d0e2
[AArch64] Replace underscores with dashes in -mgeneral_regs_only.
...
This should now match the equivalent gcc option.
llvm-svn: 200008
2014-01-24 15:15:27 +00:00
81830b204b
Remove outdated documentation suggesting we don't support the C++1y lambda extensions.
...
llvm-svn: 199964
2014-01-24 02:12:28 +00:00
04e2ecfda2
[AArch64] Add -mgeneral_regs_only option.
...
llvm-svn: 199904
2014-01-23 15:48:30 +00:00
ddf8985325
Add documentation for -m16 option on X86, fix typo
...
llvm-svn: 199894
2014-01-23 14:32:46 +00:00
b39a9b8b0c
Adding a bit of documentation that was missed with r198883 (when ParseArgumentsAsUnevaluated was added).
...
llvm-svn: 199679
2014-01-20 18:42:10 +00:00
b9023ed0f6
Exposed a declarative way to specify that an attribute can be duplicated when merging attributes on a declaration. This replaces some hard-coded functionality from Sema.
...
llvm-svn: 199677
2014-01-20 18:07:09 +00:00
73287bfe40
MSVC 2013 type trait support
...
Implement type trait primitives used in the latest edition of the Microsoft
standard C++ library type_traits header.
With this change we can parse much of the Visual Studio 2013 standard headers,
particularly anything that includes <type_traits>.
Fully implemented, available in all language modes:
* __is_constructible()
* __is_nothrow_constructible()
* __is_nothrow_assignable()
Partially implemented, semantic analysis WIP, available as MS extensions:
* __is_destructible()
* __is_nothrow_destructible()
llvm-svn: 199619
2014-01-20 00:24:09 +00:00
64197b9eb9
docs: clarify the role of compiler-builtin type trait primitives
...
Update the documentation to clarify the intent of clang's built-in type trait
facilities, their relation to user-facing C++ type traits and means to check
for availability.
Also explain that __has_feature() is not currently up to date and should not
generally be used in user code (there's a proposal to provide more consistent
checks via __has_builtin(), see cfe-dev).
llvm-svn: 199562
2014-01-18 21:49:02 +00:00
ed91da719e
Try to fix this link.
...
llvm-svn: 199538
2014-01-18 02:29:10 +00:00
f47e667c05
[ASan] Enough to have llvm-symbolizer in $PATH.
...
llvm-svn: 199388
2014-01-16 14:01:39 +00:00
108bc0311f
[ASan] Typo fix (symbolize=0 disables online symbolization)
...
llvm-svn: 199385
2014-01-16 13:48:16 +00:00
c7549007c9
[ASan] Describe online/offline symbolization of reports, mention dsymutil.
...
llvm-svn: 199383
2014-01-16 13:46:29 +00:00
9c8754f56b
This code block wasn't showing up in the html. Try this?
...
llvm-svn: 199306
2014-01-15 08:33:00 +00:00
b9737cd0bc
Fix the attribute enable_if example in the docs to be 100% real-world, instead of merely being close to the real world to mislead people. This now matches the test.
...
llvm-svn: 199298
2014-01-15 06:34:12 +00:00
David Majnemer