diff --git a/NEWS b/NEWS
--- a/NEWS
+++ b/NEWS
@@ -3,6 +3,29 @@
 
 
 
+libravatar 0.1.0.1 -- 2015-07-13
+================================
+
+General, build and documentation changes:
+
+* Add some usage examples
+
+New APIs, features and enhancements:
+
+* (none)
+
+Bug fixes:
+
+* (none)
+
+Dependency changes:
+
+* (none)
+
+
+
+
+
 libravatar 0.1.0.0 -- 2015-07-12
 ================================
 
diff --git a/libravatar.cabal b/libravatar.cabal
--- a/libravatar.cabal
+++ b/libravatar.cabal
@@ -1,5 +1,5 @@
 name:                libravatar
-version:             0.1.0.0
+version:             0.1.0.1
 synopsis:            Use Libravatar, the decentralized avatar delivery service
 description:         This package is a Haskell library for
                      <http://libravatar.org Libravatar>.
diff --git a/src/Network/Libravatar.hs b/src/Network/Libravatar.hs
--- a/src/Network/Libravatar.hs
+++ b/src/Network/Libravatar.hs
@@ -167,6 +167,30 @@
     in  URL (Absolute server') ("avatar/" ++ hash) params
 
 -- | Return a URL to the avatar image.
+--
+-- Examples:
+--
+-- Email, HTTP, default fallback (libravatar's CDN), default size (80):
+--
+-- >>> avatarUrl (Left "john@doe.org") False Nothing Nothing
+-- Just "http://cdn.libravatar.org/avatar/bc6a715808d9aae0ddeefb1e47e482a6"
+--
+-- Email, HTTPS, default fallback, size 100. But now use an email with a domain
+-- which has SRV records for avatars:
+--
+-- >>> avatarUrl (Left "fr33domlover@rel4tion.org") True Nothing (Just 100)
+-- Just "https://avatars.rel4tion.org:5679/avatar/e9e9ccabc2a166b1783bd7f4f9ceb376?s=100"
+--
+-- OpenID, HTTPS, specified fallback (special value \"retro\"), default
+-- size (80):
+--
+-- >>> avatarUrl (Right "https://examplibre.org/accounts/xyz/id") True (Just "retro") Nothing
+-- Just "https://seccdn.libravatar.org/avatar/c2cbc5f5a1784fa7105380e550360d73f15c4c1f9c7ca1ac436c45a33027fcd7?d=retro"
+--
+-- (Note that the 2nd example uses dummy SRV records created by the author,
+-- and he doesn't really run (at the time of writing) a Libravatar provider.
+-- This is just an example, the specific URL here will probably result with
+-- 404.)
 avatarUrl :: Either String String -- ^ Email or OpenID
           -> Bool                 -- ^ Whether to use HTTPS
           -> Maybe String         -- ^ Default picture URL if avatar not found