Improve the HELP note about what will/won't work if TLD is set to ".local"

For example, some people won't use mDNS and won't know other things might break; also it's not clear that while ".local" is a problem, ".local.lan" isn't.

1 files changed, 4 insertions, 3 deletions

diff --git a/src/usr/local/www/system.php b/src/usr/local/www/system.php
index 13f32e0..0467d63 100644
--- a/src/usr/local/www/system.php
+++ b/src/usr/local/www/system.php
@@ -459,9 +459,10 @@ $section->addInput(new Form_Input(
 	'text',
 	$pconfig['domain'],
 	['placeholder' => 'mycorp.com, home, office, private, etc.']
-))->setHelp('Do not use \'local\' as a domain name. It will cause local '.
-	'hosts running mDNS (avahi, bonjour, etc.) to be unable to resolve '.
-	'local hosts not running mDNS.');
+))->setHelp('Do not use \'.local\' as the final part of the domain (TLD), The \'.local\' domain is <a target="_blank" ' .
+	'href="https://www.unbound.net/pipermail/unbound-users/2011-March/001735.html")widely used</a> by mDNS (including Avahi), ' .
+	'Apple OS X (Bonjour/Rendezvous/Airprint/Airplay), and some Windows systems and network devices. These will not network ' .
+	'correctly if the router uses \'.local\'. Alternatives such as \'.local.lan\' or \'.mylocal\' are safe.');
 
 $form->add($section);