Also document around/exception behavior.
Merge pull request #1772 from jkingdon/around-and-exception

Also document around/exception behavior.
Changelog for #1772
[skip ci]
Updated travis build scripts (from rspec-dev)
Use 1.8.7 compatible ruby syntax.
Satisfy rubocop.

Offenses:

lib/rspec/core/example.rb:418:11: C: Do not prefix reader method names with get_.
      def get_generated_description
          ^^^^^^^^^^^^^^^^^^^^^^^^^
lib/rspec/core/example.rb:421:131: C: Line is too long. [139/130]
        location_description + " (Got an error when generating description from matcher: #{e.class}: #{e.message} -- #{e.backtrace.first})"
                                                                                                                                  ^^^^^^^^^
Fix invalid YARD method reference.

[warn]: In file `lib/rspec/core/formatters/protocol.rb':3: Cannot resolve link to #dump_failure from text:
[warn]: ...{#dump_failure}...
Fix YARD warnings.

[warn]: In file `lib/rspec/core/rake_task.rb':29: Cannot resolve link to ,// from text:
[warn]: ...{,//}...
[warn]: In file `lib/rspec/core/rake_task.rb':29: Cannot resolve link to ,// from text:
[warn]: ...{,//}...

Note that I haven't been able to repro these warnings locally with YARD
but they happen on travis. While I was at it, I fixed up some
inaccuracies in the documented defaults for rake task options.
Merge pull request #1778 from rspec/update-travis-build-scripts-2014-11-12-for-master

Updates from rspec-dev (2014-11-12)
Updated travis build scripts (from rspec-dev)
Merge pull request #1779 from rspec/update-travis-build-scripts-2014-11-12-for-master

Updates from rspec-dev (2014-11-12)
Updated travis build scripts (from rspec-dev)
`[.]` doesn’t appear to work well on windows.
Pend symlink specs on windows.
Fix ansicon specs on windows.

- Explicitly clear `ANSICON` ENV var in the context
  concerning when it’s not set. On appveyor we
  install ANSICON so it is in fact normally set.
- Move the specs out of the context that sets
  `config.color = true` in a `before` hook. This
  was causing problems because it triggered warnings
  before our `allow_warnings` code had a chance to
  silence them.
Fix rake task specs on windows.

- Skip specs that rely on shell escaping (not available on windows).
- On windows we wrap all args in single quotes, so change our
  expectations to allow for that.
Use platform-agnostic constant for file path separator.

This should (hopefully) fix the rake task specs on windows.
Skip a couple of specs on windows that don’t make sense to run there.
Pend remaining failing appveyor specs.
Merge pull request #1780 from rspec/update-travis-build-scripts-2014-11-13-for-master

Updates from rspec-dev (2014-11-13)