Пикша не генерируется при загрузке пакета в hackages

После того, как я загрузил свой пакет в hackages, он не генерировал пикшу, как другие пакеты.

Что-нибудь я пропустил?

Я сделал следующее:

  1. cabal dist и пакет, созданный в каталоге dist.
  2. откройте интерфейс hackage web upload и загрузите пакет.
  3. откройте URL и убедитесь, что пакет загружен успешно, но нет пикши. (в пакете есть несколько документов)

Спасибо.


person Simon    schedule 29.04.2012    source источник


Ответы (3)


Создание документов занимает немного времени. Я считаю, что они запускаются в полночь по Гринвичу.

person Thomas M. DuBuisson    schedule 29.04.2012
comment
Спасибо, Томас. Давайте следить за этим. - person Simon; 29.04.2012

В дополнение к ответу Томаса запустите cabal haddock в каталоге вашего пакета и найдите ошибки.

По моему опыту, пикша невероятно привередлива, особенно в отношении. кодовые блоки. Если вы получите ошибку синтаксического анализа, просто начните удалять комментарии, пока не будут созданы документы. Обычно я использую какой-нибудь подробно документированный пакет в качестве эталона.

person jberryman    schedule 29.04.2012

Похоже, что документация отсутствует, потому что ваш пакет был собран неправильно. Я нашел это ближе к концу журнала сборки< /а>:

src/Network/OAuth2/HTTP/HttpClient.hs:18:8:
    Could not find module `Control.Monad.Trans.Resource'
    It is a member of the hidden package `resourcet-0.3.2.1'.
    Perhaps you need to add `resourcet' to the build-depends in your .cabal file.
    Use -v to see a list of the files searched for.

Чтобы избежать подобных проблем, перед загрузкой убедитесь, что ваш пакет собран локально с помощью Cabal. Непосредственная сборка с помощью GHC часто маскирует такого рода проблемы, поскольку он с радостью использует любые установленные вами пакеты, независимо от того, упомянули ли вы их в файле .cabal или нет.

person hammar    schedule 29.04.2012
comment
На самом деле я не думаю, что ошибка имеет для меня смысл, потому что модуль `Control.Monad.Trans.Resource' является членом канала. Я могу встроить свой локальный сервер с помощью ghc-7.0.2, поэтому мне интересно, есть ли способ указать, что Hackages использует конкретную версию GHC. - person Simon; 30.04.2012
comment
Я думаю, что нашел причину. Я не указал верхний предел канала, поэтому хакеры используют последний, который удалил Resource API. - person Simon; 30.04.2012