diff --git a/doc_src/fish_hg_prompt.txt b/doc_src/fish_hg_prompt.txt
new file mode 100644
index 000000000..044af98c3
--- /dev/null
+++ b/doc_src/fish_hg_prompt.txt
@@ -0,0 +1,45 @@
+\section fish_hg_prompt fish_hg_prompt - output mercurial information for use in a prompt
+
+\subsection fish_hg_prompt-description Description
+
+The fish_hg_prompt function can be used to display information about the current mercurial repository, if any.
+
+For obvious reasons, it requires having hg installed.
+
+There are numerous configuration options:
+
+- $fish_color_hg_clean, $fish_color_hg_modified and $fish_color_hg_dirty: The color to use when the repo has the respective status
+
+Some colors for status symbols:
+
+- $fish_color_hg_added
+- $fish_color_hg_renamed
+- $fish_color_hg_copied
+- $fish_color_hg_deleted
+- $fish_color_hg_untracked
+- $fish_color_hg_unmerged
+
+And the status symbols themselves:
+
+- $fish_prompt_hg_status_added, default '✚'
+- $fish_prompt_hg_status_modified, default '*'
+- $fish_prompt_hg_status_copied, default '⇒'
+- $fish_prompt_hg_status_deleted, default '✖'
+- $fish_prompt_hg_status_untracked, default '?'
+- $fish_prompt_hg_status_unmerged, default '!'
+
+And $fish_prompt_hg_status_order, which can be used to change the order the status symbols appear in. It defaults to `added modified copied deleted untracked unmerged`.
+
+See also fish_vcs_prompt, which will call all supported vcs-prompt functions, including git, hg and svn.
+
+\subsection fish_hg_prompt-example Example
+
+A simple prompt that displays hg info:
+
+\fish
+function fish_prompt
+    ...
+    printf '%s %s$' $PWD (fish_hg_prompt)
+end
+\endfish
+