Updated ScalaMock part of 'Testing with mock objects'

ScalaTest user guide section related to ScalaMock was **really** outdated. I've updated it to use the correct syntax and removed information about things that don't exist in ScalaMock 3 anymore (compiler plugin, etc.)