|
41 | 41 | % version of the language which will actually be specified by the next stable
|
42 | 42 | % release of this document.
|
43 | 43 | %
|
| 44 | +% Sep 2025 |
| 45 | +% - Remove the rules about scoping with DartDoc comments. This topic is now |
| 46 | +% handled by each of the tools that process those comments in any way, and |
| 47 | +% this document only specifies the syntax of DartDoc comments. |
| 48 | +% |
44 | 49 | % Jul 2025
|
45 | 50 | % - Clarify that operator `[]` and `[]=` are included in the `void` allowlist
|
46 | 51 | % rule about formal parameters of type `void`, and so are setters.
|
@@ -23420,25 +23425,14 @@ \subsubsection{Comments}
|
23420 | 23425 | \LMHash{}%
|
23421 | 23426 | \IndexCustom{Documentation comments}{documentation comments}
|
23422 | 23427 | are comments that begin with the tokens \code{///} or \code{/**}.
|
23423 |
| -Documentation comments are intended to be processed by |
23424 |
| -a tool that produces human readable documentation. |
23425 |
| - |
23426 |
| -\LMHash{}% |
23427 |
| -The current scope for a documentation comment immediately preceding |
23428 |
| -the declaration of a class $C$ is the |
23429 |
| -\IndexCustom{body scope}{scope!for statement body} |
23430 |
| -of $C$. |
23431 |
| - |
23432 |
| -\LMHash{}% |
23433 |
| -The current scope for a documentation comment immediately preceding |
23434 |
| -the declaration of a non-redirecting generative constructor $k$ |
23435 |
| -with initializing formals is the formal parameter initializer scope of $k$ |
23436 |
| -(\ref{generativeConstructors}). |
23437 | 23428 |
|
23438 |
| -\LMHash{}% |
23439 |
| -Otherwise, the current scope for a documentation comment immediately preceding |
23440 |
| -the declaration of a function $f$ is the formal parameter scope of $f$ |
23441 |
| -(\ref{formalParameters}). |
| 23429 | +\rationale{% |
| 23430 | + Documentation comments are intended to be processed by |
| 23431 | + a tool that produces human readable documentation. |
| 23432 | + However, this document does not place any constraints |
| 23433 | + on the interpretation or use of documentation comments, |
| 23434 | + that is determined by each of the relevant tools.% |
| 23435 | +} |
23442 | 23436 |
|
23443 | 23437 |
|
23444 | 23438 | \subsection{Operator Precedence}
|
|
0 commit comments