explain hidden tests

Changes

@@ -5,11 +5,17 @@
      puzzle was an amalgam of various ideas from Tom Heady
      (https://github.com/tomheady).
 
-   - There are no more local server tests and no more
-     Net::IMAP::Server environments to test in.  It was driving
-     me crazy how buggy that was, so I removed it.  If you want
-     to test against a real dovecot or uwash server, super! check
-     the t/test_runner.pm file for the settings.
+   - I deleted the Net::IMAP::Server from inc/ and there is no
+     longer a Net::IMAP::Server environment to test in.  It was
+     driving me crazy how buggy that was in some places, and I
+     had no ability to reproduce those environments, so I removed
+     it.  If you want to test against a real dovecot or uwash
+     server, super! check the t/test_runner.pm file for the
+     settings.  They are intentionally unobvious -- please don't
+     run automated tests unless you're willing to help debug.
+     The automated results don't help anybody without further
+     information on the failures.  Normally, cpan testers is the
+     best thing in the world ... IMAP sucks.
 
 1.2034_2: Fri Nov 16 2012
    - finally, some testers rand _1 ... didn't tell me anything;

t/test_runner.pm

@@ -23,18 +23,22 @@ no warnings;
 # management the way I was doing it.  I gave up.
 #
 # If you want to test, set these environment variables and run the tests.
+# These settings are intentionally un-obvious.  If you want to run automated
+# tests please help debug the failures.  Automated test results against unknown
+# environments help absolutely nobody at all.  Your IMAP server will differ
+# from mine, so some of the tests will fail and I won't have any ability to
+# figure out why without your /tmp/ logs and/or some help.  With most modules
+# cpan testers is the best thing in the entire world.  With IMAP, not so much.
 #
 #     ** THIS WILL DESTROY ANY FOLDERS YOU HAVE NAMED
 #     **      TESTING, TESTING2 OR TESTING3
-#     ** USE A TEST ACCOUNT!
 #
 #     export NIS_TEST_HOST=someserver.org
 #     export NIS_TEST_USER=someguyname
 #     export NIS_TEST_PASS=blarg
 #
 #     ** THIS WILL DESTROY ANY FOLDERS YOU HAVE NAMED
 #     **      TESTING, TESTING2 OR TESTING3
-#     ** USE A TEST ACCOUNT!
 #  
 # HOST will get connections on 143 and 993, specifying a port is not possible
 # at this time.