Haddock para módulos instalados em cabal?
Pergunta
Estou usando o GHC e instalei vários pacotes via cabala. Um dos sites dos pacotes diz "Vá ver a documentação do Haddock". o haddock
O comando parece funcionar apenas em arquivos de origem e cabal haddock
parece funcionar apenas no diretório de nível superior de um projeto com um .cabal
Arquivo de construção. Existe uma maneira de dizer "Mostre -me o Haddock" para um módulo?
Estou desejando pydoc -p 12345
que inicia um servidor HTTP fornecendo documentação do Python com base no que você instalou localmente.
Como sublinhado, extraí a fonte Tarball de Under ~/.cabal
e correu cabal configure; cabal haddock
No diretório de origem, mas isso é uma espécie de dor.
Solução
Edite seu arquivo de configuração:
~/.cabal/config
Existe uma opção para ativar o documento de instalação padrão:
Documentação: Verdadeiro
Para instalar o DOC de pacotes existentes, use:
Cabal Install xxx --reinstall
Reinstale os documentos de pacotes básicos e os pacotes de nível superior, para que o "hiper-link" para outros módulos seja gerado corretamente.
Outras dicas
o --haddock
Flag não funcionou para mim. No entanto, substituindo --haddock
com --enable-documentation
fez:
cabal install $project --enable-documentation
Agora, se eles pudessem permitir o --hyperlink-source
Sinalize para fechar para a arda, eu ficaria muito feliz.
Isto é um questão conhecida. Como solução alternativa, você pode configurar sua instalação do Apache (se tiver uma) para servir seu diretório do documento usando Este pequeno script PHP.
Você deve poder gerar documentação local com:
cabal install $project --haddock
Supondo que você tenha instalado o Haddock.