Some work to improve the structure of the haddock documenation

gf.cabal

@@ -141,6 +141,7 @@ Library
   hs-source-dirs: src/compiler
   exposed-modules:
     GF
+    GF.Support
     GF.Text.Pretty
 
   other-modules:

src/compiler/GF.hs

@@ -16,16 +16,7 @@ module GF(
            module GF.Grammar.Printer,
            module GF.Infra.Ident,
            -- ** Binary serialisation
-           module GF.Grammar.Binary,
-
-           -- * Supporting infrastructure and system utilities
-           module GF.Infra.Location,
-           module GF.Data.Operations,
-           module GF.Infra.UseIO,
-           module GF.Infra.Option,
-           module GF.System.Console,
-           -- ** Binary serialisation
-           Binary,encode,decode,encodeFile,decodeFile
+           module GF.Grammar.Binary
   ) where
 import GF.Main
 import GF.Compiler
@@ -41,10 +32,3 @@ import GF.Grammar.Macros
 import GF.Grammar.Printer
 import GF.Infra.Ident
 import GF.Grammar.Binary
-
-import GF.Infra.Location
-import GF.Data.Operations
-import GF.Infra.Option
-import GF.Infra.UseIO
-import GF.System.Console
-import Data.Binary

src/compiler/GF/Infra/Option.hs

@@ -1,6 +1,7 @@
 module GF.Infra.Option
     (
-     -- ** Option types
+     -- ** Command line options
+     -- *** Option types
      Options, 
      Flags(..), 
      Mode(..), Phase(..), Verbosity(..), 
@@ -8,21 +9,21 @@ module GF.Infra.Option
      SISRFormat(..), Optimization(..), CFGTransform(..), HaskellOption(..),
      Dump(..), Pass(..), Recomp(..),
      outputFormatsExpl, 
-     -- ** Option parsing
+     -- *** Option parsing
      parseOptions, parseModuleOptions, fixRelativeLibPaths,
-     -- ** Option pretty-printing
+     -- *** Option pretty-printing
      optionsGFO,
      optionsPGF,
-     -- ** Option manipulation
+     -- *** Option manipulation
      addOptions, concatOptions, noOptions,
      modifyFlags,
      helpMessage,
-     -- ** Checking specific options
+     -- *** Checking specific options
      flag, cfgTransform, haskellOption, readOutputFormat,
      isLexicalCat, isLiteralCat, renameEncoding, getEncoding, defaultEncoding,
-     -- ** Setting specific options
+     -- *** Setting specific options
      setOptimization, setCFGTransform,
-     -- ** Convenience methods for checking options
+     -- *** Convenience methods for checking options
      verbAtLeast, dump
     ) where
 

src/compiler/GF/Infra/UseIO.hs

@@ -12,8 +12,9 @@
 -- (Description of the module)
 -----------------------------------------------------------------------------
 
-module GF.Infra.UseIO(module GF.Infra.UseIO,
-                      -- ** Reused
+module GF.Infra.UseIO(-- ** Files and IO
+                      module GF.Infra.UseIO,
+                      -- *** Reused
                       MonadIO(..),liftErr) where
 
 import Prelude hiding (catch)
@@ -40,7 +41,7 @@ import Control.Exception(evaluate)
 --putIfVerb :: MonadIO io => Options -> String -> io ()
 putIfVerb opts msg = when (verbAtLeast opts Verbose) $ putStrLnE msg
 
--- ** GF files path and library path manipulation
+-- *** GF files path and library path manipulation
 
 type FileName = String
 type InitPath = String -- ^ the directory portion of a pathname
@@ -123,7 +124,7 @@ splitInModuleSearchPath s = case break isPathSep s of
 
 --
 
--- ** IO monad with error; adapted from state monad
+-- *** Error handling in the IO monad
 
 -- | Was: @newtype IOE a = IOE { appIOE :: IO (Err a) }@
 type IOE a = IO a
@@ -177,7 +178,7 @@ die :: String -> IO a
 die s = do hPutStrLn stderr s
            exitFailure
 
--- ** Diagnostic output
+-- *** Diagnostic output
 
 class Monad m => Output m where
   ePutStr, ePutStrLn, putStrE, putStrLnE :: String -> m ()
@@ -215,7 +216,7 @@ ioErrorText e = if isUserError e
                 then ioeGetErrorString e
                 else show e
 
--- ** Timing
+-- *** Timing
 
 timeIt act =
   do t1 <- liftIO $ getCPUTime
@@ -223,7 +224,7 @@ timeIt act =
      t2 <- liftIO $ getCPUTime
      return (t2-t1,a)
 
--- ** File IO
+-- *** File IO
 
 writeUTF8File :: FilePath -> String -> IO ()
 writeUTF8File fpath content =

src/compiler/GF/Support.hs

@@ -0,0 +1,17 @@
+module GF.Support(
+           -- * Supporting infrastructure and system utilities
+           module GF.Infra.Location,
+           module GF.Infra.Option,
+           module GF.Data.Operations,
+           module GF.Infra.UseIO,
+           module GF.System.Console,
+           -- ** Binary serialisation
+           Binary,encode,decode,encodeFile,decodeFile
+  ) where
+
+import GF.Infra.Location
+import GF.Data.Operations
+import GF.Infra.Option
+import GF.Infra.UseIO
+import GF.System.Console
+import Data.Binary

src/compiler/GF/System/Console.hs

@@ -1,8 +1,9 @@
 {-# LANGUAGE CPP #-}
 module GF.System.Console(
-    -- ** Changing which character encoding to use for console IO
+    -- ** Console IO
+    -- *** Changing which character encoding to use for console IO
     setConsoleEncoding,changeConsoleEncoding,
-    -- ** Console colors
+    -- *** Console colors
     TermColors(..),getTermColors
 ) where
 import System.IO