fix missing paren in 1M example
add default value for fatal flag, plus some strong typing and convenience functions