From edbba484918f6de83680a5b29e561fba981e05e9 Mon Sep 17 00:00:00 2001 From: Sean Whitton Date: Sat, 29 May 2021 15:12:54 -0700 Subject: factor out ENSURE-HOST & call it in hostattrs accessors Signed-off-by: Sean Whitton --- doc/hosts.rst | 8 ++++++++ 1 file changed, 8 insertions(+) (limited to 'doc/hosts.rst') diff --git a/doc/hosts.rst b/doc/hosts.rst index af5104b..1f8a56c 100644 --- a/doc/hosts.rst +++ b/doc/hosts.rst @@ -37,3 +37,11 @@ keyword symbols. The semantics of these attributes are documented here: - ``:APT.MIRROR``: for hosts running Debian or a Debian derivative, the host's preferred apt mirror + +Host designators +---------------- + +A string designates a host with that hostname and no properties. Using +strings to designate hosts is not valid in all contexts -- some macros and +properties where it might be useful to pass a string instead of a ``HOST`` +object call ``ENSURE-HOST`` to convert, but this is not done everywhere. -- cgit v1.2.3