Skip to content

Commit b12cf1c

Browse files
committed
Remove the rules about DartDoc comments in the language specification
1 parent d4eb915 commit b12cf1c

File tree

1 file changed

+12
-18
lines changed

1 file changed

+12
-18
lines changed

specification/dartLangSpec.tex

Lines changed: 12 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -41,6 +41,11 @@
4141
% version of the language which will actually be specified by the next stable
4242
% release of this document.
4343
%
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+
%
4449
% Jul 2025
4550
% - Clarify that operator `[]` and `[]=` are included in the `void` allowlist
4651
% rule about formal parameters of type `void`, and so are setters.
@@ -23420,25 +23425,14 @@ \subsubsection{Comments}
2342023425
\LMHash{}%
2342123426
\IndexCustom{Documentation comments}{documentation comments}
2342223427
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}).
2343723428

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+
}
2344223436

2344323437

2344423438
\subsection{Operator Precedence}

0 commit comments

Comments
 (0)