--- a/hg.rst	Mon Dec 20 17:21:29 2010 +0200
+++ b/hg.rst	Mon Dec 20 22:47:38 2010 +0200
@@ -55,6 +55,29 @@
   [defaults]
   log = -f
 
+* Remove/rename files history from repo.
+
+  $ cat >filemap.txt <<EOF
+exclude path/to/file-or-dir
+rename path/to/source path/to/destination
+...
+EOF
+  $ hg convert --filemap filemap.txt $repo_orig $repo_new
+  $ hg -R $repo_new up
+
+* Join history of two repos.
+
+  $ cat >filemap1.txt <<EOF
+rename . dir1
+EOF
+  $ cat >filemap2.txt <<EOF
+rename . dir2
+EOF
+  $ hg convert --filemap filemap1.txt $repo1 $repo_new
+  $ hg convert --filemap filemap2.txt $repo2 $repo_new
+  $ hg -R $repo_new merge
+  $ hg -R $repo_new ci -m "Join $repo1 and $repo2."
+
 * Publishing repo.
 
 With static HTTP hosting you can copy via rsync, ftp, scp, etc., so long as all the files beneath