Nice! I can fixup the http://osquery.readthedocs.io/en/stable/installation/cli-flags/#flagfile page a little but we don't have a

isFlagfileBroken

or similar API from gflags. We'd have to implement our own flagfile parser for that sort of error unfortunately.