Skip to content

Commit cf86b6b

Browse files
authored
[spec/glossary] Minor tweaks, add IES (#3883)
* [spec/glossary] Minor tweaks, add IES Add anchors. Fix term capitalization. Add IES - Interpolated Expression Sequence. Tweak formatting of link to std.range. Add local link to higher-order functions. * Fix input range primitives!
1 parent bd48508 commit cf86b6b

File tree

1 file changed

+20
-14
lines changed

1 file changed

+20
-14
lines changed

spec/glossary.dd

Lines changed: 20 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ $(DL
2626
$(DD Refers to the ability to execute regular D
2727
functions at compile time rather than at run time.)
2828

29-
$(DT code point) $(DD In Unicode terminology, a $(LUCKY code point)
29+
$(DT $(LNAME2 code-point, Code Point)) $(DD In Unicode terminology, a $(LUCKY code point)
3030
is a logical character. The range of code points is $(D 0)
3131
through $(D 0x10FFFF). Only $(D dchar)s can store code points
3232
directly; arrays of $(D char) and $(D wchar) need to use the
@@ -58,30 +58,35 @@ $(DL
5858
one and only one call to free().
5959
)
6060

61-
$(DT Higher-order function) $(DD A function that either accepts another
61+
$(DT $(LNAME2 hof, Higher-Order Function)) $(DD A function that either accepts another
6262
function as a parameter, returns a function, or both.
6363
)
6464

65+
$(DT $(LNAME2 ies, $(ACRONYM IES, Interpolated Expression Sequence)))
66+
$(DD A $(DDSUBLINK spec/template, homogeneous_sequences, value sequence)
67+
of interspersed string literals and expressions.
68+
See $(LINK2 $(ROOT_DIR)spec/istring.html, spec).
69+
)
70+
6571
$(DT $(LNAME2 ifti, $(ACRONYM IFTI, Implicit Function Template Instantiation)))
6672
$(DD Refers to the ability to instantiate a template function
6773
without having to explicitly pass in the types to the template.
6874
Instead, the types are inferred automatically from the types of the
6975
runtime arguments. See $(LINK2 spec/template.html#ifti, spec) for details.)
7076

71-
$(DT Illegal)
77+
$(DT $(LNAME2 illegal, Illegal))
7278
$(DD A code construct is illegal if it does not conform to the
7379
D language specification.
7480
This may be true even if the compiler or runtime fails to detect
7581
the error.
7682
)
7783

78-
$(DT Input range) $(DD A type (i.e., a struct or a class) that
79-
defines the member functions empty, head, and next. Input ranges
84+
$(DT $(LNAME2 input-range, Input Range)) $(DD A type (i.e., a struct or a class) that
85+
defines the member functions `empty`, `front`, and `popFront`. Input ranges
8086
are assumed to be strictly one-pass: there is no way to save the
81-
state of the iteration in a copy of the range. See also $(LINK2
82-
phobos/std_range.html,range).)
87+
state of the iteration in a copy of the range. See also $(MREF std, range).)
8388

84-
$(DT Implementation Defined Behavior)
89+
$(DT $(LNAME2 implementation-defined, Implementation-Defined Behavior))
8590
$(DD This is variation in behavior of the D language in a manner
8691
that is up to the implementor of the language.
8792
An example of implementation defined behavior would be the size in
@@ -91,7 +96,7 @@ $(DL
9196
maximize the portability of code.
9297
)
9398

94-
$(DT $(LNAME2 lvalue, lvalue))
99+
$(DT $(LNAME2 lvalue, Lvalue))
95100
$(DD An lvalue is an abstract term referring to a value with an accessible
96101
address (through e.g. the unary $(D &) operator). Typical examples of
97102
lvalues include variables, constants introduced with `const` or `immutable`
@@ -173,7 +178,8 @@ void test()
173178
instead of passing through two other instances.)
174179
)
175180

176-
$(DT $(LEGACY_LNAME2 narrow strings, narrow-strings, narrow strings)) $(DD All arrays
181+
$(DT $(LEGACY_LNAME2 narrow strings, narrow-strings, Narrow Strings))
182+
$(DD All arrays
177183
that use $(D char), $(D wchar), and their qualified versions are
178184
narrow strings. (Those include $(D string) and $(D
179185
wstring)). Range-oriented functions in the standard library handle
@@ -203,11 +209,11 @@ void test()
203209
delegate returning a Boolean result. Predicates can be nullary
204210
(take no arguments), unary (take one argument), binary (take
205211
two arguments), or n-ary (take n arguments). Usually
206-
predicates are mentioned within the context of higher-order
207-
functions, which accept predicates as parameters.
212+
predicates are mentioned within the context of $(ALOCAL hof, higher-order
213+
functions), which accept predicates as parameters.
208214
)
209215

210-
$(DT $(LNAME2 qualifier-convertible, qualifier-convertible)) $(DD A type `T` is
216+
$(DT $(LNAME2 qualifier-convertible, Qualifier-Convertible)) $(DD A type `T` is
211217
qualifer-convertible to type `U` if and only if they only differ in qualifiers
212218
and if a reference to `T` can be implicitly converted to a reference to `U` per
213219
the $(LINK2 $(ROOT_DIR)spec/const3.html, language rules).)
@@ -224,7 +230,7 @@ void test()
224230
$(DDSUBLINK spec/attribute, scope-class-var, $(D scope) storage class).
225231
)
226232

227-
$(DT $(LNAME2 rvalue, rvalue))
233+
$(DT $(LNAME2 rvalue, Rvalue))
228234
$(DD An rvalue is an abstract term referring to a value resulting from an
229235
expression that has no accessible memory address. This lack of address is
230236
only conceptual; the implementation has the liberty to store an rvalue in

0 commit comments

Comments
 (0)