diff --git a/doc/README.txt b/doc/README.txt
index 2e0fa14..0e20a9c 100644
--- a/doc/README.txt
+++ b/doc/README.txt
@@ -27,12 +27,19 @@ applications to be installed.
 Examples
 ---------
 ```
+# Extract several archives with different formats
 patool extract archive.zip otherarchive.rar
+# Test archive integrity
 patool test --verbose dist.tar.gz
+# List files stored in an archive
 patool list package.deb
+# Create a new archive
 patool create --verbose /path/to/myfiles.zip file1.txt dir/
+# Show differences between two archives
 patool diff release1.0.tar.gz release2.0.zip
+# Search for text insicde archives
 patool search "def urlopen" python-3.3.tar.gz
+# Repackage an archive in a different format
 patool repack linux-2.6.33.tar.gz linux-2.6.33.tar.bz2
 ```