aboutsummaryrefslogtreecommitdiff
path: root/doc/properties.rst
diff options
context:
space:
mode:
authorSean Whitton <spwhitton@spwhitton.name>2021-02-14 23:11:00 -0700
committerSean Whitton <spwhitton@spwhitton.name>2021-02-14 23:11:00 -0700
commit0ea01d80da2379444219ec58aa7f01a70bb65d83 (patch)
tree8c2cbd778142a64f55cd90aa7c3e9bb2259827ee /doc/properties.rst
parente37ffeaa6559932c55ae4329af75bdf88a42a7ea (diff)
downloadconsfigurator-0ea01d80da2379444219ec58aa7f01a70bb65d83.tar.gz
property :hostattrs subroutines can make arbitrary modifications
Signed-off-by: Sean Whitton <spwhitton@spwhitton.name>
Diffstat (limited to 'doc/properties.rst')
-rw-r--r--doc/properties.rst9
1 files changed, 7 insertions, 2 deletions
diff --git a/doc/properties.rst b/doc/properties.rst
index 2f40863..c1ec5a4 100644
--- a/doc/properties.rst
+++ b/doc/properties.rst
@@ -4,8 +4,13 @@ Property subroutines
``:hostattrs`` subroutines
==========================
-Return a list of static informational attributes to add to hosts to which this
-property has been applied or is to be applied. Should not perform any I/O.
+When this subroutine is executed, consfigurator:*hostattrs* will be bound to
+the plist of static information attributes of the host to which the property
+has been applied or is to be applied. This subroutine typically pushes new
+entries to this list, but it might also modify existing entries (e.g. by
+pushing new entries to a sublist).
+
+Should be a pure function aside from looking at consfigurator:*hostattrs*.
Essentially just a conversion of the arguments to the property to
informational attributes.