puck/zilch
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: remove orphaned page

Browse source 
It was replaced by a more comprehensive page a while back.

Change-Id: I6a6a696468bd55425d231ebc09536bd213e7ccf7
This commit is contained in:
puck 2025-07-03 23:27:25 +00:00
parent 5865632b14
commit 6f0db0d7ef
1 changed files with 0 additions and 31 deletions
Download patch file Download diff file Expand all files Collapse all files

31
docs/modules/ROOT/pages/zexp.adoc
View file

@ -1,31 +0,0 @@
= zexps
zexps, similar to g-expressions in Guix, are a way to generate
S-expressions that are tagged with store paths. The syntax in Zilch is inspired
by it, but has been developed separately.
A zexp is used similarly to a ``quasiquote``d value in Scheme, but has an extra type
of unquoting, called `zexp-unquote`, which unquotes a value such as a `++<store-path>++`
or another `zexp`.
Each `zexp` keeps track of the derivation outputs and store files it depends on,
similarly to how string context works in Nix:
[,scheme]
----
#~(foo bar #$baz)
; is identical to:
(zexp (foo bar (zexp-unquote baz)))
----
When a `zexp-unquote` (or its reader syntax, `#$`) is encountered, the value
contained in the `zexp` (or compatible object) is used as-is, with no
evaluation. It is possible to mix and match `zexp-unquote` with `unquote`,
allowing building e.g. dynamic strings from zexps. `zexp-unquote` is always
evaluated before `unquote` is.
[,scheme]
----
(define world ...)
(define hello #~("hello" ,(string-append "very " "cute" #$world)))
----