FWIW, I've become a fan of this technique for doc strings:

```
RSpec.warn_deprecation(<<-EOS.gsub(/^\s+\|/, ''))
  |Some text
  |Some more text
  |blah blah
EOS
```

I like how it keeps the indentation flow rather than forcing the string to be fully left-aligned.

Not worth holding up this PR for, though; more something to think about in the future.  (Or not, if you don't prefer it...I hold this preference quite loosely).