various checkdoc fixes
documenting alternatives