Пикша для модулей, установленных Кабалом?

Я использую GHC и установил несколько пакетов через Cabal. На одном из веб-сайтов пакетов написано «посмотрите документацию по пикше». Кажется, что команда haddock работает только с исходными файлами, а cabal haddock работает только в каталоге верхнего уровня проекта с .cabal файлом сборки. Есть ли способ сказать «покажи мне пикшу» для модуля?

Я с нетерпением жду pydoc -p 12345, который запускает HTTP-сервер, предоставляющий документацию Python на основе того, что вы установили локально.

В качестве обходного пути я извлек архив с исходным кодом из-под ~/.cabal и запустил cabal configure; cabal haddock в исходном каталоге, но это своего рода боль.


haskell cabal haddock
person Harold L    schedule 19.10.2009    source источник

Ответы (4)


arrow_upward
18
arrow_downward

отредактируйте файл конфигурации:

~ / .cabal / config

есть возможность включить установочный документ по умолчанию:

документация: True

чтобы установить документы существующих пакетов, используйте:

cabal install xxx --reinstall

переустановите документы из базовых пакетов, а затем из пакетов верхнего уровня, чтобы «гиперссылка» на другие модули была сгенерирована правильно.

person wuxb    schedule 15.10.2011

arrow_upward
8
arrow_downward

Флаг --haddock у меня не сработал. Однако замена --haddock на --enable-documentation сделала:

cabal install $project --enable-documentation

Если бы они могли пропустить флаг --hyperlink-source на пикшу, я был бы очень счастлив.

person Kim    schedule 18.11.2009

arrow_upward
3
arrow_downward

Это известная проблема. В качестве обходного пути вы можете настроить установку Apache (если она у вас есть) для обслуживания каталога документов, используя этот небольшой скрипт PHP.

person Martijn    schedule 19.10.2009
comment
@Martjin: что касается этой ссылки, работает ли hackage.haskell.org для вас? отсюда похоже, что он не работает последние два дня, и downforeveryoneorjustme.com/hackage.haskell.org подтверждает .. - person yairchu; 19.10.2009
comment
Спасибо, ваши заметки в этом посте также побудили меня изменить мой .cabal / config для создания документов по умолчанию. - person Harold L; 19.10.2009
comment
Хакерство должно быть восстановлено. :-) Да, какое-то время не работал. Об этом спрашивали и в кафе Haskell. - person Martijn; 21.10.2009

arrow_upward
3
arrow_downward

Вы должны иметь возможность создавать локальную документацию с помощью:

cabal install $project --haddock

Предполагая, что у вас установлена ​​Пикша.

person Don Stewart    schedule 19.10.2009
comment
Спасибо - ссылка на взлом в другом ответе привела меня к тому же флагу. Затем я обновил свой файл .cabal / config, сделав его значением по умолчанию. Теперь (в OS X) я могу сказать: open ~ / .cabal / share / doc / $ project - * / html / index.html, и в моем браузере появятся документы. Я написал функцию bash, чтобы сделать это для имени проекта или распечатать сообщение об ошибке, если файл index.html не существует. - person Harold L; 20.10.2009