2010-03-18 2 views
21

Команда cabal haddock имеет очень полезную опцию -hyperlink-source. Я хотел бы иметь источник, связанный с гиперссылкой при создании документации с помощью cabal install.Включить --hyperlink-источник для «установки для установки»

Билет # 517, кажется, как раз об этом: http://hackage.haskell.org/trac/hackage/ticket/517

Однако, возможно, можно установить этот флаг через ~/.cabal/конфигурационный файл?

Если нет, то как я могу получить рабочую сборку с помощью патча от # 517 без установки Cabal-1.9, которая в настоящее время является обязательной (из-за одного патча с декабря)?

+0

В чем проблема с установкой Cabal-0.9? – SamB

ответ

5

В настоящее время вы не можете получить эквивалент опции --hyperlink-source при использовании команды «все в одном» cabal install. Билет, который вы цитируете, касается именно этой проблемы.

+0

Это все еще так? –

+3

Предстоящий Cabal 1.20 [исправил это исправление] (https://github.com/haskell/cabal/pull/1707): он добавляет раздел 'haddock' в' ~/.cabal/config', где вы можете сказать 'гиперссылка -source: True'. – nh2

3

Ticket # 517 о прохождении вариантов пикши через заговорщик, как если у вас есть особые потребности, такие как строительство hoogle базы данных или США другого CSS

Большинства пользователей будет счастлив со стандартной пикшей и гиперссылка источников, хотя, что возможно с Cabal-1.8. Билет № 517 - если у вас больше потребностей.

Просто позвонить cabal haddock --hyperlink-source должен сделать трюк.

Если вы хотите, чтобы это по умолчанию, вы можете отредактировать ~/.cabal/config, как вы упомянули.

+0

Используется ли это по умолчанию, когда Haddock doc создается как часть вызова «cabal install some-package»? Я думаю, что это то, о чем идет OP, и что, похоже, не работает. – MtnViewMark

+0

Я не хочу, чтобы я когда-либо называл «кабальной пикшей». Я хочу иметь возможность создавать и устанавливать программы с помощью «cabal install» и иметь гиперссылку источника в процессе. – Tener

+0

О, я вижу. Я не знаю такого решения. –

4

Для меня это сработало:

cabal update 
cabal install haddock 

Редактировать конфигурационный файл ~/.cabal/config

Включить Documentation: True (удаление "-" в начале строки штраф)


Кабал Библиотека:

cd ...someNicePlace...  

cabal unpack Cabal 

Редактировать файл Distribution/Simple/Setup.hs, в нем найти defaultHaddockFlags = ...

Я включил некоторые из них от Ложные к True:

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

имеющий haddockHscolour единственным важным (не изменить других, если не хотят).

Установка обновленных Cabal Библиотека:

sudo cabal install --global 

междусобойчик установить (междусобойчик командной оболочки)

Чтобы получить обновленный Cabal Libary работать в команде междусобойчик оболочки, я переустановил междусобойчик установить также:

cd ...someNicePlace...  

cabal unpack cabal-install 

sudo cabal install --global 

С тех пор команда оболочки cabal --version говорит мне:

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

И, как хотели, любая новая кабала установки теперь установка полного пикши HTML документации с исходными кодами гиперссылка по умолчанию.