Haddock pour les modules Cabal installés?

Question

J'utilise GHC et ai installé plusieurs paquets via Cabal. L'un des paquets de site Web dit « aller voir la documentation de l'aiglefin ». La commande haddock semble fonctionner uniquement sur les fichiers source et cabal haddock semble ne fonctionner que dans le répertoire de niveau supérieur d'un projet avec un fichier de construction de .cabal. Est-il possible de dire « montrez-moi le haddock » pour un module?

Je suis nostalgie de pydoc -p 12345 qui démarre un serveur HTTP fournissant de la documentation Python en fonction de ce que vous avez installé localement.

En tant que travail autour, j'extraira tarball sous ~/.cabal et couru cabal configure; cabal haddock dans le répertoire source, mais c'est une sorte de douleur.

Answer 1

modifier votre fichier de configuration:

  

~ / .cabal / config

il y a une option pour activer l'installation par défaut doc:

  

Documentation: True

pour installer doc des packages existants, utilisez:

  

cabale installer xxx --reinstall

re-installer docs de packages de base alors les paquets de niveau supérieur, de sorte que le "hyper-lien" vers d'autres modules seront générés correctement.

Answer 2

Le drapeau de --haddock ne fonctionne pas pour moi. Cependant, le remplacement --haddock avec --enable-documentation fait:

cabal install $project --enable-documentation

Maintenant, si elles pourraient permettre le drapeau de --hyperlink-source à fermeture éclair à l'aiglefin, je serais très heureux.

Answer 3

Ceci est un problème connu . Pour contourner ce problème, vous pouvez configurer votre installation d'Apache (si vous en avez un) pour servir votre répertoire doc en utilisant ce petit script PHP .

Answer 4

Vous devriez être en mesure de générer de la documentation locale avec:

cabal install $project --haddock

En supposant que vous avez installé Haddock.