Update custom shape docs.

Supersedes #692 now that we ship CaseClassShape directly in Slick.
Merge pull request #885 from slick/tmp/case-class-shape-docs

Update custom shape docs.