clarify rationale for library header notation