Включить --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,
...

иметь пикку Hscolour единственной важной (не нужно менять других, если не хотите).

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

sudo cabal install --global

---

cabal-install (команда оболочки cabal)

Чтобы заставить обновленную 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-документацию пикши с исходными кодами, гиперссылками по умолчанию.

Answer 3

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

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

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

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