[GHC] #12586: Add types warning to Foreign.C.Types

[GHC]

#12586: Add types warning to Foreign.C.Types
-------------------------------------+-------------------------------------
           Reporter:  Phyx-          |             Owner:
               Type:  bug            |            Status:  new
           Priority:  normal         |         Milestone:
          Component:                 |           Version:  8.0.1
  libraries/base                     |
           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:
-------------------------------------+-------------------------------------
 Documentation for the base types in `Foreign.C` are incorrect on Hackage.

 Not really incorrect but only valid for the platform for which Haddock
 runs.

 As an example it says for `CLong`

 {{{
 newtype CLong = CLong Int64
 }}}

 Which is Incorrect on Windows. I don't know a technical solution for this,
 so I'm proposing a non-technical one: Add a warning on the top of the
 `Foreign-C-Types` to indicate that these types may differ on various
 platforms.

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