mpl issue: #2974 - documentation corrected
Merge pull request #3025 from oliverw1/issue2974

mpl issue: #2974 - documentation corrected