improve javadoc for canvases