summaryrefslogtreecommitdiffstats
path: root/clang/docs/InternalsManual.rst
Commit message (Collapse)AuthorAgeFilesLines
* [ASTImporter][NFC] Update ASTImporter internals docsGabor Marton2019-10-071-11/+2
| | | | llvm-svn: 373895
* [docs] Fix some typos in InternalsManualSven van Haastregt2019-09-231-3/+3
| | | | llvm-svn: 372614
* [ASTImporter] Add development internals docsGabor Marton2019-09-131-0/+489
| | | | | | | | | | | | Reviewers: a_sidorin, shafik, teemperor, gamesh411, balazske, dkrupp, a.sidorin Subscribers: rnkovacs, Szelethus, cfe-commits Tags: #clang Differential Revision: https://reviews.llvm.org/D66336 llvm-svn: 371839
* Clarify when fix-it hints on warnings are appropriateAaron Puchert2019-05-311-0/+3
| | | | | | | | | | | | | | | | | | | | | Summary: This is not a change in the rules, it's meant as a clarification about warnings. Since the recovery from warnings is a no-op, the fix-it hints on warnings shouldn't change anything. Anything that doesn't just suppress the warning and changes the meaning of the code (even if it's for the better) should be on an additional note. Reviewers: rsmith, aaron.ballman Reviewed By: aaron.ballman Subscribers: cfe-commits, thakis Tags: #clang Differential Revision: https://reviews.llvm.org/D62470 llvm-svn: 362266
* Add some notes on immutability and faithfulness to the internals manual.Richard Smith2019-05-221-1/+92
| | | | llvm-svn: 361433
* Adjust documentation for git migration.James Y Knight2019-01-291-9/+9
| | | | | | | | | | | | | | | | | | | | | | | | | | | | This fixes most references to the paths: llvm.org/svn/ llvm.org/git/ llvm.org/viewvc/ github.com/llvm-mirror/ github.com/llvm-project/ reviews.llvm.org/diffusion/ to instead point to https://github.com/llvm/llvm-project. This is *not* a trivial substitution, because additionally, all the checkout instructions had to be migrated to instruct users on how to use the monorepo layout, setting LLVM_ENABLE_PROJECTS instead of checking out various projects into various subdirectories. I've attempted to not change any scripts here, only documentation. The scripts will have to be addressed separately. Additionally, I've deleted one document which appeared to be outdated and unneeded: lldb/docs/building-with-debug-llvm.txt Differential Revision: https://reviews.llvm.org/D57330 llvm-svn: 352514
* [Documentation] Use HTTPS whenever possibleEugene Zelenko2019-01-231-2/+2
| | | | | | Differential revision: https://reviews.llvm.org/D56946 llvm-svn: 351976
* PTH-- Remove feature entirely-Erich Keane2018-12-041-5/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | When debugging a boost build with a modified version of Clang, I discovered that the PTH implementation stores TokenKind in 8 bits. However, we currently have 368 TokenKinds. The result is that the value gets truncated and the wrong token gets picked up when including PTH files. It seems that this will go wrong every time someone uses a token that uses the 9th bit. Upon asking on IRC, it was brought up that this was a highly experimental features that was considered a failure. I discovered via googling that BoostBuild (mostly Boost.Math) is the only user of this feature, using the CC1 flag directly. I believe that this can be transferred over to normal PCH with minimal effort: https://github.com/boostorg/build/issues/367 Based on advice on IRC and research showing that this is a nearly completely unused feature, this patch removes it entirely. Note: I considered leaving the build-flags in place and making them emit an error/warning, however since I've basically identified and warned the only user, it seemed better to just remove them. Differential Revision: https://reviews.llvm.org/D54547 Change-Id: If32744275ef1f585357bd6c1c813d96973c4d8d9 llvm-svn: 348266
* Update our URLs in clang doc to use httpsSylvestre Ledru2018-11-041-12/+12
| | | | llvm-svn: 346101
* Remove stale documentation from InternalsManual.rstErich Keane2018-07-241-5/+0
| | | | | | | The DuplicatesAllowedWhileMerging was removed a while ago, but the documentation remained. llvm-svn: 337835
* [NFC] Rename clang::AttributeList to clang::ParsedAttrErich Keane2018-07-131-6/+6
| | | | | | | Since The type no longer contains the 'next' item anymore, it isn't a list, so rename it to ParsedAttr to be more accurate. llvm-svn: 337005
* [Clang Tablegen][RFC] Allow Early Textual Substitutions in `Diagnostic` ↵Eric Fiselier2018-05-191-0/+26
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | messages. Summary: There are cases where the same string or select is repeated verbatim in a lot of diagnostics. This can be a pain to maintain and update. Tablegen provides no way stash the common text somewhere and reuse it in the diagnostics, until now! This patch allows diagnostic texts to contain `%sub{<definition-name>}`, where `<definition-name>` names a Tablegen record of type `TextSubstitution`. These substitutions are done early, before the diagnostic string is otherwise processed. All `%sub` modifiers will be replaced before the diagnostic definitions are emitted. The substitution must specify all arguments used by the substitution, and modifier indexes in the substitution are re-numbered accordingly. For example: ``` def select_ovl_candidate : TextSubstitution<"%select{function|constructor}0%select{| template| %2}1">; ``` when used as ``` "candidate `%sub{select_ovl_candidate}3,2,1 not viable" ``` will act as if we wrote: ``` "candidate %select{function|constructor}3%select{| template| %1}2 not viable" ``` Reviewers: rsmith, rjmccall, aaron.ballman, a.sidorin Reviewed By: rjmccall Subscribers: cfe-commits Differential Revision: https://reviews.llvm.org/D46740 llvm-svn: 332799
* [docs] Fix docs/InternalsManual.rst heading.Fangrui Song2018-04-301-1/+1
| | | | llvm-svn: 331225
* Rename DiagnosticClient to DiagnosticConsumer as per issue 5397.Fangrui Song2018-04-301-8/+8
| | | | llvm-svn: 331152
* [NFC] fix trivial typos in comments and documentsHiroshi Inoue2018-01-261-1/+1
| | | | | | "in in" -> "in", "on on" -> "on" etc. llvm-svn: 323509
* Fix typos in documentationJan Korous2017-10-091-2/+2
| | | | | | Differential Revision: https://reviews.llvm.org/D38711 llvm-svn: 315252
* Fix some typos in the documentation.Gabor Horvath2017-08-031-6/+6
| | | | | | Patch by: Reka Nikolett Kovacs llvm-svn: 309948
* [NFC, documentation] Prefer the term expansion instead of macro instantiation Faisal Vali2017-07-221-2/+2
| | | | | | | | | ... in the few remaining places where this was not corrected. llvm-svn: 308823
* [docs] Change non-c++ code blocks to 'text' format to fix a sphinx warning.Alexander Kornienko2016-02-241-5/+5
| | | | llvm-svn: 261744
* Remove DataRecursiveASTVisitor; it no longer serves any purpose, since it's ↵Richard Smith2015-11-241-1/+1
| | | | | | just an alias for RecursiveASTVisitor. llvm-svn: 253949
* Update mailing list references to lists.llvm.orgTanya Lattner2015-08-051-1/+1
| | | | llvm-svn: 244000
* Made considerable updates to the documentation explaining how to add a new ↵Aaron Ballman2015-05-131-155/+267
| | | | | | attribute to clang. Cleans up some of the existing wording, as well as adding new information and better explanations. llvm-svn: 237268
* Replace DeclContext::getNextContext with DeclContext::collectAllContextsYaron Keren2015-02-071-5/+7
| | | | | | in the Clang CFE Internals Manual (done in r147729). llvm-svn: 228510
* Fix markup from r224894.Nico Weber2014-12-281-6/+6
| | | | llvm-svn: 224895
* Add stub sections about Parse, Sema, CodeGen to the internals manual.Nico Weber2014-12-281-0/+32
| | | | | | | | | | I'd be interested if the paragraph on Parse not knowing much about AST is something folks agree with. I think this used to be true after rjmccall removed the Action interface in r112244 and I believe it's still true, but I'm not sure. (For example, ParseOpenMP.cpp does include AST/StmtOpenMP.h. Other than that, Parse not using AST nodes much seems to be still true, though.) llvm-svn: 224894
* unique_ptrify the result of CFG::buildCFG/CFGBuilder::buildCFGDavid Blaikie2014-08-291-4/+1
| | | | llvm-svn: 216755
* Update internals manual on how to add AST nodes.Nico Weber2014-07-071-3/+4
| | | | | | | | StmtDumper.cpp is called ASTDumper.cpp these days, and usually works well for new AST nodes without changes. There's now DataRecursiveASTVisitor in addition to RecursiveASTVisitor, and serialization wasn't mentioned. llvm-svn: 212426
* Add 'remark' diagnostic type in 'clang'Tobias Grosser2014-02-281-4/+7
| | | | | | | | | | | | | | | | | | | | | | | 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. llvm-svn: 202475
* Implements a declarative approach to documenting individual attributes in ↵Aaron Ballman2014-02-171-0/+15
| | | | | | | | 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
* Adding a bit of documentation that was missed with r198883 (when ↵Aaron Ballman2014-01-201-0/+5
| | | | | | ParseArgumentsAsUnevaluated was added). llvm-svn: 199679
* Exposed a declarative way to specify that an attribute can be duplicated ↵Aaron Ballman2014-01-201-0/+5
| | | | | | when merging attributes on a declaration. This replaces some hard-coded functionality from Sema. llvm-svn: 199677
* Updating the documentation about how to add attributes based on the rather ↵Aaron Ballman2014-01-071-21/+124
| | | | | | extensive refactorings that have happened over the past several months. llvm-svn: 198705
* docs: Document CXXLiteralOperatorName and CXXUsingDirectiveJustin Bogner2013-09-271-2/+17
| | | | llvm-svn: 191560
* docs: Remove note about Identifiers being used for C++ operatorsJustin Bogner2013-09-271-4/+0
| | | | | | | C++ operators are represented by CXXOperatorName now, which is already documented. llvm-svn: 191559
* Document that we should recognize attributes supported by gcc with C++11Dmitri Gribenko2013-01-141-0/+2
| | | | | | | | [[gnu::...]] syntax Pointed out by Richard Smith on the mailing list. llvm-svn: 172487
* docs: Fix up HTML links to proper reST links.Sean Silva2013-01-021-2/+2
| | | | llvm-svn: 171382
* Documentation: random cleanups. Use monospaced font where appropriate,Dmitri Gribenko2012-12-151-2/+2
| | | | | | highlight console output with "code-block:: console", etc. llvm-svn: 170276
* Documentation: convert InternalsManual.html to reSTDmitri Gribenko2012-12-151-0/+1808
Patch by Anastasi Voitova with with small fixes by me. llvm-svn: 170275
OpenPOWER on IntegriCloud