2010-03-18 12 views
21

El comando cabal haddock tiene una opción muy útil --hyperlink-source. Me gustaría tener la fuente hipervinculada al compilar la documentación con cabal install.Habilite --hyperlink-source para "cabal install"

El boleto # 517 parece ser sólo en esto: http://hackage.haskell.org/trac/hackage/ticket/517

Sin embargo, tal vez es posible establecer este indicador a través de ~/.cabal/config?

Si no es así, ¿cómo puedo conseguir que funcione la instalación de la instalación de cabal con el parche del n. ° 517 sin instalar Cabal-1.9, que actualmente es obligatorio (debido a un parche de diciembre)?

+0

¿Cuál es el problema con la instalación de Cabal-0.9? – SamB

Respuesta

5

Actualmente no puede obtener el equivalente de la opción --hyperlink-source cuando usa el comando "todo en uno" cabal install. El boleto que cita es exactamente sobre este tema.

+0

¿Sigue siendo así? –

+3

El próximo Cabal 1.20 [tiene esto arreglado] (https://github.com/haskell/cabal/pull/1707): agrega una sección 'haddock' en' ~/.cabal/config' donde puedes decir 'hyperlink -source: True'. – nh2

3

Ticket # 517 está a punto de pasar opciones eglefino través de Cabal, al igual que si usted tiene necesidades especiales, como la construcción de una base de datos Hoogle o EE.UU. un CSS diferente

mayor cantidad de usuarios estarán encantados con abadejo estándar y fuentes de hipervínculos embargo, que es posible con Cabal-1.8. El boleto # 517 es si tiene mayores necesidades.

Simplemente llamando cabal haddock --hyperlink-source debería hacer el truco.

Si quiere esto como el predeterminado, puede editar ~/.cabal/config como mencionó.

+0

¿Se usa ese valor predeterminado cuando se construye el documento Haddock como parte de una invocación de "cabal install some-package"? Creo que eso es lo que busca el OP, y lo que parece no funcionar. – MtnViewMark

+0

No quiero llamar nunca al 'caballero abadejo'. Quiero ser capaz de construir e instalar programas con 'cabal install' y tener una fuente hipervinculada en el proceso. – Tener

+0

Oh, ya veo. No estoy al tanto de tal solución. –

4

Para mí esto funcionó:

cabal update 
cabal install haddock 

Editar archivo de configuración ~/.cabal/config

Habilitar Documentation: True (quitando "-" al principio de la línea está bien)


Cabal Biblioteca:

cd ...someNicePlace...  

cabal unpack Cabal 

archivo Editar Distribution/Simple/Setup.hs, en ella se encuentran defaultHaddockFlags = ...

me cambiaron algunos de ellos de falso a verdadero:

... 
haddockHoogle  = Flag True, 
... 
haddockHtml   = Flag True, 
... 
haddockExecutables = Flag True, 
... 
haddockHscolour  = Flag True, 
... 

tener haddockHscolour el único importante (no tienen que cambiar a los demás si no quieren).

Instalar actualizan Cabal Biblioteca:

sudo cabal install --global 

Cabal instalar-(comando shell Cabal)

para obtener la versión actualizada de Cabal Libary trabajar dentro de comando shell Cabal, Reinstalé Cabal-instalar también:

cd ...someNicePlace...  

cabal unpack cabal-install 

sudo cabal install --global 

Desde entonces, el comando shell cabal --version me dice:

cabal-install version 1.16.0.2 
using version 1.16.0.3 of the Cabal library 

Y, como quería, cualquier nueva cábala instalar ahora la instalación de la documentación HTML abadejo completa con códigos fuente hipervínculos como predeterminado.