--- a/mercurial/commands.py	Wed Sep 14 22:01:39 2011 -0400
+++ b/mercurial/commands.py	Fri Sep 16 15:31:21 2011 -0500
@@ -307,6 +307,18 @@
     The archive type is automatically detected based on file
     extension (or override using -t/--type).
 
+    .. container:: verbose
+
+      Examples:
+
+      - create a zip file containing the 1.0 release::
+
+          hg archive -r 1.0 project-1.0.zip
+
+      - create a tarball excluding .hg files::
+
+          hg archive project.tar.gz -X ".hg*"
+
     Valid types are:
 
     :``files``: a directory full of files (default)