add some more appledoc-style comments
remove unused optional protocol signatures