Update all bin-scripts to include a description.

The description will always be on the third line.

Signed-off-by: Jacob Kiers <jacob@alphacomm.nl>

bin/commit

@@ -1,3 +1,5 @@
 #!/usr/bin/env bash -
 
+# Returns a random commit message from http://whatthecommit.com/
+
 curl http://whatthecommit.com/index.txt

bin/git-changelog

@@ -1,5 +1,6 @@
 #!/bin/sh
-# Based on git-extras
+
+# Creates a changelog from the git commits.
 
 FILE=""
 LIST=false

bin/git-open

@@ -1,5 +1,7 @@
 #!/bin/sh
 
+# Open a GitHub file/blog page for FILE on LINE.
+
 ## Usage: git-open FILE [LINE]
 ## Open GitHub file/blob page for FILE on LINE. FILE is the path to the
 ## file on disk; it must exist and be tracked with the current HEAD
@@ -83,4 +85,4 @@ url="http://github.com/$repo/blob/$branch/$path"
 # throw the line number on there if specified
 test -n "$LINE" && url="$url#L$LINE"
 
-open "$url"
+open "$url"

bin/lyrics

@@ -1,14 +1,14 @@
 #!/bin/bash
 #
-# lyrics.sh
+# Returns the lyrics of the current track playing in Spotify.
 #
 # A fine piece of work by @febuiles
 #   https://gist.github.com/1549979
 
-artist=`osascript -e'tell application "iTunes"' -e'get artist of current track' -e'end tell'`
-title=`osascript -e'tell application "iTunes"' -e'get name of current track' -e'end tell'`
+artist=`osascript -e'tell application "Spotify"' -e'get artist of current track' -e'end tell'`
+title=`osascript -e'tell application "Spotify"' -e'get name of current track' -e'end tell'`
 
 song=`curl -G --data-urlencode "artist=$artist" \
  	--data-urlencode "title=$title" -s http://makeitpersonal.co/lyrics`
 
-echo -e "$artist - $title\n$song"
+echo -e "$artist - $title\n$song"

bin/passive

@@ -1,9 +1,8 @@
 #!/bin/bash
 
-# Abuse of the passive voice
+# Check for abuse of the passive voice
 # http://matt.might.net/articles/shell-scripts-for-passive-voice-weasel-words-duplicates/
 
-
 irregulars="awoken|\
 been|born|beat|\
 become|begun|bent|\

bin/proofread

@@ -1,7 +1,8 @@
 #!/bin/bash
 
-# http://matt.might.net/articles/shell-scripts-for-passive-voice-weasel-words-duplicates/
+# Check written text for the passive voice, weasel words and duplicate words.
 
+# http://matt.might.net/articles/shell-scripts-for-passive-voice-weasel-words-duplicates/
 
 # Common stuff
 CYAN="$(tput setaf 6)"

bin/semver

@@ -1,4 +1,7 @@
 #!/bin/bash
+
+# Update the version using semver (http://semver.org).
+
 # Sekati: Semantic Version String Manipulator
 # @author jason m horwitz | sekati.com
 # Copyright (C) 2012 jason m horwitz, Sekat LLC. All Rights Reserved.