These javadocs are formatted horridly - remember that its primary purpose is to render in an emitter.