diff --git a/hosts/common/programs/mercurial.nix b/hosts/common/programs/mercurial.nix
index 0ea0cd9e4..c6888bd17 100644
--- a/hosts/common/programs/mercurial.nix
+++ b/hosts/common/programs/mercurial.nix
@@ -29,6 +29,12 @@
       q = qseries -s -v
       qstat = qdiff --stat
       sblame = blame -undq
+      # these aliases are BROKEN:
+      # `hg qmigrate OTHER_QUEUE_NAME`: copy currently-applied patches onto another queue
+      # qmigrate = !$HG export -o '/tmp/qmigrate-$1' ; $HG qpop -a ; $HG qqueue $1 ; $HG import '/tmp/qmigrate-$1'
+      # `hg qdup NEW_QUEUE_NAME`: copy all patches in the current queue into a new queue
+      # current queue must not be named "patches"
+      # qdup = !$HG qq --active > /tmp/hg.active ; cp .hg/patches-$(cat /tmp/hg.active) .hg/patches-$1 ; echo $1 >> .hg/patches.queues
     '';
   };
 }