[utility] Make content in hanging paragraph non-normative. #1920
Conversation
| \pnum | ||
| The header \tcode{<utility>} defines several types and function templates | ||
| that are described in this Clause. It also defines the template \tcode{pair} | ||
| and various function templates that operate on \tcode{pair} objects. |
There was a problem hiding this comment.
What on earth is the special call-out to pair achieving here? The header also defines in_place_index and index_sequence_for. Maybe this sentence came from an older time when pair really was the only class template here?
There was a problem hiding this comment.
This is pre-existing text that just got moved (from below the synopsis). There are similar introductory notes for most of the header synopses. If you feel this particular intro text warrants improvement, feel free to suggest something in a separate pull request.
There was a problem hiding this comment.
I'd prefer we just drop this entirely. If someone wants to know what's in <utility>, that's what the synopsis is for. I don't see any point in including a paragraph that says "The header <utility> includes the stuff we say it includes in the synopsis."
There was a problem hiding this comment.
Maybe we could ditch this and move the hanging paragraph into this section, replacing "This subclause" with "The header <utility>".
|
Rebased. |
Partially addresses #1771.