On 24/07/15 10:03, Alberto G. Corona wrote:

I know for sure that haddock in the future will have live examples in the style of the School of Haskell

Is it going to send email too? [0] ;-) [0] https://en.wikipedia.org/wiki/Jamie_Zawinski#Zawinski.27s_law_of_software_en...

2015-07-22 23:43 GMT+02:00 Matthew Pickering mailto:matthewtpickering@gmail.com>:

The curious can see an example of this new hyperlinked source here[1].

Great work Łukasz and Mateusz!

[1]: https://hackage.haskell.org/package/ghc-exactprint-0.3/docs/src/Language.Has...

On Wed, Jul 22, 2015 at 11:17 PM, Mateusz Kowalczyk mailto:fuuzetsu@fuuzetsu.co.uk> wrote: > Hi, > > We're glad to announce Haddock 2.16.1. It is mostly a bugfix release: I > inline the changelog at the bottom. It should work fine with 7.10.x GHC > family. The packages are already on Hackage: haddock for the executable, > haddock-api for the guts and use from Haskell and haddock-library which > is the comment parser. > > It should also be shipping with GHC 7.10.2. > > I think two things are worth mentioning before: > > * The pending mathjax PR[1] is going to be included in future release of > Haddock. As it is likely to break the interface file version, I am > putting it off a bit to bundle with other possibly interface-breaking > changes. > > * Our GSOC student has successfully completed first part of his > project[2]. It involves native source code highlighting and perhaps more > excitingly, source hyperlinking: you should now be able to click on > identifiers to be taken to their definitions. This change is not in > 2.16.1 as it is rather recent so we erred on the side of safety when > picking what to release with GHC 7.10.2. You can try it by building > current Haddock master, should work with 7.10.x family. > > As usual, if you want to contribute, please do so on GitHub. We're also > on IRC under #haddock. > > Thanks! > > Changes in version 2.16.1 > > * Don't default to type constructors for out-of-scope names (#253 and > #375) > > * Fix Hoogle display of constructors (#361) > > * Fully qualify names in Hoogle instances output (#263) > > * Output method documentation in Hoogle backend (#259) > > * Don't print instance safety information in Hoogle (#168) > > * Expand response files in arguments (#285) > > * Build the main executable with -threaded (#399) > > * Use SrcSpan of declarations for inferred type sigs (#207) > > * Fix cross-module instance locations (#383) > > * Fix alignment of Source link for instances in Firefox (#384) > > [1]: https://github.com/haskell/haddock/pull/397 > [2]: https://github.com/haskell/haddock/pull/410 > > -- > Mateusz K. > _______________________________________________ > Libraries mailing list > Libraries@haskell.org mailto:Libraries@haskell.org > http://mail.haskell.org/cgi-bin/mailman/listinfo/libraries _______________________________________________ Haskell-Cafe mailing list Haskell-Cafe@haskell.org mailto:Haskell-Cafe@haskell.org http://mail.haskell.org/cgi-bin/mailman/listinfo/haskell-cafe

-- Alberto.

___________________________________________________________ This email has been scanned by MessageLabs' Email Security System on behalf of the University of Brighton. For more information see http://www.brighton.ac.uk/is/spam/ ___________________________________________________________

_______________________________________________ Haskell-Cafe mailing list Haskell-Cafe@haskell.org http://mail.haskell.org/cgi-bin/mailman/listinfo/haskell-cafe

-- Dr Jim Burton Senior Lecturer in Computing School of Computing, Engineering and Mathematics University of Brighton ___________________________________________________________ This email has been scanned by MessageLabs' Email Security System on behalf of the University of Brighton. For more information see http://www.brighton.ac.uk/is/spam/ ___________________________________________________________

On Fri, Jul 24, 2015 at 10:24 PM, Tomas Carnecky wrote:

Will hackage rebuild all existing documentation or only when I upload a new version?

IIRC, it will only build a package when its documentation is not present.

If not automatically, can I manually tell hackage to rebuild the docs?

Go to the package page, and click the "edit package information" link at the bottom. There should be an option to clear and rebuild the docs.

On Wed, Jul 22, 2015 at 11:43 PM Matthew Pickering wrote:

...

The curious can see an example of this new hyperlinked source here[1].

Great work Łukasz and Mateusz!

[1]: https://hackage.haskell.org/package/ghc-exactprint-0.3/docs/src/Language.Has...

On Wed, Jul 22, 2015 at 11:17 PM, Mateusz Kowalczyk wrote:

...

Hi,

We're glad to announce Haddock 2.16.1. It is mostly a bugfix release: I inline the changelog at the bottom. It should work fine with 7.10.x GHC family. The packages are already on Hackage: haddock for the executable, haddock-api for the guts and use from Haskell and haddock-library which is the comment parser.

It should also be shipping with GHC 7.10.2.

I think two things are worth mentioning before:

* The pending mathjax PR[1] is going to be included in future release of Haddock. As it is likely to break the interface file version, I am putting it off a bit to bundle with other possibly interface-breaking changes.

* Our GSOC student has successfully completed first part of his project[2]. It involves native source code highlighting and perhaps more excitingly, source hyperlinking: you should now be able to click on identifiers to be taken to their definitions. This change is not in 2.16.1 as it is rather recent so we erred on the side of safety when picking what to release with GHC 7.10.2. You can try it by building current Haddock master, should work with 7.10.x family.

As usual, if you want to contribute, please do so on GitHub. We're also on IRC under #haddock.

Thanks!

Changes in version 2.16.1

* Don't default to type constructors for out-of-scope names (#253 and #375)

* Fix Hoogle display of constructors (#361)

* Fully qualify names in Hoogle instances output (#263)

* Output method documentation in Hoogle backend (#259)

* Don't print instance safety information in Hoogle (#168)

* Expand response files in arguments (#285)

* Build the main executable with -threaded (#399)

* Use SrcSpan of declarations for inferred type sigs (#207)

* Fix cross-module instance locations (#383)

* Fix alignment of Source link for instances in Firefox (#384)

[1]: https://github.com/haskell/haddock/pull/397 [2]: https://github.com/haskell/haddock/pull/410

-- Mateusz K. _______________________________________________ Libraries mailing list Libraries@haskell.org http://mail.haskell.org/cgi-bin/mailman/listinfo/libraries

---

Haskell-Cafe mailing list Haskell-Cafe@haskell.org http://mail.haskell.org/cgi-bin/mailman/listinfo/haskell-cafe

_______________________________________________ Haskell-Cafe mailing list Haskell-Cafe@haskell.org http://mail.haskell.org/cgi-bin/mailman/listinfo/haskell-cafe

-- Chris Wong (https://lambda.xyz) "Humans find such fascinating ways to waste their time." -- Steven Universe