mirror of
https://github.com/llvm/llvm-project.git
synced 2025-04-16 22:36:34 +00:00

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
76 lines
1.6 KiB
HTML
76 lines
1.6 KiB
HTML
|
|
def GlobalDocumentation {
|
|
code Intro =[{..
|
|
-------------------------------------------------------------------
|
|
NOTE: This file is automatically generated by running clang-tblgen
|
|
-gen-diag-docs. Do not edit this file by hand!!
|
|
-------------------------------------------------------------------
|
|
|
|
.. Add custom CSS to output. FIXME: This should be put into <head> rather
|
|
than the start of <body>.
|
|
.. raw:: html
|
|
|
|
<style>
|
|
table.docutils {
|
|
width: 1px;
|
|
}
|
|
table.docutils td {
|
|
border: none;
|
|
padding: 0 0 0 0.2em;
|
|
vertical-align: middle;
|
|
white-space: nowrap;
|
|
width: 1px;
|
|
font-family: monospace;
|
|
}
|
|
table.docutils tr + tr {
|
|
border-top: 0.2em solid #aaa;
|
|
}
|
|
.error {
|
|
font-family: monospace;
|
|
font-weight: bold;
|
|
color: #c00;
|
|
}
|
|
.warning {
|
|
font-family: monospace;
|
|
font-weight: bold;
|
|
color: #80a;
|
|
}
|
|
.remark {
|
|
font-family: monospace;
|
|
font-weight: bold;
|
|
color: #00c;
|
|
}
|
|
.diagtext {
|
|
font-family: monospace;
|
|
font-weight: bold;
|
|
}
|
|
</style>
|
|
|
|
.. FIXME: rST doesn't support formatting this, so we format all <td> elements
|
|
as monospace font face instead.
|
|
.. |nbsp| unicode:: 0xA0
|
|
:trim:
|
|
|
|
.. Roles generated by clang-tblgen.
|
|
.. role:: error
|
|
.. role:: warning
|
|
.. role:: remark
|
|
.. role:: diagtext
|
|
.. role:: placeholder(emphasis)
|
|
|
|
=========================
|
|
Diagnostic flags in Clang
|
|
=========================
|
|
.. contents::
|
|
:local:
|
|
|
|
Introduction
|
|
============
|
|
|
|
This page lists the diagnostic flags currently supported by Clang.
|
|
|
|
Diagnostic flags
|
|
================
|
|
}];
|
|
}
|