diff --git a/Data/Streaming/Network/Internal.hs b/Data/Streaming/Network/Internal.hs
--- a/Data/Streaming/Network/Internal.hs
+++ b/Data/Streaming/Network/Internal.hs
@@ -39,17 +39,22 @@
 --
 -- Note: The @IsString@ instance recognizes the following special values:
 --
--- * @*@ means @HostAny@
+-- * @*@ means @HostAny@ - "any IPv4 or IPv6 hostname"
 --
--- * @*4@ means @HostIPv4@
+-- * @*4@ means @HostIPv4@ - "any IPv4 or IPv6 hostname, IPv4 preferred"
 --
--- * @!4@ means @HostIPv4Only@
+-- * @!4@ means @HostIPv4Only@ - "any IPv4 hostname"
 --
--- * @*6@ means @HostIPv6@
+-- * @*6@ means @HostIPv6@@ - "any IPv4 or IPv6 hostname, IPv6 preferred"
 --
--- * @!6@ means @HostIPv6Only@
+-- * @!6@ means @HostIPv6Only@ - "any IPv6 hostname"
 --
--- Any other values is treated as a hostname. As an example, to bind to the
+-- Note that the permissive @*@ values allow binding to an IPv4 or an
+-- IPv6 hostname, which means you might be able to successfully bind
+-- to a port more times than you expect (eg once on the IPv4 localhost
+-- 127.0.0.1 and again on the IPv6 localhost 0:0:0:0:0:0:0:1).
+--
+-- Any other value is treated as a hostname. As an example, to bind to the
 -- IPv4 local host only, use \"127.0.0.1\".
 data HostPreference =
     HostAny
diff --git a/streaming-commons.cabal b/streaming-commons.cabal
--- a/streaming-commons.cabal
+++ b/streaming-commons.cabal
@@ -1,5 +1,5 @@
 name:                streaming-commons
-version:             0.1.15.3
+version:             0.1.15.4
 synopsis:            Common lower-level functions needed by various streaming data libraries
 description:         Provides low-dependency functionality commonly needed by various streaming data libraries, such as conduit and pipes.
 homepage:            https://github.com/fpco/streaming-commons
