From 719df1b4e8b0ad90159caeec6948402598076d88 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Hugo=20H=C3=B6rnquist?= <hugo@lysator.liu.se>
Date: Wed, 13 Jan 2021 22:45:11 +0100
Subject: Document (vcompenent control).

---
 doc/ref/calp.texi  |  1 +
 doc/ref/guile.texi | 17 +++++++++++++++++
 2 files changed, 18 insertions(+)
 create mode 100644 doc/ref/guile.texi

(limited to 'doc')

diff --git a/doc/ref/calp.texi b/doc/ref/calp.texi
index e280a455..e5c4baab 100644
--- a/doc/ref/calp.texi
+++ b/doc/ref/calp.texi
@@ -58,6 +58,7 @@ text @footnote{Improvements welcome}
 @c * Index::
 @c @end menu
 
+@include guile.texi
 @include javascript.texi
 
 @node Index
diff --git a/doc/ref/guile.texi b/doc/ref/guile.texi
new file mode 100644
index 00000000..8468021e
--- /dev/null
+++ b/doc/ref/guile.texi
@@ -0,0 +1,17 @@
+@node Guile
+@chapter Guile
+
+@c TODO
+This chapter will probably in the future be replaced by a proper
+system overview in the future.
+
+@c module (vcomponent control)
+
+@defmac with-replaced-properties (component (key value) ...) body ...
+Through the extent of @var{body} each @var{key}'s value in
+@var{component} is replaced by its repspective @var{value}.
+
+Note that @var{body} is guarded through a dynamic-wind, meaning that
+even non-local exits will restore @var{component} to its initial
+state.
+@end defmac
-- 
cgit v1.2.3