Shapes: updated and cleaned up the documentation.