Clearer narrative for host override edit page

1 files changed, 12 insertions, 4 deletions

diff --git a/src/usr/local/www/services_unbound_host_edit.php b/src/usr/local/www/services_unbound_host_edit.php
index b5949f3..8707ee4 100644
--- a/src/usr/local/www/services_unbound_host_edit.php
+++ b/src/usr/local/www/services_unbound_host_edit.php
@@ -192,21 +192,21 @@ $section->addInput(new Form_Input(
 	'text',
 	$pconfig['host']
 ))->setHelp('Name of the host, without the domain part%1$s' .
-			'e.g.: "myhost"', '<br />');
+			'e.g. enter "myhost" if the full domain name is "myhost.example.com"', '<br />');
 
 $section->addInput(new Form_Input(
 	'domain',
 	'*Domain',
 	'text',
 	$pconfig['domain']
-))->setHelp('Domain of the host%1$s' .
-			'e.g.: "example.com"', '<br />');
+))->setHelp('Parent domain of the host%1$s' .
+			'e.g. enter "example.com" for "myhost.example.com"', '<br />');
 
 $section->addInput(new Form_IpAddress(
 	'ip',
 	'*IP Address',
 	$pconfig['ip']
-))->setHelp('IP address of the host%1$s' .
+))->setHelp('IPv4 or IPv6 address to be returned for the host%1$s' .
 			'e.g.: 192.168.100.100 or fd00:abcd::1', '<br />');
 
 $section->addInput(new Form_Input(
@@ -225,6 +225,12 @@ if (isset($id) && $a_hosts[$id]) {
 	));
 }
 
+$section->setHelp("This page is used to override the usual lookup process for a specific host. A host is defined by its name" .
+	"and parent domain (e.g., 'somesite.google.com' is entered as host='somesite' and parent domain='google.com'). Any " .
+	"attempt to lookup that host will automatically return the given IP, and any usual external lookup server for the domain " .
+	"will not be queried. Both the name and parent domain can contain 'non-standard', 'invalid' and 'local' domains " .
+	"such as 'test', 'mycompany.localdomain', or '1.168.192.in-addr.arpa', as well as usual publicly resolvable names such as 'www' or 'google.co.uk'.");
+
 $form->add($section);
 
 $section = new Form_Section('Additional Names for this Host');
@@ -281,6 +287,8 @@ $form->addGlobal(new Form_Button(
 	'fa-plus'
 ))->removeClass('btn-primary')->addClass('btn-success addbtn');
 
+$section->setHelp("If the host can be accessed using multiple names, then enter any other names for the host which should also be overridden.");
+
 $form->add($section);
 print($form);