[Haskell-cafe] lost the ability to provide haddocks for hackage
mikolaj at well-typed.com
Sat Jul 17 08:05:44 UTC 2021
Nobody offered a workaround here and I can't find any (recent) related
ticket, so perhaps open a feature request at the cabal bug tracker?
On Fri, Jul 16, 2021 at 10:34 AM Olaf Klinke <olf at aatal-apotheke.de> wrote:
> Dear Cafe,
> it seems I lost the ability to provide documentation for my hackage packages. While it is known that hackage sometimes fails to build documentation, the upload page  provides a guide to build and upload documentation. Stack does not have this ability yet  but it has the convenient option --no-haddock-deps that I can use as last resort when a dependency fails to build its Haddocks. I'd rather present documentation with broken links than no documentation at all. Cabal does not seem to provide such an option, while adding --keep-going and/or --enable-per-component to the suggested cabal command in  still aborts when one dependency fails to build.
> Is there something I've missed? If there is a way to build hackage-documentation in presence of haddock errors in dependencies, please someone update  and . Can  be used to circumvent my problem? Perhaps add a guide to tweak the links generated by stack haddock to be hackage-compatible, as suggested in ?
> Strangely, the dependency package my cabal v2-haddock command fails on does have documentation on hackage. Would it be possible to pull these docs from hackage and use as a drop-in replacement?
>  https://hackage.haskell.org/upload
>  https://github.com/commercialhaskell/stack/issues/737
>  https://cabal.readthedocs.io/en/3.4/cabal-commands.html#cabal-v2-haddock
>  http://neilmitchell.blogspot.co.uk/2014/10/fixing-haddock-docs-on-hackage.html
> Haskell-Cafe mailing list
> To (un)subscribe, modify options or view archives go to:
> Only members subscribed via the mailman list are allowed to post.
More information about the Haskell-Cafe