big fat warning to avoid an issue that Lionel encountered
cleanups: kill unused forward declarations
document the fact that we accept abbreviations of log setting modifiers, even harsh ones