diff --git a/README.md b/README.md
index 3aedca4..958cf14 100644
--- a/README.md
+++ b/README.md
@@ -46,7 +46,9 @@ example, add the following to your `prwdrc` file:
     alias *prwd /home/tamentis/projects/prwd
 
 And navigating to `/home/tamentis/projects/prwd/doc` will allow prwd to reduce
-your current path to `*prwd/doc`.
+your current path to `*prwd/doc`.  Another good example is that `~` is a
+default alias for prwd, you can create more of these ultra-short aliases if you
+want.
 
 ## Installation
 
diff --git a/TODO b/TODO
index a1302ac..05b8d2a 100644
--- a/TODO
+++ b/TODO
@@ -1,14 +1,3 @@
-FOR 1.9
-
-    [doc] Split prwd and prwdrc configuration man pages and turn README into a proper githubesque thing.
-    [doc] Document "~" as a default alias
-    [doc] Explain advantages:
-        - a single fork instead of fork-exec git and hg.
-        - small in-stack memory footprint
-        - compiled and fast
-        - same prompt on all systems
-
-
 FOR 2.0
 
     [core] conditional templates
diff --git a/prwdrc.5 b/prwdrc.5
index ea814c3..d0ea78c 100644
--- a/prwdrc.5
+++ b/prwdrc.5
@@ -176,6 +176,7 @@ Then use your aliases like any environment variable:
 .Bd -literal -offset indent
 cd $py3k
 .Ed
+Note that ~ is a default alias for prwd.
 .Sh GLOBAL SETTINGS
 Settings are defined with the
 .Em set