gl2: more idiomatic internal documentation.