Add haddock comments on RTLD_NEXT and RTLD_DEFAULT

Related to ticket [8902](https://ghc.haskell.org/trac/ghc/ticket/8902).

Plus code cleanup, including deprecating haveRtldLocal.