check-all-helps

#!/bin/bash

set -o errexit

cd $(dirname "${BASH_SOURCE[0]}")

compdb --help > all-helps.txt.new

compdb help | grep "^  [a-z]" | while read command descr; do
  echo
  echo
  echo "# $command"
  echo
  compdb $command --help
done >> all-helps.txt.new

if ! diff -u all-helps.txt{,.new}; then
    cat <<EOF

------------------------------------------------

A change in the CLI interface has been detected,
consider updating the following file:

    functions/_compdb

To remove this notice, update 'all-helps.txt':

    pushd $(pwd)
    cp all-helps.txt.new all-helps.txt
    popd
EOF
    exit 1
fi

rm all-helps.txt.new

echo "Up-to-date!"