diff -r 0d1452d71317 -r 51aff98d2861 mercurial/commands.py
--- a/mercurial/commands.py	Tue Dec 22 06:03:10 2015 +0000
+++ b/mercurial/commands.py	Tue Dec 22 06:02:01 2015 +0000
@@ -5750,8 +5750,10 @@
       -Af       R  R  R  R
       ========= == == == ==
 
-      Note that remove never deletes files in Added [A] state from the
-      working directory, not even if option --force is specified.
+      .. note::
+
+         :hg:`remove` never deletes files in Added [A] state from the
+         working directory, not even if ``--force`` is specified.
 
     Returns 0 on success, 1 if any warnings encountered.
     """