[doc] heading and multi-line comments

Missing

 clauses and/or indentation management.