Abadejo: No se pudo crear el gráfico de dependencia (al agregar secciones con * o una partida módulo)

Question

Me compilado e instalado abadejo-2.4.2 de la fuente tarball.

Agregar unas simples comentarios en el código aquí:

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

y funcionando abadejo

$ 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

rendimientos:

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

Las cosas se ven bien. (Tenga en cuenta que este módulo sólo depende de bibliotecas que se incluyen con ningún otro módulo de fuente y GHC.)

Sin embargo, cuando intento agregar secciones (a la http: //www.haskell.org/haddock/doc/html/ch03s04.html#id289234 ) en los comentarios con "- * prueba" me sale:

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

No tengo idea de por dónde empezar conseguir que esto funcione ya que este mensaje de error sólo me dice que Haddock.Interface.depanal volvió Nada (de acuerdo con un grep de las fuentes de eglefino), pero no la forma de detener el análisis de la dependencia de la quiebra. Tal vez necesito un poco más los argumentos de línea de comandos o referencias a la falta de destinos de vínculos en / base de la documentación GHC / contenedores o algún archivo de configuración abadejo?

Búsqueda de Google dio un montón de Cabal errores de construcción de la misma calaña de paquetes en hackage pero nada acerca de cómo solucionarlos.

¿Cómo agrego secciones (marcados con asterisco) y consigo eglefino para generar mis documentos? Lo que (probablemente cosa sencilla) me estoy perdiendo?

Answer 1

solución simple (mensaje de error horrible):

Mueve el (hasta la línea con el nombre del módulo mal código anterior:.

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

Código feliz se ve así:

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

Bastante simple. Yo descubrí esto descargando DList de hacakge y eviscerado y reemplazar el código con mi el propio código. Cuando DList trabajó con 'abadejo cábala' y la mía no lo hizo (cuando traté de añadir algunos asteriscos), miré a la diferencia entre los archivos y lo suficientemente seguro de que mi paréntesis estaba en la línea equivocada.

Por cierto, le recomiendo DList como punto de partida para un nuevo proyecto Haskell en lugar de hnop .