Document the named subject feature.

Closes #1566
Is that necessary, since the spec on [line 169](https://github.com/rspec/rspec-core/pull/1632#discussion-diff-16034104R169) shows they are both set to `2`?

I can add that to the same spec if you want.