aboutsummaryrefslogtreecommitdiff
path: root/doc/properties.rst
diff options
context:
space:
mode:
authorSean Whitton <spwhitton@spwhitton.name>2021-02-16 23:33:29 -0700
committerSean Whitton <spwhitton@spwhitton.name>2021-02-16 23:34:11 -0700
commit56d4c8e7245b9766bc4ed16af279117a83ae69a4 (patch)
tree750d697cc56612d122d6bb3824012240c5a34403 /doc/properties.rst
parent716e3704ca7691d8b1c99192d1c4658e5057d941 (diff)
downloadconsfigurator-56d4c8e7245b9766bc4ed16af279117a83ae69a4.tar.gz
updates for having dropped apply-properties
Signed-off-by: Sean Whitton <spwhitton@spwhitton.name>
Diffstat (limited to 'doc/properties.rst')
-rw-r--r--doc/properties.rst14
1 files changed, 7 insertions, 7 deletions
diff --git a/doc/properties.rst b/doc/properties.rst
index c1ec5a4..8da97c1 100644
--- a/doc/properties.rst
+++ b/doc/properties.rst
@@ -51,15 +51,15 @@ Errors in attempting to apply a property are indicated by signalling a
``:posix`` properties should not make any assumptions about what localhost is
-- they may be running in the root Lisp, but they might be running in a Lisp
-process running on an intermediary host. They should perform I/O only by
-calling ``run``, ``readfile``, ``writefile``, requesting prerequisite data,
-and applying or unapplying other ``:posix`` properties. Otherwise, they
-should be pure functions.
+process running on an intermediary host, or even on the host to be configured.
+They should perform I/O only by calling ``run``, ``readfile``, ``writefile``,
+requesting prerequisite data, and applying or unapplying other ``:posix``
+properties. Otherwise, they should be pure functions.
In this respect, the code which establishes connections (i.e., implementations
-of the ``connect-and-apply`` generic function) is like a ``:posix`` property
--- it should restrict its I/O to ``run``, ``readfile`` and ``writefile`` to
-permit the arbitrary nesting of connections.
+of the ``establish-connection`` generic function) is like a ``:posix``
+property -- it should restrict its I/O to ``run``, ``readfile`` and
+``writefile`` to permit the arbitrary nesting of connections.
``:lisp`` properties, by contrast, may assume that they are running in a Lisp
process on the host to which they are to be applied, so they can perform