Clarify Data.Data documentation
authorDavid Feuer <david.feuer@gmail.com>
Wed, 13 Sep 2017 12:22:42 +0000 (08:22 -0400)
committerBen Gamari <ben@smart-cactus.org>
Wed, 13 Sep 2017 14:39:56 +0000 (10:39 -0400)
commitf8e383f0e4f11e6e1060888208440907bcba9248
tree7e0e7d92f94b97ee72ff2262cc06d9c596f9daad
parentd645e441704a02b9eb5548e7c92cc5ee30a345ef
Clarify Data.Data documentation

Explain much more clearly when `dataCast1` and `dataCast2` can
have non-trivial implementations. On a couple different occasions,
I have attempted to write better defaults for these, only to
discover that we can't really do that. The new documentation
implicitly explains why that is.

[skip ci]

Reviewers: austin, hvr, bgamari, angerman

Reviewed By: bgamari, angerman

Subscribers: angerman, rwbarton, thomie

Differential Revision: https://phabricator.haskell.org/D3926
libraries/base/Data/Data.hs