homebrew-cask/developer/bin/generate_man_pages

#!/bin/bash
#
# generate_man_pages
#
# This is temporary, should be replaced with a Rakefile target
#

###
### settings
###

set -e                # exit on uncaught error
set +o histexpand     # don't expand history expressions
shopt -s nocasematch  # case-insensitive regular expressions

###
### functions
###

warn () {
    local message="$@"
    if ! [[ $message =~ "\n"$ ]]; then
        message="${message}\n"
    fi
    printf "$message" 1>&2
}

die () {
    warn "$@"
    exit 1
}

cd_to_project_root () {
    local script_dir="$(/usr/bin/dirname "$0")"
    cd "$script_dir"
    local git_root="$(git rev-parse --show-toplevel)"
    if [[ -z "$git_root" ]]; then
        die "ERROR: Could not find git project root"
    fi
    cd "$git_root"
}

###
### main
###

cd_to_project_root

if ! /usr/bin/which ronn >/dev/null 2>&1; then
    die "ERROR: The 'ronn' gem must be installed"
fi

ronn --roff --pipe --organization='Homebrew-cask' --manual='brew-cask' doc/src/brew-cask.1.md > doc/man/brew-cask.1

#