[GHC] #13175: Documenting what can be derived 'out of the box' by GHC's "deriving"

[GHC]

#13175: Documenting what can be derived 'out of the box' by GHC's "deriving"
-------------------------------------+-------------------------------------
        Reporter:  carette           |                Owner:
            Type:  task              |               Status:  new
        Priority:  normal            |            Milestone:
       Component:  Documentation     |              Version:  8.0.1
      Resolution:                    |             Keywords:
Operating System:  Unknown/Multiple  |         Architecture:
 Type of failure:  Documentation     |  Unknown/Multiple
  bug                                |            Test Case:
      Blocked By:                    |             Blocking:
 Related Tickets:                    |  Differential Rev(s):
       Wiki Page:                    |
-------------------------------------+-------------------------------------

Comment (by carette):

 Unfortunately I 'looked' via Google.  I expected to find it that way...
 Once the information is somewhere, I will then expect that that will
 indeed work.  But, in the meantime, I am still at a loss as to where to
 put it.

 One of the problems is that when you search for "GHC" and "deriving", the
 principal hits are to section 7.5 of the manual
 (https://downloads.haskell.org/~ghc/7.8.4/docs/html/users_guide/deriving.html)
 which documents the extensions to this mechanism. If you dig really
 (really!) hard, you eventually find section 4.3.3 of the Haskell 98 report
 (https://www.haskell.org/onlinereport/decls.html#derived-decls) which
 documents "deriving" (the 2010 report's 4.3.3 is essentially identical).
 But Google doesn't seem to like that much, so it doesn't show up.

 But the list in those reports is not the same as the list above!

 So I am still at a loss as to where to put this.  GHC's own documentation
 does not define "deriving" (because the Haskell reports already do), which
 would have been my first thought.  So maybe in 7.5 somewhere?

--
Ticket URL: <http://ghc.haskell.org/trac/ghc/ticket/13175#comment:2>
GHC <http://www.haskell.org/ghc/>
The Glasgow Haskell Compiler