base: Document errno behaviour in haddocks.
base: Document errno behaviour in haddocks.

Also add an implementation comment for details.
sdiehl/ghc,sdiehl/ghc,sdiehl/ghc,sdiehl/ghc,sdiehl/ghc,sdiehl/ghc,sdiehl/ghc