From 80b823fe682b5eaef429590a0fa98a0ad1beccda Mon Sep 17 00:00:00 2001
From: ncoop <n_coop@outlook.com>
Date: Sat, 30 Jul 2016 14:48:24 -0700
Subject: [PATCH 1/2] Docs: how and why to customize internet_check

---
 docs/configuration.rst | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/docs/configuration.rst b/docs/configuration.rst
index 56852c1..0083905 100644
--- a/docs/configuration.rst
+++ b/docs/configuration.rst
@@ -539,3 +539,30 @@ then you can refresh the bar by using the following command:
         pkill -SIGUSR1 -f "python /home/user/.config/i3/pystatus.py"
 
 Note that the path must be expanded if using '~'.
+
+.. _internet:
+
+Internet Connectivity
+---------------------
+
+Module methods that ``@require(internet)`` won't be run unless a test TCP
+connection is successful. By default, this is made to Google's DNS server, but
+you can customize the host and port. See :py:class:`.internet`.
+
+If you are behind a gateway that redirects web traffic to an authorization page
+and blocks other traffic, the DNS check will return a false positive. This is
+often encountered in open WiFi networks. In these cases it is helpful to try a
+service that is not traditionally required for web browsing:
+
+.. code:: python
+
+  from i3pystatus import Status
+
+  status = Status(check_internet=("whois.arin.net", 43))
+
+.. code:: python
+
+  from i3pystatus import Status
+
+  status = Status(check_internet=("github.com", 22))
+

From be27d7839b29ad598d79004649a81e15852a6a70 Mon Sep 17 00:00:00 2001
From: ncoop <n_coop@outlook.com>
Date: Sat, 30 Jul 2016 14:57:19 -0700
Subject: [PATCH 2/2] It makes sense to put Credentials later.

---
 docs/configuration.rst | 70 +++++++++++++++++++++---------------------
 1 file changed, 35 insertions(+), 35 deletions(-)

diff --git a/docs/configuration.rst b/docs/configuration.rst
index 0083905..00fe43d 100644
--- a/docs/configuration.rst
+++ b/docs/configuration.rst
@@ -133,41 +133,6 @@ from installation:
 If no arguments were provided, ``i3pystatus`` script works as an example of
 ``Clock`` module.
 
-.. _credentials:
-
-Credentials
------------
-
-Settings that require credentials can utilize the keyring module to
-keep sensitive information out of config files.  To take advantage of
-this feature, simply use the ``i3pystatus-setting-util`` script
-installed along i3pystatus to set the credentials for a module. Once
-this is done you can add the module to your config without specifying
-the credentials, e.g.:
-
-.. code:: python
-
-    # Use the default keyring to retrieve credentials.
-    # To determine which backend is the default on your system, run
-    # python -c 'import keyring; print(keyring.get_keyring())'
-    status.register('github')
-
-If you don't want to use the default you can set a specific keyring like so:
-
-.. code:: python
-
-    # Requires the keyrings.alt package
-    from keyrings.alt.file import PlaintextKeyring
-    status.register('github', keyring_backend=PlaintextKeyring())
-
-i3pystatus will locate and set the credentials during the module
-loading process. Currently supported credentials are "password",
-"email" and "username".
-
-.. note:: Credential handling requires the PyPI package
-   ``keyring``. Many distributions have it pre-packaged available as
-   ``python-keyring``.
-
 Formatting
 ----------
 
@@ -566,3 +531,38 @@ service that is not traditionally required for web browsing:
 
   status = Status(check_internet=("github.com", 22))
 
+.. _credentials:
+
+Credentials
+-----------
+
+Settings that require credentials can utilize the keyring module to
+keep sensitive information out of config files.  To take advantage of
+this feature, simply use the ``i3pystatus-setting-util`` script
+installed along i3pystatus to set the credentials for a module. Once
+this is done you can add the module to your config without specifying
+the credentials, e.g.:
+
+.. code:: python
+
+    # Use the default keyring to retrieve credentials.
+    # To determine which backend is the default on your system, run
+    # python -c 'import keyring; print(keyring.get_keyring())'
+    status.register('github')
+
+If you don't want to use the default you can set a specific keyring like so:
+
+.. code:: python
+
+    # Requires the keyrings.alt package
+    from keyrings.alt.file import PlaintextKeyring
+    status.register('github', keyring_backend=PlaintextKeyring())
+
+i3pystatus will locate and set the credentials during the module
+loading process. Currently supported credentials are "password",
+"email" and "username".
+
+.. note:: Credential handling requires the PyPI package
+   ``keyring``. Many distributions have it pre-packaged available as
+   ``python-keyring``.
+