haskell - Habilitar--hyperlink-source para "instalar cabal"

haddock

Question

El comando hadal de Cabal tiene una opción muy útil --hyperlink-source. Me gustaría tener la fuente con un enlace hipertexto al crear documentación con cabal install .

El boleto # 517 parece ser solo eso: http://hackage.haskell.org/trac/hackage/ticket/517

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

De lo contrario, ¿cómo puedo hacer que funcione la compilación de instalación de cabal con el parche desde el # 517 sin instalar Cabal-1.9, que actualmente es obligatorio (debido a un parche de diciembre)?

Answer 1

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

Answer 2

El boleto n. ° 517 se trata de pasar opciones de eglefino a través de Cabal, como si tiene necesidades especiales como crear una base de datos de hoogle o usar un CSS diferente

Sin embargo, la mayoría de los usuarios estarán contentos con el eglefino estándar y las fuentes con hipervínculos, lo que es posible con Cabal-1.8. El boleto # 517 es si tienes necesidades más grandes.

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

Si desea que esto sea el predeterminado, puede editar ~/.cabal/config como mencionó.

Answer 3

Para mí esto funcionó:

cabal update
cabal install haddock

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

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

Biblioteca de Cabal:

cd ...someNicePlace...
cabal unpack Cabal

Edite el archivo Distribution/Simple/Setup.hs , en él encontrará defaultHaddockFlags = ...

Cambié algunos de ellos de falso a verdadero:

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

habiendo haddockHscolour el único importante (no tienes que cambiar los otros si no quieres).

Instalar la biblioteca Cabal actualizada:

sudo cabal install --global

cabal-install (comando de shell cabal)

Para que el Cabal Libary actualizado funcionara dentro del comando de shell de cabal, reinstalé cabal-install también:

cd ...someNicePlace...
cabal unpack cabal-install
sudo cabal install --global

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

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

Y, según lo deseado, cualquier nueva instalación de Cabal está instalando la documentación html completa de haddock con los códigos de origen con hipervínculos como predeterminados.