1 files changed, 47 insertions, 0 deletions
diff --git a/blq.1 b/blq.1
new file mode 100644
index 0000000..8ddaa3b
--- /dev/null
+++ b/blq.1
@@ -0,0 +1,47 @@
+.Dd $Mdocdate$
+.Dt blq 1
+.Os
+.
+.Sh NAME
+.Nm blq
+.Nd search utility for Blocket.se
+.
+.Sh SYNOPSIS
+.Nm
+.Op Fl r
+.Ar query
+.
+.Sh DESCIPTION
+.Pp
+.Nm
+is a script for searching Blocket.se, the Swedish equivalent to Craigslist, without the need for a web browser.
+
+If no command-line flags are present,
+.Nm
+outputs the search results in JSON format.
+The results can be processed with a utility like
+.Xr jq 1
+or the included
+.Xr blm 1 ,
+which translates them into
+.Xr mboxu 5
+format.
+
+If
+.Fl r
+is present,
+.Nm
+automatically invokes
+.Xr blm 1
+and opens the resulting mbox file in
+.Xr mutt 1 ,
+.Xr mailx 1
+or the value of
+.Ev MAILER .
+The temporary mbox file is automatically deleted.
+.
+.Sh AUTHORS
+.Pp
+.Nm
+is written by John Ankarström
+.Aq Mt john (at) ankarstrom.se .