Skip to content

Specify null safety #2605

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 92 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
92 commits
Select commit Hold shift + click to select a range
2da798d
Rebasing
eernstg Oct 7, 2021
81df258
Typos: Escaping braces meant to be code
eernstg Oct 8, 2021
fc74bfc
Eliminated text about migration features, adapted the remaining text …
eernstg Oct 8, 2021
f2013bb
Rebasing
eernstg Oct 13, 2021
62556c9
Reorganized material on null/Null
eernstg Oct 14, 2021
2653df1
Rebase
eernstg Oct 18, 2021
8d69311
Rebasing
eernstg Oct 27, 2021
8550ce1
Rebase
eernstg Nov 1, 2021
c858aba
WIP
eernstg Nov 9, 2021
7e1751f
Corrected last part of section Variables
eernstg Nov 10, 2021
5f306d7
Did expression typing, spread element, i2b
eernstg Nov 11, 2021
8d46fa0
Super-bounded types, least and greatest closure
eernstg Nov 12, 2021
ae0a256
Assignability, generics
eernstg Nov 12, 2021
565ee4d
Extreme types
eernstg Nov 12, 2021
6745dd6
Extreme types, helper functions
eernstg Nov 15, 2021
bf5c7e1
Rebase
eernstg Nov 16, 2021
0450154
.call insertion on nullable type; clean up BlindDefineSymbol
eernstg Nov 16, 2021
149de47
Rebase
eernstg Nov 16, 2021
97b4193
Main
eernstg Nov 16, 2021
ccc96fb
Type Type
eernstg Nov 17, 2021
900e2da
Type Type fixes
eernstg Nov 17, 2021
1da8ae5
More typeType fixes
eernstg Nov 17, 2021
e7ccf40
Constant instances (in particular: about canonical instances)
eernstg Nov 18, 2021
c901fbe
Corrected variable initialization specification ("has been stored" ra…
eernstg Nov 19, 2021
bbcf359
Small adjustments to Variables
eernstg Nov 19, 2021
6219f1b
Rebase
eernstg Nov 26, 2021
8ba0739
Boolean conversion; type test; made true/false terminology consistent…
eernstg Nov 29, 2021
37b1299
Constant types; type variable elimination in constants
eernstg Nov 29, 2021
fdef98e
Conditional expression; operators && and ||; `if` statements; delete …
eernstg Nov 30, 2021
b26617c
Integrate Null Promotion; put v==null rules into Type Promotion, and …
eernstg Dec 1, 2021
4fdbd54
Null shorting
eernstg Dec 1, 2021
97fb9b2
Small fixes in section Null Shorting
eernstg Dec 1, 2021
0064e98
Revisiting all occurrences of \NULL/Null/null
eernstg Dec 2, 2021
11d93e4
Did much of Standard ... Bounds
eernstg Dec 3, 2021
848f140
Standard bounds
eernstg Dec 7, 2021
ab32f41
Fixed the "SUB issues" section
eernstg Dec 8, 2021
2c1ef58
Rebase
eernstg Dec 8, 2021
063cec4
Rebase
eernstg Dec 8, 2021
9279288
Rebase
eernstg Dec 8, 2021
536297a
Rebase
eernstg Dec 9, 2021
302b33a
Rebase
eernstg Dec 10, 2021
7be2590
Clarified and corrected Canonical Syntax
eernstg Dec 10, 2021
bb04acf
Fixed subsubsection --> subsection, 2*
eernstg Dec 10, 2021
62743e6
Typos
eernstg Jan 5, 2022
a6c6fa5
Whitespace
eernstg Jan 6, 2022
f14fcbf
Interface type fixes
eernstg Jan 6, 2022
64d0c16
Sync with specify_null_safety_new_sections_dec21
eernstg Jan 7, 2022
4d6638f
Mark a subtype rule as redundant, in a TODO comment
eernstg Jan 7, 2022
419c25a
Adjust no-loops-in-noSuchMethod example
eernstg Feb 7, 2022
bbd0304
Adjust no-loops-in-noSuchMethod example
eernstg Feb 8, 2022
a2a3cf0
Corrected function type subtype rule (bounds); corrected "math" index…
eernstg May 3, 2022
55f4641
Adjust class building types
eernstg May 9, 2022
3ed136d
Adjust examples declaring non-nullable positional optional parameters…
eernstg Jul 26, 2022
da55910
Add a TODO to introduce `Any`
eernstg Nov 2, 2022
1f7baaa
Correct example in section about super-bounded types
eernstg Nov 3, 2022
61a874a
Correction based on https://github.com/dart-lang/language/issues/2679
eernstg Dec 2, 2022
d924341
Specify erasure of intersection types for the semantics of await expr…
eernstg Dec 9, 2022
084819c
Typo
eernstg Jan 20, 2023
e4de1b4
Introduce \DynamicError, marking all dynamic errors just like compile…
eernstg Feb 2, 2023
7af0ad8
Changed the error margin markers to use red text
eernstg Feb 2, 2023
3ee6e13
Correct dynamic type of tear-off with covariant parameter
eernstg May 31, 2023
c0c761b
Clarified tear-offs of methods with covariant parameters
eernstg May 31, 2023
aecc7bf
Correct a typo about closurization
eernstg May 31, 2023
8b29348
Correction: Add definition of normalizedType/topMergeType for member …
eernstg Jun 16, 2023
dae48c4
Correction: Update dynamic type of covariant parameter to Object?
eernstg Jun 22, 2023
780a9a2
Typo
eernstg Jun 29, 2023
7e3b383
Add commentary to emphasize that `new`/`const` can be implicit, and `…
eernstg Jul 5, 2023
5a713a8
Add missing updates in section typeVoid
eernstg Jul 6, 2023
170105c
Add missing error: default values must be type correct
eernstg Jul 13, 2023
d577b06
Add a paragraph explaining that the given section is about both optio…
eernstg Jul 13, 2023
64b171a
Post-rebase error correction
eernstg Jul 21, 2023
71ed8d0
Correct usages of "final variable" and "constant variable"
eernstg Jul 21, 2023
a3a63b6
Add missing declaration kind about getter/setter type error
eernstg Sep 11, 2023
fd0dd0d
Remove obsolete reference to "mixin composition" from section Supercl…
eernstg Sep 29, 2023
9e6261a
Add comment about default values of noSuchMethod forwarders being und…
eernstg Sep 29, 2023
b0e7962
Correct rule about the interface of T?
eernstg Jan 10, 2024
1a59eef
Correct rule about interfaces of bounded types
eernstg Jan 10, 2024
c1b2b0f
Corrected many occurrences of "string" to "string literal"
eernstg Feb 22, 2024
ae48435
Update the "parameter name `_...`" error
eernstg Apr 30, 2024
b477e19
Restore the index marker, define a command for it
eernstg Jun 17, 2024
8c1996c
Corrected the huge rebase operation (removed TODO material)
eernstg Jun 17, 2024
f386824
Fix obsolete ref
eernstg Aug 12, 2024
c5772bd
Introduce <memberedDeclarationBody> and use it
eernstg Aug 12, 2024
cbc7086
Add change log entry
eernstg Aug 12, 2024
84328b8
WIP
eernstg Oct 17, 2024
de18759
Clarified class building types
eernstg Nov 14, 2024
a24d195
Correct the order of "bind formals to actuals", which has been rather…
eernstg Nov 27, 2024
57efba6
Correct the incorrect cleam that Null implements Object
eernstg Feb 14, 2025
35363d3
Add missing cases to the definition of interface types
eernstg Apr 9, 2025
97d02b0
WIP
eernstg Apr 9, 2025
11030a6
Remove wrong brace
eernstg Jul 3, 2025
e2268f4
Fix one-liner commentary
eernstg Jul 3, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 19 additions & 15 deletions specification/dart.sty
Original file line number Diff line number Diff line change
Expand Up @@ -124,11 +124,11 @@
\newenvironment{commentary}[1]{{\color{commentaryColor}\sf{#1}}}{}

% Auxiliary functions.
\newcommand{\flattenName}{\mbox{\it flatten}}
\newcommand{\flattenName}{\metavar{flatten}}
\newcommand{\flatten}[1]{\ensuremath{\flattenName({#1})}}
\newcommand{\futureOrBase}[1]{\ensuremath{\mbox{\it futureOrBase}({#1})}}
\newcommand{\overrides}[1]{\ensuremath{\mbox{\it overrides}({#1})}}
\newcommand{\inherited}[1]{\ensuremath{\mbox{\it inherited}({#1})}}
\newcommand{\futureOrBase}[1]{\ensuremath{\metavar{futureOrBase}({#1})}}
\newcommand{\overrides}[1]{\ensuremath{\metavar{overrides}({#1})}}
\newcommand{\inherited}[1]{\ensuremath{\metavar{inherited}({#1})}}

% Used as a mini-section marker, indicating visibly that a range of
% text (usually just a couple of paragraphs) are concerned with one
Expand Down Expand Up @@ -173,9 +173,12 @@
\newcommand{\id}{\metavar{id}}
\newcommand{\op}{\metavar{op}}

% Used in margin to indicate that a term is being defined here.
\newcommand{\IndexMarker}{\ensuremath{^\vartriangle}}

% Used for defining occurrence of phrase, with customized index entry.
\newcommand{\IndexCustom}[2]{%
\leavevmode\marginpar{\ensuremath{_{^\vartriangle}}}\emph{#1}\index{#2}}
\leavevmode\marginpar{\IndexMarker}\emph{#1}\index{#2}}

% Used for the defining occurrence of a local symbol.
\newcommand{\DefineSymbol}[1]{%
Expand All @@ -196,11 +199,15 @@

% Same appearance, but not adding an entry to the index.
\newcommand{\NoIndex}[1]{%
\leavevmode\marginpar{\ensuremath{_{^\vartriangle}}}\emph{#1}}
\leavevmode\marginpar{\IndexMarker}\emph{#1}}

% Mark a compile-time error in the margin.
\newcommand{\Error}[1]{%
\leavevmode\marginpar{\ensuremath{_{^\ominus}}}{#1}}
\leavevmode\marginpar{\ensuremath{\textcolor{red}{\ominus}}}{#1}}

% Mark a dynamic error in the margin.
\newcommand{\DynamicError}[1]{%
\leavevmode\marginpar{\textcolor{red}{\Lightning}}{#1}}

% Used to specify comma separated lists of similar symbols.
\newcommand{\List}[3]{\ensuremath{{#1}_{#2},\,\ldots,\ {#1}_{#3}}}
Expand Down Expand Up @@ -402,9 +409,9 @@

% Same as \FunctionTypeNamed except suitable for inline usage, hence omitting
% the spacer argument.
\newcommand{\RawFunctionTypeNamed}[8]{%
\newcommand{\RawFunctionTypeNamed}[9]{%
\RawFunctionType{#1}{#2}{#3}{#4}{%
\FunctionTypeNamedParameters{#5}{#6}{#7}{#8}{r}}}
\FunctionTypeNamedParameters{#5}{#6}{#7}{#8}{#9}}}

% A variant of \FunctionTypeNamed that uses the standard symbols,
% that is, a function type with positional optional parameters which
Expand Down Expand Up @@ -466,17 +473,14 @@
\newcommand{\SubtypeStd}[2]{\Subtype{\Delta}{#1}{#2}}
% Subtype judgment where the environment is omitted (NE: "no environment").
\newcommand{\SubtypeNE}[2]{\ensuremath{{#1}\,<:\,{#2}}}
\newcommand{\MutualSubtype}[3]{\ensuremath{{#1}\vdash{#2}\,<:>\,{#3}}}
\newcommand{\MutualSubtypeStd}[2]{\MutualSubtype{\Delta}{#1}{#2}}
\newcommand{\MutualSubtypeNE}[2]{\ensuremath{{#1}\,<:>\,{#2}}}

% Judgment expressing that a supertype relation exists.
\newcommand{\Supertype}[3]{\ensuremath{{#1}\vdash{#2}\,:>\,{#3}}}
\newcommand{\SupertypeStd}[2]{\Supertype{\Delta}{#1}{#2}}

% Judgment expressing that an assignability relation exists.
\newcommand{\AssignableRelationSymbol}{\ensuremath{\Longleftrightarrow}}
\newcommand{\Assignable}[3]{%
\ensuremath{{#1}\vdash{#2}\,\AssignableRelationSymbol\,{#3}}}
\newcommand{\AssignableStd}[2]{\Assignable{\Gamma}{#1}{#2}}

% Semantic function delivering the superinterfaces of a class.
\newcommand{\Superinterfaces}[1]{\ensuremath{\metavar{Superinterfaces}({#1})}}
\newcommand{\Superinterface}[2]{{#1}\in\Superinterfaces{#2}}
Expand Down
Loading