haskell - 使用 cabal 构建黑线鳕文档时出错

Question

我目前正在Haskell 上开发小型应用程序。我也有所有记录main。但cabal haddock --executables显示错误：

Running Haddock for XComposeChecker-0.1...
Preprocessing executables for XComposeChecker-0.1...
Warning: The documentation for the following packages are not installed. No
links will be generated to these packages: rts-1.0
haddock coverage for ./XComposeChecker.hs:    8/13  62%
Warning: Couldn't find TyThing for exported Main.main: main:Main.main; not documenting.
haddock coverage for dist/build/tmp3599/./Main.hs:     1/2  50%
Warning: Main: could not find link destinations for:
    Main.main
Documentation created: dist/doc/html/XComposeChecker/checker/index.html

而Main.hs它本身：

import Text.ParserCombinators.Parsec
import System.Directory
import System.FilePath

import XComposeChecker

-- | Main
main = do
         homedir <- getHomeDirectory
         result <- parseFromFile parseXComposeFile (joinPath [homedir, ".XCompose"])
         print result

为什么haddock找不到文档main？

使用ghc-7.0.4,cabal-1.10.2.0和。haddock-2.9.2_Fedora 17

Answer 1

黑线鳕文档必须附加到类型签名中。试试这个：

-- | Main
main :: IO ()
main = do
    print 3

补充：还需要补充：

module Main(main) where

在 的开头Main.hs，这允许haddock查找和记录main函数。