diff --git a/bin/html2pdf b/bin/html2pdf
index 536140f8..60e29738 100755
--- a/bin/html2pdf
+++ b/bin/html2pdf
@@ -1,5 +1,10 @@
 #!/usr/bin/env zsh
 
+# Converts an html file (or website) to a pdf. It installs
+# the dependencies if they aren't available.
+#
+# Note: MAC ONLY!
+
 if ! is_mac; then
     echo "Mac-only script!"
     exit
diff --git a/bin/osx b/bin/osx
index 3b212b33..ec74765d 100755
--- a/bin/osx
+++ b/bin/osx
@@ -1,6 +1,7 @@
 #!/usr/bin/env bash
 
 # ~/.osx — http://mths.be/osx
+# A script to set a bunch of sane options on osx
 
 source ~/.dotfiles/zsh/functions
 keep_alive