2010-03-18 7 views
21

Il comando cabal haddock ha un'opzione molto utile - hyperlink-source. Mi piacerebbe avere il collegamento ipertestuale all'origine quando si crea documentazione con cabal install.Abilita --hyperlink-source per "cabal install"

Il biglietto # 517 sembra essere solo su di esso: http://hackage.haskell.org/trac/hackage/ticket/517

Tuttavia, forse è possibile impostare questo flag tramite ~/.cabal/config presentare?

In caso contrario, come posso ottenere il funzionamento di cabal-install build con la patch da # 517 senza installare Cabal-1.9, che è attualmente obbligatorio (a causa di una patch di dicembre)?

+0

Qual è il problema con l'installazione di Cabal-0.9? – SamB

risposta

5

Attualmente non è possibile ottenere l'equivalente dell'opzione --hyperlink-source quando si utilizza il comando "tutto in uno" cabal install. Il biglietto che citi riguarda esattamente questo problema.

+0

È ancora così? –

+3

L'imminente Cabal 1.20 [ha risolto] (https://github.com/haskell/cabal/pull/1707): aggiunge una sezione 'haddock' in' ~/.cabal/config' dove si può dire 'collegamento ipertestuale -source: True'. – nh2

3

Ticket # 517 è di circa passando opzioni eglefino via cabala, come se si hanno esigenze particolari, come la costruzione di una banca dati Hoogle o usa un diverso CSS

La maggior parte degli utenti saranno felici con eglefino serie e fonti collegamento ipertestuale, però, che è possibile con Cabal-1.8. Il biglietto 517 è se hai esigenze più grandi.

Chiamare semplicemente cabal haddock --hyperlink-source dovrebbe fare il trucco.

Se si desidera che questo sia l'impostazione predefinita, è possibile modificare ~/.cabal/config come indicato.

+0

Questo valore predefinito viene utilizzato quando il documento Haddock viene creato come parte di una chiamata di "cabal install some-package"? Penso che sia ciò che l'OP sta cercando e cosa non sembra funzionare. – MtnViewMark

+0

Io non voglio mai chiamare "cabal eglefino" me stesso. Voglio essere in grado di creare e installare programmi con 'cabal install' e avere sorgenti con collegamenti ipertestuali nel processo. – Tener

+0

Oh, capisco. Non sono a conoscenza di una soluzione del genere. –

4

Per me questo ha funzionato:

cabal update 
cabal install haddock 

Modificare il file di configurazione ~/.cabal/config

Abilita Documentation: True (rimozione "-" all'inizio della riga va bene)


Cabal Library:

cd ...someNicePlace...  

cabal unpack Cabal 

Modificare il file Distribution/Simple/Setup.hs, ivi trovare defaultHaddockFlags = ...

ho acceso alcuni di loro da false a true:

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

avere haddockHscolour l'unica importante (non c'è bisogno di cambiare gli altri, se non voglio).

Installa aggiornamento Cabal libreria:

sudo cabal install --global 

cabala-install (comando di shell cabala)

Per ottenere la versione aggiornata Cabal Libary di lavoro all'interno dei comandi di shell cabala, ho reinstallato cabala-install anche:

cd ...someNicePlace...  

cabal unpack cabal-install 

sudo cabal install --global 

Da allora il comando di shell cabal --version mi dice:

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

E, come ha voluto, ogni nuovo cabala installare ora l'installazione di una documentazione completa html eglefino con i codici sorgente collegamento ipertestuale come predefinito.

Problemi correlati