starred/pkl
1
0
Fork 0
mirror of https://github.com/apple/pkl.git synced 2026-04-24 17:28:37 +02:00
Code Issues 198 Packages Projects Releases 10 Wiki Activity

Fix "amends declaration vs. expression" mistakes in language reference

Browse Source
This commit is contained in:
translatenix
2024-04-02 11:14:43 -07:00
committed by Philip K.F. Hölzenspies
parent 28448b5512
commit 3bd91b92ee
1 changed files with 7 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
docs/modules/language-reference/pages/index.adoc
View File

@@ -655,7 +655,7 @@ Another difference is that in Pkl, object properties are late-bound. Read on to
[[amends-declaration]] [[amends-declaration]]
[NOTE] [NOTE]
.Amends expressions vs. amends declarations .Amends declaration vs. amends expression
==== ====
The <<defining-objects,defining objects>> and <<amending-objects,amending objects>> sections cover two notations that are both a form of amending; called an _amends declaration_ and an _amends expression_, respectively. The <<defining-objects,defining objects>> and <<amending-objects,amending objects>> sections cover two notations that are both a form of amending; called an _amends declaration_ and an _amends expression_, respectively.
@@ -671,16 +671,16 @@ parrot = (pigeon) { // <2>
name = "Parrot" name = "Parrot"
} }
---- ----
<1> Amends expression. <1> Amends declaration.
<2> Amends declaration. <2> Amends expression.
An amends declaration amends the property of the same name in a module's parent module, if the parent property exists. An amends declaration amends the property of the same name in a module's parent module, if the parent property exists.
Otherwise, an amends declaration implicitly amends {uri-stdlib-Dynamic}[Dynamic]. Otherwise, an amends declaration implicitly amends {uri-stdlib-Dynamic}[Dynamic].
Another way to think about an amends declaration is that it is shorthand for assignment. Another way to think about an amends declaration is that it is shorthand for assignment.
In practical terms, `pigeon {}` is the same as `pigeon = super.pigeon {}`. In practical terms, `pigeon {}` is the same as `pigeon = (super.pigeon) {}`.
Amending object bodies can be chained for both an amends expression and an amends declaration. Amending object bodies can be chained for both an amends declaration and an amends expression.
[source%tested,{pkl}] [source%tested,{pkl}]
---- ----
@@ -696,8 +696,8 @@ dodo = (pigeon) {
extinct = true extinct = true
} // <2> } // <2>
---- ----
<1> Chained amends expression (`pigeon { ... } { ... }` is the amends expression). <1> Chained amends declaration.
<2> Chained amends declaration. <2> Chained amends expression (`(pigeon) { ... } { ... }` is the amends expression).
==== ====
[[late-binding]] [[late-binding]]