[provisioning] Add recipe descriptions

provision.sh

@@ -3,7 +3,7 @@ set +e
 trap 'exit' INT
 
 RECIPE_PATH=${HOME}/dotfiles/recipes
-RECIPES=$(ls $RECIPE_PATH|grep -v '^_')
+RECIPES=$(ls $RECIPE_PATH|grep -v '^_' | sort)
 INSTALL=()
 STACK=()
 
@@ -16,7 +16,9 @@ while [[ $# -gt 0 ]]; do
         -l|--list)
             echo Available recipes:
             for recipe in $RECIPES; do
-                echo "  $recipe"
+                description=$(grep '^# Description: ' "${RECIPE_PATH}/$recipe" \
+                                  | cut -d' ' -f 3-)
+                printf "%15s   %s\n" "$recipe" "$description"
             done
             exit
             ;;

recipes/apib

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Description: API Blueprint
 set -e
 
 _recipe nvm

recipes/base

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Description: Core set of frequently-used recipes
 set -e
 
 _recipe brew

recipes/bin

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Description: Various scripts and utilities
 set -e
 
 _recipe _path

recipes/brew

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Description: Package manager - Homebrew on OSX, Linuxbrew on Linux
 set -e
 
 function _brew {

recipes/elm

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Description: The Elm programming language
 set -e
 
 _recipe nvm

recipes/emacs

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Description: GNU Emacs
 set -e
 
 _recipe brew

recipes/email

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Description: Email syncing tools plus the mu4e client
 set -e
 
 _recipe brew

recipes/erlang

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Description: The Erlang programming language
 set -e
 
 _recipe brew

recipes/exercism

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Description: Coding exercises from exercism.io
 set -e
 
 _recipe brew

recipes/git

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Description: The Git version control system
 set -e
 
 case $_PLATFORM in

recipes/graphviz

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Description: Graph visualization software
 set -e
 
 case $_PLATFORM in

recipes/haskell

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Description: The Haskell programming language
 set -e
 
 _brew haskell-stack

recipes/ledger

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Description: Command-line double-entry accounting
 set -e
 
 _recipe brew

recipes/mit-scheme

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Description: MIT Scheme (used in SICP)
 set -e
 
 _recipe brew

recipes/nextcloud

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Description: File syncing
 set -e
 
 case $_PLATFORM in

recipes/nvm

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Description: Javascript version management
 set -e
 
 function __install_nvm {

recipes/pandoc

@@ -1,5 +1,6 @@
 #!/bin/bash
+# Description: Document conversion tool
 set -e
 
 _recipe brew
-_brew pandoc
+_brew pandoc

recipes/prolog

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Description: The (SWI) Prolog programming language
 set -e
 
 _recipe brew

recipes/python

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Description: The Python programming language
 set -e
 
 __PYTHON_VERSION=3.6.4

recipes/shell-utils

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Description: Useful command-line utilities
 set -e
 
 _recipe brew

recipes/tex

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Description: Document typesetting
 set -e
 
 case "$(uname -s)" in

recipes/zsh

@@ -1,4 +1,5 @@
 #!/bin/bash
+# Description: Feature-rich interactive shell with plugins
 set -e
 
 case $_PLATFORM in