swift234

[stdlib] OptionSets - prepare for API review

- Applies the result of discussions in the Swift langauge
  review meeting, significantly simplifying the protocols and
  implementations

- Adds documentation

- Adds a static `element(_, subsumes:_)` method that reifies a term
  from documentation in code.

Swift SVN r28524