--- a/docs/evolve-faq.rst	Wed Jan 22 14:12:44 2014 -0800
+++ b/docs/evolve-faq.rst	Wed Jan 22 14:13:22 2014 -0800
@@ -71,6 +71,12 @@
 
 You can use ``hg fold`` to collapse multiple changesets in a single one.
 
+It takes two forms:
+
+``hg fold <rev>`` folds everything from you current changeset to `<rev>`
+
+``hg fold -r <revset>`` fold everything changeset matching the revset together.
+
 Getting changes out of a commit
 ------------------------------------------------------------