diff --git a/Makefile b/Makefile
index 5783134..f30f2e0 100644
--- a/Makefile
+++ b/Makefile
@@ -1,2 +1,5 @@
 termsize: termsize.c
 	cc -o termsize termsize.c
+
+README.html:
+	asciidoc -b html5 -a data-uri -a icons --theme ladi -o README.html README.adoc
diff --git a/README.adoc b/README.adoc
new file mode 100644
index 0000000..58d57b7
--- /dev/null
+++ b/README.adoc
@@ -0,0 +1,9 @@
+= termsize =
+
+'termsize' is a simple program to adjust number of 'cols' and 'rows' associated with
+controlling terminal '/dev/tty' so to match the actual size of attached terminal (emulator window).
+
+Typical/intended use is when attaching over UART/RS232 to a remote computer that initially
+has default number cols and rows (often 80x25). Running the program on the
+remote computer adjusts the number of cols and rows, for its local tty device,
+to current number of cols and rows.