Skip to content

Commit c5d3083

Browse files
committed
[docs] Add "overlay", "runtime", and "stdlib" to Lexicon.rst.
1 parent 7623708 commit c5d3083

File tree

1 file changed

+16
-0
lines changed

1 file changed

+16
-0
lines changed

docs/Lexicon.rst

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -128,6 +128,12 @@ source code, tests, and commit messages. See also the `LLVM lexicon`_.
128128
An `existential` value with its dynamic type pulled out, so that the
129129
compiler can do something with it.
130130

131+
overlay
132+
A library that is imported whenever a C library or framework by the same
133+
name is imported. The purpose of an overlay is to augment and extend a
134+
library on the system when the library on the system cannot be modified.
135+
Apple has a number of overlays for its own SDKs in stdlib/public/SDK/.
136+
131137
PR
132138
1. "Problem Report": An issue reported in `LLVM's bug tracker`__.
133139
See also `SR`.
@@ -164,6 +170,11 @@ source code, tests, and commit messages. See also the `LLVM lexicon`_.
164170
Describes a type or function where making certain changes will not break
165171
binary compatibility. See :doc:`LibraryEvolution.rst <LibraryEvolution>`.
166172

173+
runtime
174+
Code that implements a language's dynamic features that aren't just
175+
compiled down to plain instructions. For example, Swift's runtime library
176+
includes support for dynamic casting and for the Mirror-based reflection.
177+
167178
script mode
168179
The parsing mode that allows top-level imperative code in a source file.
169180

@@ -184,6 +195,11 @@ source code, tests, and commit messages. See also the `LLVM lexicon`_.
184195
"PR" for Swift because we wanted to be able to unambiguously reference
185196
LLVM bugs.
186197

198+
stdlib
199+
"Standard library". Sometimes this just means the "Swift" module (also
200+
known as "swiftCore"); sometimes it means everything in the stdlib/
201+
directory. Pronounced "stid-lib" or "ess-tee-dee-lib".
202+
187203
trap
188204
A deterministic runtime failure. Can be used as both as a noun ("Using an
189205
out-of-bounds index on an Array results in a trap") and a verb

0 commit comments

Comments
 (0)