OS X: Add CMP0042 to enable MACOSX_RPATH by default.

Also adding documentation for CMAKE_MACOSX_RPATH, and improving
documentation for MACOSX_RPATH.
Merge topic 'rpath-default' into next

fe43ca2 OS X: Add CMP0042 to enable MACOSX_RPATH by default.