1 files changed, 14 insertions, 0 deletions

diff --git a/en/handbook/README b/en/handbook/README
index cf002e533d..849cdb4f4c 100644
--- a/en/handbook/README
+++ b/en/handbook/README
@@ -263,3 +263,17 @@ for example,
 
  18. Yet more things that should be filenames marked up as such.
 
+ 19. Use the new <hostid> element to mark up hostnames, IP addresses and
+     such. The markup choice is as follows.
+
+        <hostid>...</hostid> is a simple hostname.
+        <hostid role="ipaddr">...</hostid> is an IP address.
+	<hostid role="domainname">...</hostid> is a domain name.
+	<hostid role="fqdn">...</hostid> is a fully qualified domain name.
+	<hostid role="netmask">...</hostid> is a netmask.
+        <hostid role="mac">...</hostid> is a network card MAC address.
+
+     These might migrate to being separate elements in the future. However,
+     if they do then changing the markup can be done automatically.
+
+