From 093ab5430031378b54bea1d1edd6ebb0e6c0ecba Mon Sep 17 00:00:00 2001
From: Frank Denis
Date: Wed, 3 Oct 2012 05:51:42 -0700
Subject: [PATCH] Explain that a tool like dig(1) shouldn't be use in order to
check if an exception works.
---
.../DNSCrypt/extra/html/help.haml | 17 ++++++++++++++++
.../DNSCrypt/extra/html/help.html | 20 +++++++++++++++++++
2 files changed, 37 insertions(+)
diff --git a/DNSCrypt-Preference-Pane/DNSCrypt/extra/html/help.haml b/DNSCrypt-Preference-Pane/DNSCrypt/extra/html/help.haml
index 8f2f811..11e34d6 100644
--- a/DNSCrypt-Preference-Pane/DNSCrypt/extra/html/help.haml
+++ b/DNSCrypt-Preference-Pane/DNSCrypt/extra/html/help.haml
@@ -121,3 +121,20 @@
%p
Domains listed here will bypass DNSCrypt in order to be sent
to the default resolvers.
+ %p
+ Do
+ %strong not
+ use a tool like hostip(8), drill(1), unbound-host(1), dig(1) or host(1)
+ in order to check that an exception rule works.
+ %p
+ These tools use their own resolution mechanisms that have nothing
+ to do with how others apps on your system are resolving names.
+ %p
+ They don't use the OSX-specific stub resolver, they don't use
+ the system-wide DNS cache, they have bugs and limitations that the OS
+ doesn't have (and the opposite is also true), and they don't know a
+ thing about specific resolvers that have to be used for specific
+ domains.
+ %p
+ Use actual apps, or even a command like ping(8).
+
diff --git a/DNSCrypt-Preference-Pane/DNSCrypt/extra/html/help.html b/DNSCrypt-Preference-Pane/DNSCrypt/extra/html/help.html
index d04ac14..fdaab35 100644
--- a/DNSCrypt-Preference-Pane/DNSCrypt/extra/html/help.html
+++ b/DNSCrypt-Preference-Pane/DNSCrypt/extra/html/help.html
@@ -156,6 +156,26 @@
Domains listed here will bypass DNSCrypt in order to be sent
to the default resolvers.
+
+ Do
+ not
+ use a tool like hostip(8), drill(1), unbound-host(1), dig(1) or host(1)
+ in order to check that an exception rule works.
+
+
+ These tools use their own resolution mechanisms that have nothing
+ to do with how others apps on your system are resolving names.
+
+
+ They don't use the OSX-specific stub resolver, they don't use
+ the system-wide DNS cache, they have bugs and limitations that the OS
+ doesn't have (and the opposite is also true), and they don't know a
+ thing about specific resolvers that have to be used for specific
+ domains.
+
+
+ Use actual apps, or even a command like ping(8).
+