diff --git a/Data/TLS/GHC.hs b/Data/TLS/GHC.hs
--- a/Data/TLS/GHC.hs
+++ b/Data/TLS/GHC.hs
@@ -4,6 +4,12 @@
 
 -- | This is the simplest implementation of thread-local storage using
 -- GHC's built-in ThreadId capabilities.
+--
+-- While the interface below is designed to match the other
+-- implementations of TLS in this package, the GHC implementation can
+-- generaly be relied upon to keep a stable copy of the TLS variable
+-- for each `ThreadId` that calls `getTLS`.  This may change in the
+-- future, however!
 
 module Data.TLS.GHC
     ( TLS
diff --git a/Data/TLS/PThread.hs b/Data/TLS/PThread.hs
--- a/Data/TLS/PThread.hs
+++ b/Data/TLS/PThread.hs
@@ -5,6 +5,12 @@
 
 -- | An implementation of TLS using the standard, Posix
 -- `pthread_create_key` routine.
+--
+-- Note that because this implementation uses Posix threads, it does
+-- NOT care about Haskell IO threads.  This module is generally used
+-- to avoid problems with data structures or other APIs that are not
+-- thread safe.  That is, pthread-based TLS is sufficient to disallow
+-- simultaneous access, irrespective of where IO threads migrate to.
 
 module Data.TLS.PThread
     ( TLS
diff --git a/thread-local-storage.cabal b/thread-local-storage.cabal
--- a/thread-local-storage.cabal
+++ b/thread-local-storage.cabal
@@ -2,7 +2,7 @@
 --  documentation, see http://haskell.org/cabal/users-guide/
 
 name:                thread-local-storage
-version:             0.1.0.1
+version:             0.1.0.2
 synopsis:            Several options for thread-local-storage (TLS) in Haskell.
 description:
    .