X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;f=Text%2FShow.hs;h=4d23e578dff1a4ffb06c4991fffb041c4a39945c;hb=refs%2Fheads%2Fmaster;hp=3f2e1a78237ca64b872f82567c32999257981a71;hpb=f7a485978f04e84b086f1974b88887cc72d832d0;p=ghc-base.git

diff --git a/Text/Show.hs b/Text/Show.hs
index 3f2e1a7..4d23e57 100644
--- a/Text/Show.hs
+++ b/Text/Show.hs
@@ -1,4 +1,5 @@
-{-# OPTIONS -fno-implicit-prelude #-}
+{-# LANGUAGE CPP, NoImplicitPrelude #-}
+
 -----------------------------------------------------------------------------
 -- |
 -- Module      :  Text.Show
@@ -9,32 +10,35 @@
 -- Stability   :  provisional
 -- Portability :  portable
 --
--- The Show class and associated functions.
+-- Converting values to readable strings:
+-- the 'Show' class and associated functions.
 --
 -----------------------------------------------------------------------------
 
 module Text.Show (
-   ShowS,	 	-- String -> String
+   ShowS,               -- String -> String
    Show(
-      showsPrec,	-- :: Int -> a -> ShowS
-      show,		-- :: a   -> String
-      showList		-- :: [a] -> ShowS 
+      showsPrec,        -- :: Int -> a -> ShowS
+      show,             -- :: a   -> String
+      showList          -- :: [a] -> ShowS 
     ),
-   shows,		-- :: (Show a) => a -> ShowS
-   showChar,		-- :: Char -> ShowS
-   showString,		-- :: String -> ShowS
-   showParen,		-- :: Bool -> ShowS -> ShowS
-   showListWith,	-- :: (a -> ShowS) -> [a] -> ShowS 
+   shows,               -- :: (Show a) => a -> ShowS
+   showChar,            -- :: Char -> ShowS
+   showString,          -- :: String -> ShowS
+   showParen,           -- :: Bool -> ShowS -> ShowS
+   showListWith,        -- :: (a -> ShowS) -> [a] -> ShowS 
  ) where
 
 #ifdef __GLASGOW_HASKELL__
 import GHC.Show
-#endif   
+#endif
 
-#ifdef __GLASGOW_HASKELL__
-showListWith :: (a -> ShowS) -> [a] -> ShowS 
+-- | Show a list (using square brackets and commas), given a function
+-- for showing elements.
+showListWith :: (a -> ShowS) -> [a] -> ShowS
 showListWith = showList__
-#else
+
+#ifndef __GLASGOW_HASKELL__
 showList__ :: (a -> ShowS) ->  [a] -> ShowS
 showList__ _     []     s = "[]" ++ s
 showList__ showx (x:xs) s = '[' : showx x (showl xs)