Vorrei iniziare a utilizzare Haddock; la ragione principale non è che io (o chiunque altro) abbia bisogno di una buona documentazione HTML per quello che sto scrivendo in questo momento, ma che mi insegnerà un modo standardizzato di commentare i moduli Haskell. Per questo motivo, mi piacerebbe sporcarmi le mani, ma mi sono imbattuto in un problema piuttosto semplice.Eseguire l'eglefino da solo
Fonte:
module Main where
-- |This is the main function.
main = putStrLn "Hello World!"
Haddock invocazione:
> haddock -h test.hs
Haddock coverage:
50% ( 1/2) in 'Main'
Warning: Main: could not find link destinations for:
GHC.Types.IO
Sembra Haddock non sa dove cercare le librerie standard, ma questo è solo un ipotesi. I documenti dicono qualcosa su un parametro "-B", ma in realtà non ne spiegano molto.
Ho cercato il problema online, ed è stato fondamentalmente risposto con "usa un pacchetto Cabal e farà tutto per te". Tuttavia, preferirei non trattare con Cabal in questo momento, ma imparare Haddock da solo (Cabal può aspettare). C'è una soluzione semplice e facile (ish) al problema?
Solo per mettere un punto dati là fuori: ho scritto un sacco di documentazione e mai una volta invocato 'eglefino 'a mano. –
Corretto, l'eglefino non sa dove trovare i documenti per le librerie installate da solo, devi dirlo. Non sono un esperto, ma l'opzione '--read-interface = FILE' dice a haddock dove trovare i documenti. Tuttavia, lasciare che 'cabal' faccia il lavoro sia molto più semplice. –
La Cabala ha lo scopo di semplificarti la vita. Perché aspettare? –