Nice comments for URLs scripts

1 files changed, 15 insertions, 1 deletions

diff --git a/bin/mdurls b/bin/mdurls
index f4cd281a..e15864aa 100755
--- a/bin/mdurls
+++ b/bin/mdurls
@@ -1,4 +1,18 @@
 #!/usr/bin/env bash
+
+#
+# Format markdown and pass it to htmlurls to extract URLs from it.
+#
+# Author: Tom Ryder <tom@sanctum.geek.nz>
+# Copyright: 2016
+# License: Public domain
+#
+
+# Check we have the programs we need
 hash markdown htmlurls || exit
-markdown "${@:-/dev/stdin}" |
+
+# Pipe the output of markdown(1) on our args ...
+markdown -- "${@:-/dev/stdin}" |
+
+# ... into our own htmlurls
 htmlurls