    :extensions [".html"]})
 
 (deftask permalink
-  "Adds :permalink key to files metadata. Value of key will determine target path.
-
-   Make files permalinked. E.x. about.html will become about/index.html"
+  "Moves a file so that its location matches the result of `permalink-fn`"
   [p permalink-fn PERMALINKFN code  "function to build permalink from TmpFile metadata"
    _ filterer     FILTER      code  "predicate to use for selecting entries (default: `identity`)"
    e extensions   EXTENSIONS  [str] "extensions of files to include"]

   :extensions [".html"]})

(deftask slug
  "Adds :slug key to files metadata. Slug is derived from filename."
  [s slug-fn    SLUGFN     code  "function to build slug from file metadata"
   _ filterer   FILTER     code  "predicate to use for selecting entries (default: `identity`)"
   e extensions EXTENSIONS [str] "extensions of files to include"]

      :pod pod})))

(deftask markdown
  "Parse markdown files with yaml front matter

  This task will look for files ending with `md` or `markdown`
  and writes an HTML file that contains the result from
