Включить --hyperlink-source для "установки cabal"

Question

Команда cabal haddock имеет очень полезную опцию --hyperlink-source. Я хотел бы иметь ссылку на источник при сборке документации с cabal install.

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

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

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

Answer 1

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

Answer 2

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

cabal update
cabal install haddock

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

Включить Documentation: True (удаление «-» в начале строки - нормально)

---

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

cd ...someNicePlace...    

cabal unpack Cabal

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

Я переключил некоторые из них с False на True:

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

наличие haddockHscolour единственного важного (не нужно менять других, если не хотите).

Установить обновленную библиотеку Cabal:

sudo cabal install --global

---

cabal-install (команда cabal shell)

Чтобы заставить обновленную Cabal Libary работать в команде cabal shell, я переустановил также cabal-install:

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 

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

Answer 3

Билет № 517 предназначен для передачи опций пикши через кабалу, например, если у вас есть особые потребности, такие как создание базы данных hoogle или использование другого CSS

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

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

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