[commit: base] master: Improve docs for GHC.IO.FD.openFile (57b9366)

[Simon Marlow]

Repository : ssh://darcs.haskell.org//srv/darcs/packages/base

On branch  : master

http://hackage.haskell.org/trac/ghc/changeset/57b9366e5fd3db86719d12b45320e6145b040fa6

>---------------------------------------------------------------

commit 57b9366e5fd3db86719d12b45320e6145b040fa6
Author: Simon Marlow <marlowsd at gmail.com>
Date:   Fri Apr 1 12:15:50 2011 +0100

    Improve docs for GHC.IO.FD.openFile

>---------------------------------------------------------------

 GHC/IO/FD.hs |   10 +++++++---
 1 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/GHC/IO/FD.hs b/GHC/IO/FD.hs
index 012bb73..1730885 100644
--- a/GHC/IO/FD.hs
+++ b/GHC/IO/FD.hs
@@ -139,9 +139,13 @@ writeBuf' fd buf = do
 -- opening files
 
 -- | Open a file and make an 'FD' for it.  Truncates the file to zero
--- size when the `IOMode` is `WriteMode`.  Puts the file descriptor
--- into non-blocking mode on Unix systems.
-openFile :: FilePath -> IOMode -> Bool -> IO (FD,IODeviceType)
+-- size when the `IOMode` is `WriteMode`.
+openFile
+  :: FilePath -- ^ file to open
+  -> IOMode   -- ^ mode in which to open the file
+  -> Bool     -- ^ open the file in non-blocking mode?
+  -> IO (FD,IODeviceType)
+
 openFile filepath iomode non_blocking =
   withFilePath filepath $ \ f ->