2009-10-19 23 views
10

GHC kullanıyorum ve Cabal üzerinden birkaç paket kurdum. Paketlerin web sitelerinden biri "mezgit belgelerini görmeye git" diyor. haddock komutu yalnızca kaynak dosyalarında çalışmaktadır ve cabal haddock yalnızca bir projenin üst düzey dizininde .cabal yapı dosyasıyla çalışmaktadır. Bir modül için "mezgit balığı göster" demek için bir yol var mı?Cabal yüklü modüller için Haddock?

Yerel olarak neleri yüklediğinize göre Python belgelerini sağlayan bir HTTP sunucusunu başlatan pydoc -p 12345 için özlem yapıyorum.

Çalışma ortamında kaynak dizgisini ~/.cabal'un altına ayıkladım ve kaynak dizinde cabal configure; cabal haddock'u çalıştırdım ancak bu bir tür acıdır.

cevap

19

düzenlemek için yapılandırma dosyası:

~/.cabal/config

doc yüklemek varsayılan etkinleştirmek için bir seçenek vardır:

belgeleri: Doğru

Varolan paketlerin kurulumunu yüklemek için, aşağıdakileri kullanın:

cabal xxx --reinstall temel sonra paketler üst düzey paketleri, bu nedenle diğer modüllere "hiper-link" dan

yeniden yüklemek docs düzgün oluşturulur install.

3

Bu bir known issue dur. Bir geçici çözüm olarak, Apache yüklemenizi (varsa), this small PHP script kullanarak doc dizininize sunmak üzere yapılandırabilirsiniz.

+0

@Martjin: Bu bağlantı ile ilgili olarak, hackage.haskell.org sizin için çalışıyor mu? Buradan son iki gün için aşağı gibi görünüyor ve http://downforeveryoneorjustme.com/hackage.haskell.org doğrular .. – yairchu

+0

Teşekkürler, o yazının notları da üretmek için benim .cabal/config değiştirmemi sağladı varsayılan olarak dokümanlar. –

+0

Hackage şimdi yedeklenmeli. :-) Evet, bir süreliğine oldu. İnsanlar da Haskell kafesinde bunu soruyorlardı. – Martijn

3

Sen ile yerel belgeleri oluşturmak mümkün olmalıdır:

cabal install $project --haddock 

Eğer Haddock yüklü varsayarsak.

+1

Teşekkürler - diğer cevaptaki hackage linki beni aynı bayrağa götürdü. Ardından varsayılanı yapmak için .cabal/config dosyasını güncelledim. Şimdi (OS X'de) "open ~/.cabal/share/doc/$ project - */html/index.html" diyebiliyorum ve tarayıcımda dokümanları açabiliyorum. Bir proje adı için bunu yapmak için bir bash işlevi yazdım veya index.html dosyası yoksa bir hata iletisi yazdırdım. –

7

--haddock bayrak benim için çalışmadı. Ancak --enable-documentation ile --haddock vermedi değiştirilmesi:

cabal install $project --enable-documentation 

Şimdi, onlar --hyperlink-source bayrak çok mutlu olurdum mezgit üzerine zip izin verebilir eğer.