Eglefino:Non è riuscito a creare un grafico delle dipendenze (quando l'aggiunta di sezioni con ( * ) o un titolo modulo)

Question

Ho compilato e installato eglefino-2.4.2 dal tarball sorgente.

L'aggiunta di un semplice paio di commenti al codice qui:

• https://dl.getdropbox.com/u/143480/doc/DualMap.hs

e l'esecuzione di eglefino

$ haddock -h -o doc Data/DualMap.hs
Warning: Data.DualMap: could not find link destinations for:
    Data.Typeable.Typeable2 GHC.Base.Eq GHC.Show.Show GHC.Base.Ord GHC.Base.Bool Data.Set.Set

rendimenti:

• https://dl.getdropbox.com/u/143480/doc/Data-DualMap.html

Le cose sembrano andare bene.(Nota che questo modulo dipende solo da librerie che nave con GHC e non di altri moduli di origine.)

Tuttavia, quando cerco di aggiungere sezioni (una la http://www.haskell.org/haddock/doc/html/ch03s04.html#id289234 ) nei commenti con "-- * test" ottengo:

$ haddock -h -o doc Data/DualMap.hs
Data/DualMap.hs:20:0: parse error on input `-- * test'
haddock: Failed to create dependency graph

Non ho idea di dove iniziare a ottenere questo lavoro dal momento che questo messaggio di errore solo mi dice che l'Eglefino.L'interfaccia.depanal restituito Nulla (secondo un grep dell'eglefino fonti), ma non come interrompere l'analisi delle dipendenze da mancanza.Forse ho bisogno di un po più argomenti della riga di comando o riferimenti ad anello mancante destinazioni in GHC/base/contenitori di documentazione o di alcuni eglefino file di configurazione?

Ricerca Google ha reso un sacco di cabal errori di compilazione dello stesso ilk per i pacchetti hackage ma nulla su come risolverli.

Come faccio ad aggiungere sezioni (con gli asterischi) e ottenere Eglefino per generare i miei documenti?Quello che (probabilmente la cosa più semplice) mi manca?

Answer 1

Semplice correzione (terribile messaggio di errore):

Spostare l' ( fino alla riga con il nome del modulo.Cattivo codice:

module Data.DualMap
   -- * The @DualMap@ abstract type
   ( DualMap ()
   -- * (?) internal? -- exposed for testing purposes, for now...
   , dmFlip
   -- * converting to and from DualMap
   , toList, fromList, map
   -- * constructing a DualMap
   , empty, null, insert, union

Felice codice simile a questo:

module Data.DualMap (
   -- * The @DualMap@ abstract type                                                                                                                                 
     DualMap ()
   -- * (?) internal? -- exposed for testing purposes, for now...                                                                                                   
   , dmFlip
   -- * converting to and from DualMap                                                                                                                              
   , toList, fromList, map
   -- * constructing a DualMap                                                                                                                                      
   , empty, null, insert, union

Abbastanza semplice.Questo l'ho scoperto da scaricare DList da hacakge e sventrarla e sostituire il codice con il mio codice.Quando DList lavorato con 'cabal eglefino' e la mia non è (quando ho provato ad aggiungere alcuni asterischi), ho guardato la differenza tra le file e di sicuro la mia parentesi era sulla linea sbagliata.

BTW mi raccomando DList come un punto di partenza per un nuovo Haskell progetto invece di hnop.