Is it possible to update hackage base-4.16.0.0 Data.Foldable HTML?
The Data.Foldable documentation included with the GHC 9.0 release used a newish haddock syntax `someFunction'` rather than the more traditional 'someFunction''. It turned out that the former was not supported by the version of haddock that builds the "hackage" docs. Thus, in https://hackage.haskell.org/package/base-4.15.0.0/docs/Data-Foldable.html#g:... various references to `foldl'` and `foldMap'` are rendered as "foldl`" and "foldMap`" and rather unfortunately hyperlink to the "bare" 'foldl' and 'foldMap' respectively. The non-portable haddock syntax was replaced in a later MR, but the online documentation has not been regenerated since. Is there a mechanism to have the documentation regenerated to read as intended? Either by running a more recent haddock (that supports the new `someFunction'` syntax) or by using a patched Data.Foldable that differs from the 9.0.1 release only in addressing documentation nits? I can build and provide a replacement pre-compiled HTML file if that's the simplest way forward... -- Viktor.
I believe this is possible, and that we can upload haddocks manually just
like any other package, but I'm not sure.
Cc'ing Ben.
On Mon, Sep 13, 2021, 12:08 Viktor Dukhovni
The Data.Foldable documentation included with the GHC 9.0 release used a newish haddock syntax `someFunction'` rather than the more traditional 'someFunction''. It turned out that the former was not supported by the version of haddock that builds the "hackage" docs. Thus, in
https://hackage.haskell.org/package/base-4.15.0.0/docs/Data-Foldable.html#g:...
various references to `foldl'` and `foldMap'` are rendered as "foldl`" and "foldMap`" and rather unfortunately hyperlink to the "bare" 'foldl' and 'foldMap' respectively.
The non-portable haddock syntax was replaced in a later MR, but the online documentation has not been regenerated since.
Is there a mechanism to have the documentation regenerated to read as intended? Either by running a more recent haddock (that supports the new `someFunction'` syntax) or by using a patched Data.Foldable that differs from the 9.0.1 release only in addressing documentation nits?
I can build and provide a replacement pre-compiled HTML file if that's the simplest way forward...
-- Viktor.
_______________________________________________ Libraries mailing list Libraries@haskell.org http://mail.haskell.org/cgi-bin/mailman/listinfo/libraries
participants (2)
-
chessai -
Viktor Dukhovni