diff --git a/README.md b/README.md
index 1f14065..51e33f2 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,27 @@
 # miscutils
 
 Miscellaneous UNIX utilities.
+
+
+## bwrap
+Wrap text received in stdin as if it was a single line. Indicate breaks with the ":" charater at both ends.
+## hppt
+Reformat stdin as a horizontal paper tape.
+## mkgmap
+Generates a simple Gophermap in its standard output, listing all text files in the current directory
+in reverse alphabetical order.
+## newp
+Creates a new ms phlog post. The file name will contain the current date and word separated by dashes.
+## rot
+Visually rotate stdin 90 degrees counter clockwise, swapping rows and columns.
+## rr
+Run a command repeteadly until it fails.
+## scmfmt
+Format stdin to use as a commit message
+## ts
+Runs the shell tests passed as arguments.
+## unpage
+Removes all page headers and footers from stdin, getting as result output that contains a single continuous page.
+## upcasetl
+Takes an ms troff document in stdin, and outputs to its stdout the same document
+with all `.tl` and `.sh` converted to uppercase.