--- a/README.rst	Sun Oct 12 19:59:54 2014 +0900
+++ b/README.rst	Wed Nov 12 21:39:50 2014 +0800
@@ -26,8 +26,16 @@
 Mercurial prompt
 ----------------
 
+There are two implementations of mercurial prompt: using a separate mercurial
+extension `hg-prompt <http://sjl.bitbucket.org/hg-prompt/>`_, and a fallback
+implementation in pure bash.
+
+The screenshot shows the former in action:
+
 .. image:: https://bitbucket.org/engored/dotfiles/raw/tip/docs/prompt-hg.png
 
+Pure bash implementation currently lags behind in features.
+
 Git prompt
 ----------