additions to grim documentation