[DOC] cleanup docs to facilitate man page creation.