[Haskell-cafe] Hackage Documentation issue

2012-10-12 Thread Jonas Almström Duregård
Hi, Short question: can I or someone else make the Hackage build bot rebuild a package with a new dependency (even though the initial build was successful)? Long question: Does anyone know what would cause the documentation of a successful Hackage build not to appear on the web? Specifically I'm

[Haskell-cafe] Hackage documentation down?

2012-02-23 Thread wren ng thornton
Hello all, I posted a minor update to unix-bytestring a few days ago in order to deal with the Num not implying Eq thing in GHC 7.4, but it looks like the documentation still hasn't been made (nor the built-on field). Are the Hackage builders down intentionally since the recent crash, or

Re: [Haskell-cafe] Package documentation complaints -- and a suggestion

2011-10-30 Thread Malcolm Wallace
The problem isn't social pressure to be stable, it's the ambiguity of what stable means. If Hackage 2 institutes a policy whereby things claiming to be stable are treated better, then stable is likely to become the new experimental. I'd say, rather than rely on social agreement on what

Re: [Haskell-cafe] Package documentation complaints -- and a suggestion

2011-10-29 Thread wren ng thornton
On 10/25/11 3:54 AM, Gregory Collins wrote: On Tue, Oct 25, 2011 at 4:34 AM, wren ng thorntonw...@freegeek.org wrote: I'm not so sure about that exemption. The experimental stability level seems to be the norm on Hackage and often means I use this for real projects, but because I use it for

Re: [Haskell-cafe] Package documentation complaints -- and a suggestion

2011-10-25 Thread Gregory Collins
On Tue, Oct 25, 2011 at 4:34 AM, wren ng thornton w...@freegeek.org wrote: I'm not so sure about that exemption. The experimental stability level seems to be the norm on Hackage and often means I use this for real projects, but because I use it for real projects I'm not quite willing to hammer

Re: [Haskell-cafe] Package documentation complaints -- and a suggestion

2011-10-25 Thread Ivan Lazar Miljenovic
On 25 October 2011 18:54, Gregory Collins g...@gregorycollins.net wrote: On Tue, Oct 25, 2011 at 4:34 AM, wren ng thornton w...@freegeek.org wrote: I'm not so sure about that exemption. The experimental stability level seems to be the norm on Hackage and often means I use this for real

Re: [Haskell-cafe] Package documentation complaints -- and a suggestion

2011-10-25 Thread Ketil Malde
Ivan Lazar Miljenovic ivan.miljeno...@gmail.com writes: Right, but first we need to define what all those terms _mean_... and it's no good saying your package is stable if you change the API in a large-scale fashion every release. I think there are better criteria to use, like: - do exported

Re: [Haskell-cafe] Package documentation complaints -- and a suggestion

2011-10-25 Thread Max Rabkin
On Tue, Oct 25, 2011 at 11:17, Ketil Malde ke...@malde.org wrote: Ivan Lazar Miljenovic ivan.miljeno...@gmail.com writes: Right, but first we need to define what all those terms _mean_... and it's no good saying your package is stable if you change the API in a large-scale fashion every

Re: [Haskell-cafe] Package documentation complaints -- and a suggestion

2011-10-25 Thread Ivan Lazar Miljenovic
On 25 October 2011 20:17, Ketil Malde ke...@malde.org wrote: Ivan Lazar Miljenovic ivan.miljeno...@gmail.com writes: Right, but first we need to define what all those terms _mean_... and it's no good saying your package is stable if you change the API in a large-scale fashion every release.

Re: [Haskell-cafe] Package documentation complaints -- and a suggestion

2011-10-25 Thread Evan Laforge
On Tue, Oct 25, 2011 at 2:17 AM, Ketil Malde ke...@malde.org wrote: Ivan Lazar Miljenovic ivan.miljeno...@gmail.com writes: Right, but first we need to define what all those terms _mean_... and it's no good saying your package is stable if you change the API in a large-scale fashion every

Re: [Haskell-cafe] Package documentation complaints -- and a suggestion

2011-10-25 Thread Ketil Malde
Max Rabkin max.rab...@gmail.com writes: This is useful information, but to call it stability is not only misleading, but it also prevents the package from using that field to indicate whether or not it is stable! Oh, right - I'm not much interested in the stability of a package. What I want

Re: [Haskell-cafe] Package documentation complaints -- and a suggestion

2011-10-24 Thread Antti-Juhani Kaijanaho
On Mon, Oct 10, 2011 at 09:06:01AM +0100, Paterson, Ross wrote: The distinction between synopsis and description is borrowed from the Debian package format: http://www.debian.org/doc/debian-policy/ch-binary.html#s-descriptions The two fields are aimed at different audiences. Not in

Re: [Haskell-cafe] Package documentation complaints -- and a suggestion

2011-10-24 Thread Ryan Newton
Good point. On the other hand, nobody points package authors to the Debian documentation (and Debian also has review for newly uploaded packages, as far as I know). Re: review process -- Perhaps there would be a use for a review process somewhere between haskell-platform and the unwashed

Re: [Haskell-cafe] Package documentation complaints -- and a suggestion

2011-10-24 Thread Gregory Collins
On Mon, Oct 24, 2011 at 12:55 PM, Ryan Newton rrnew...@gmail.com wrote: Good point. On the other hand, nobody points package authors to the Debian documentation (and Debian also has review for newly uploaded packages, as far as I know). Re: review process -- Perhaps there would be a use for a

Re: [Haskell-cafe] Package documentation complaints -- and a suggestion

2011-10-24 Thread wren ng thornton
On 10/24/11 12:34 PM, Gregory Collins wrote: Examples could include: Your package lacks a description, more than X% of your modules lack toplevel module comments, fewer than Y% of your toplevel exports have haddock comments, etc... Packages with stability=experimental would probably be exempt

Re: [Haskell-cafe] Package documentation complaints -- and a suggestion

2011-10-24 Thread Ivan Lazar Miljenovic
On 25 October 2011 13:34, wren ng thornton w...@freegeek.org wrote: Before dealing with automatic documentation requirements, perhaps it'd be better to develop a standard consensus on the terms used in the stability field and actively advocating for people to adopt it, as was done with the

Re: [Haskell-cafe] Package documentation complaints -- and a suggestion

2011-10-10 Thread Max Rabkin
On Mon, Oct 10, 2011 at 03:17, John Millikin jmilli...@gmail.com wrote: The package summary is Type-safe ADT-database mapping library., which gives some idea about what it does. Whence my suggestion to show this on the package's page. Perhaps I shouldn't have hidden that at the bottom -- I

Re: [Haskell-cafe] Package documentation complaints -- and a suggestion

2011-10-10 Thread Paterson, Ross
Max Rabkin writes: But I also have a concrete suggestion for Hackage: include the package synopsis on the package's page. The distinction between synopsis and description can be confusing, and sometimes it seems to violate DRY to have the same info in both. You may have missed the header on

Re: [Haskell-cafe] Package documentation complaints -- and a suggestion

2011-10-10 Thread Max Rabkin
On Mon, Oct 10, 2011 at 10:06, Paterson, Ross r.pater...@city.ac.uk wrote: Max Rabkin writes: But I also have a concrete suggestion for Hackage: include the package synopsis on the package's page. The distinction between synopsis and description can be confusing, and sometimes it seems to

[Haskell-cafe] Package documentation complaints -- and a suggestion

2011-10-09 Thread Max Rabkin
Hi all Following a link from the Yesod book, I arrived at [1], curious to find out what groundhog was. Once there, I learned... nothing: This library provides just the general interface and helper functions. You must use a specific backend in order to make this useful. [1]

Re: [Haskell-cafe] Package documentation complaints -- and a suggestion

2011-10-09 Thread John Millikin
The package summary is Type-safe ADT-database mapping library., which gives some idea about what it does. In my experience, any package that starts its source files with {-# LANGUAGE GADTs, TypeFamilies, ExistentialQuantification, StandaloneDeriving, TypeSynonymInstances,

Re: [Haskell-cafe] YesodAuth documentation

2011-06-14 Thread cheater cheater
I am surprised out of the whole list no one has stormed down on Nikita for wanting to store passwords as plain text. Nikita: never store passwords in plain text. Ever. D. On Mon, Jun 13, 2011 at 09:34, Никита Тимофеев ndtimof...@gmail.com wrote: Does exist some simple examples using yesod

Re: [Haskell-cafe] YesodAuth documentation

2011-06-14 Thread Kevin Jardine
When I review the original post I see only a question: Does passwords stored in a database in an unencrypted form? rather than a request. So I'm not sure that was the intent. I'm amazed that anyone (Sony!!!?) would store unencrypted passwords of course. Kevin On Jun 14, 10:21 am, cheater

Re: [Haskell-cafe] YesodAuth documentation

2011-06-14 Thread Michael Snoyman
2011/6/14 Michael Steele mikesteel...@gmail.com: Actually, that's not entirely accurate. The Yesod scaffolding tool generates a site that uses mime-mail and sendmail, but there's nothing inherent in yesod-auth requiring either. My apologies for adding to the confusion. I see now that

Re: [Haskell-cafe] YesodAuth documentation

2011-06-14 Thread cheater cheater
Ah, I see how you could interpret what he wrote the way you describe. If that's what Nikita has meant, then that's all fine. Hope there's no harm in reminding this basic truth - better be safe than sorry! :) D. On Tue, Jun 14, 2011 at 15:00, Kevin Jardine kevinjard...@gmail.com wrote: When I

[Haskell-cafe] YesodAuth documentation

2011-06-13 Thread Никита Тимофеев
Does exist some simple examples using yesod authentication except code of Haskellers site? Does exist some examples using YesodAuthEmail? For example, can i use third-party mail server instead of Sendmail for YesodAuthEmail? Can i disable registration confirmation? Does passwords stored in a

[Haskell-cafe] YesodAuth documentation

2011-06-13 Thread Тимофеев Никита Дмитриевич
Does exist some simple examples using yesod authentication except code of Haskellers site? Does exist some examples using YesodAuthEmail? For example, can i use third-party mail server instead of Sendmail for YesodAuthEmail? Can i disable registration confirmation? Does passwords stored in a

Re: [Haskell-cafe] YesodAuth documentation

2011-06-13 Thread Michael Steele
Does exist some simple examples using yesod authentication except code of Haskellers site? Does exist some examples using YesodAuthEmail? Another example is Orangeroster [1]. For example, can i use third-party mail server instead of Sendmail for YesodAuthEmail? No. Email handling is done

Re: [Haskell-cafe] YesodAuth documentation

2011-06-13 Thread Michael Snoyman
2011/6/13 Michael Steele mikesteel...@gmail.com: Does exist some simple examples using yesod authentication except code of Haskellers site? Does exist some examples using YesodAuthEmail? Another example is Orangeroster [1]. For example, can i use  third-party mail server instead of Sendmail

Re: [Haskell-cafe] YesodAuth documentation

2011-06-13 Thread Michael Steele
Actually, that's not entirely accurate. The Yesod scaffolding tool generates a site that uses mime-mail and sendmail, but there's nothing inherent in yesod-auth requiring either. My apologies for adding to the confusion. I see now that Yesod.Auth.Email handles database interactions, generates

Re: [Haskell-cafe] Haddock: Documentation of instances with un-documentable type arguments

2010-09-04 Thread Alexander McPhail
Hi Is there a similar ticket for GHC to not export instances in the case that other instances are explicitly specified? module Foo ( Foo(Monad) ) instance Monad Foo where ... instance MonadState (Foo Bar) where ... i.e. the monad instance gets exported but

Re: [Haskell-cafe] Haddock: Documentation of instances with un-documentable type arguments

2010-09-04 Thread Ivan Lazar Miljenovic
On 4 September 2010 19:01, Alexander McPhail haskell.vivian.mcph...@gmail.com wrote: Hi Is there a similar ticket for GHC to not export instances in the case that other instances are explicitly specified? module Foo (    Foo(Monad)   ) instance Monad Foo

Re: [Haskell-cafe] Missing documentation in Haskell Platform on Windows

2010-09-03 Thread Andrew Coppin
Don Stewart wrote: andrewcoppin: Almost every release of GHC that I can remember has had the links for the mtl package broken. (The Control.Monad.XXX modules are mostly from mtl. But, for example, Control.Monad.Fix is from base. I bet you'll find it works just fine.) Well

Re: [Haskell-cafe] Missing documentation in Haskell Platform on Windows

2010-09-02 Thread Andrew Coppin
Arnaud Bailly wrote: Hello, I installed (succesfully) HAskell Platform 2010.2 on windows and have a small but annoying issue: Some links in HTML documentation lead to broken links. I did not investigate all the links, but I have seen that all doc under Control.Monad.XXX is missing. What am I

Re: [Haskell-cafe] Missing documentation in Haskell Platform on Windows

2010-09-02 Thread Don Stewart
andrewcoppin: Arnaud Bailly wrote: Hello, I installed (succesfully) HAskell Platform 2010.2 on windows and have a small but annoying issue: Some links in HTML documentation lead to broken links. I did not investigate all the links, but I have seen that all doc under Control.Monad.XXX

Re: [Haskell-cafe] Missing documentation in Haskell Platform on Windows

2010-09-02 Thread Daniel Fischer
On Thursday 02 September 2010 19:34:07, Don Stewart wrote: andrewcoppin: Arnaud Bailly wrote: Hello, I installed (succesfully) HAskell Platform 2010.2 on windows and have a small but annoying issue: Some links in HTML documentation lead to broken links. I did not investigate all the

Re: [Haskell-cafe] Missing documentation in Haskell Platform on Windows

2010-09-02 Thread Daniel Fischer
On Thursday 02 September 2010 20:05:12, Daniel Fischer wrote: Probably not. I'm on Linux and build my GHCs from source. There's no directory mtl-1.1.0.2 in ~/share/doc/ghc/html/libraries although it's linked to from the package index built with the compiler. (Hadn't noticed before because I

Re: [Haskell-cafe] Missing documentation in Haskell Platform on Windows

2010-09-02 Thread Bas van Dijk
On Thu, Sep 2, 2010 at 8:20 PM, Daniel Fischer daniel.is.fisc...@web.de wrote: On Thursday 02 September 2010 20:05:12, Daniel Fischer wrote: Probably not. I'm on Linux and build my GHCs from source. There's no directory mtl-1.1.0.2 in ~/share/doc/ghc/html/libraries although it's linked to

[Haskell-cafe] Missing documentation in Haskell Platform on Windows

2010-08-31 Thread Arnaud Bailly
Hello, I installed (succesfully) HAskell Platform 2010.2 on windows and have a small but annoying issue: Some links in HTML documentation lead to broken links. I did not investigate all the links, but I have seen that all doc under Control.Monad.XXX is missing. What am I doing wrong ? Arnaud

Re: [Haskell-cafe] Missing documentation in Haskell Platform on Windows

2010-08-31 Thread Ivan Lazar Miljenovic
On 1 September 2010 14:25, Arnaud Bailly arnaud.oq...@gmail.com wrote: Hello, I installed (succesfully) HAskell Platform 2010.2 on windows and have a small but annoying issue: Some links in HTML documentation lead to broken links. I did not investigate all the links, but I have seen that all

[Haskell-cafe] Haddock: Documentation of instances with un-documentable type arguments

2010-08-25 Thread Alexander McPhail
Hi, Here, http://hackage.haskell.org/packages/archive/graphviz/2999.10.0.1/doc/html/Data-GraphViz-Commands.html#t%3AGraphvizCanvas, there is an example of the internal implementation leaking. I was taught to separate interface from implementation. For example, header versus c/cc/cpp files. The

Re: [Haskell-cafe] Haddock: Documentation of instances with un-documentable type arguments

2010-08-25 Thread David Waern
2010/8/25 Alexander McPhail haskell.vivian.mcph...@gmail.com: Perhaps Haddock could exclude class instance reporting when it cannot find a documentable link to a parameter? Yes, it should. BTW, we have a trac ticket for it: http://trac.haskell.org/haddock/ticket/37 You can add yourself to

[Haskell-cafe] Re: Documentation for OpenGL?

2010-08-13 Thread Eitan Goldshtrom
Woops, nevermind. I WAS looking in the wrong place. I should've known =P. Sorry for the unnecessary request. -Eitan PS. For anyone interested all of the documentation is in Graphics.Rendering.OpenGL.GL.PerFragment on hackage ___ Haskell-Cafe mailing

Re: [Haskell-cafe] On documentation

2010-08-12 Thread David Waern
2010/7/23 Ivan Miljenovic ivan.miljeno...@gmail.com: On 22 July 2010 18:33, David Waern david.wa...@gmail.com wrote: [snip] We currently only support concrete examples (i.e. unit tests), but the plan is to add support for QuickCheck properties. Would you have some kind of inbuilt time

Re: [Haskell-cafe] On documentation

2010-07-22 Thread David Waern
2010/7/21 Richard O'Keefe o...@cs.otago.ac.nz: One of the really nice ideas in the R statistics system is that documentation pages can contain executable examples, and when you wrap up a package for distribution, the system checks that the examples run as advertised. The next version of

Re: [Haskell-cafe] On documentation

2010-07-22 Thread wren ng thornton
David Waern wrote: 2010/7/21 Richard O'Keefe o...@cs.otago.ac.nz: One of the really nice ideas in the R statistics system is that documentation pages can contain executable examples, and when you wrap up a package for distribution, the system checks that the examples run as advertised. The

Re: [Haskell-cafe] On documentation

2010-07-22 Thread Andrew Coppin
Alexander Solla wrote: After all, the source is always structured in more-or-less the same way. Fragments of text with opaque -- unless/until you understand them -- combinators join two distinct concepts/types into functions. A chain of functions (potentially at various levels of

Re: [Haskell-cafe] On documentation

2010-07-22 Thread Ivan Miljenovic
On 22 July 2010 18:33, David Waern david.wa...@gmail.com wrote: [snip] We currently only support concrete examples (i.e. unit tests), but the plan is to add support for QuickCheck properties. Would you have some kind of inbuilt time limit (similar to what mueval has) for very long/complex QC

Re: [Haskell-cafe] On documentation

2010-07-21 Thread Andrew Coppin
Ivan Miljenovic wrote: * When writing the code, it's obvious what it does; as such you may think any documentation you may offer is trivial (down the track, however...). * The author is familiar with a library; as such it may not be obvious what extra documentation could be needed. This is

Re: [Haskell-cafe] On documentation

2010-07-21 Thread Alexander Solla
On Jul 20, 2010, at 10:28 PM, Richard O'Keefe wrote: What I don't see is HOW DO I USE THIS STUFF? I think tutorials are the best way to do that (i.e., example normal forms for the computations the library intends to expose). Perl's package archive (the cpan) traditionally uses a

[Haskell-cafe] On documentation

2010-07-20 Thread Richard O'Keefe
I'm giving some lectures this week about how to _read_ programs, and I've had some things to say about JavaDoc and wondered whether to show some examples of Haddock. I took a certain library that has been mentioned recently in this mailing list. (I shall not identify it. The author deserves

Re: [Haskell-cafe] On documentation

2010-07-20 Thread Ivan Miljenovic
On 21 July 2010 15:28, Richard O'Keefe o...@cs.otago.ac.nz wrote: I'm giving some lectures this week about how to _read_ programs, and I've had some things to say about JavaDoc and wondered whether to show some examples of Haddock. I took a certain library that has been mentioned recently in

Re: [Haskell-cafe] creating documentation links failed with cabal install --haddock-options=--hyperlink-source. is this a bug?

2009-11-16 Thread Duncan Coutts
On Sat, 2009-10-31 at 10:45 -0500, Thomas Hartman wrote: cabal haddock -–hyperlink-source installs documentation with links to source code, which also be on by defualt. cabal install –haddock-options=–hyperlink source does not install hyperlinked source. This is an instance of the lack

[Haskell-cafe] creating documentation links failed with cabal install --haddock-options=--hyperlink-source. is this a bug?

2009-10-31 Thread Thomas Hartman
-source DID generate an error in the output: target `hyperlink-source' is not a module name or a source file also, blogged about this here: http://blog.patch-tag.com/2009/10/23/cabal-install-a-package-with-documentation ___ Haskell-Cafe mailing list

Re: [Haskell-cafe] Re: Documentation (was: ANN: text 0.5, a major revision of the Unicode text library)

2009-10-19 Thread Kyle Murphy
On a somewhat related note, I think the Haskell documentation in general is rather patchy and hard to follow for most things. Part of that I think is because of the confusion between the different forms of documentation. In general as a programmer I expect to find three kinds of documentation

Re: [Haskell-cafe] Re: Documentation (was: ANN: text 0.5, a major revision of the Unicode text library)

2009-10-19 Thread Tom Tobin
On Mon, Oct 19, 2009 at 4:32 PM, Kyle Murphy orc...@gmail.com wrote: If they have to spend three hours trying to track down some obscure research paper that's referenced in your documentation a half dozen times in as many functions, you're not providing enough detail and assuming too great a

[Haskell-cafe] Re: Documentation (was: ANN: text 0.5, a major revision of the Unicode text library)

2009-10-12 Thread John Lato
From: Derek Elkins derek.a.elk...@gmail.com On Sun, Oct 11, 2009 at 8:55 AM, Iain Barnett iainsp...@gmail.com wrote: On 11 Oct 2009, at 13:58, John Lato wrote: For anyone writing introductions to generic programming, take this as a plea from Haskellers everywhere.  If one of the RWH

[Haskell-cafe] Installing documentation with cabal

2009-08-18 Thread Maciej Piechotka
Is it possible to automatically (or non-automatically) install documentation when installing package with cabal-install? Regards signature.asc Description: This is a digitally signed message part ___ Haskell-Cafe mailing list Haskell-Cafe@haskell.org

Re: [Haskell-cafe] Installing documentation with cabal

2009-08-18 Thread Krzysztof Skrzętnicki
It is. From command line: cabal install package --enable-documentation or add line documentation: True to .cabal/config or equivalent. Best regards Krzysztof Skrzętnicki On Tue, Aug 18, 2009 at 22:29, Maciej Piechotka uzytkown...@gmail.comwrote: Is it possible to automatically (or

Re: [Haskell-cafe] Installing documentation with cabal

2009-08-18 Thread Maciej Piechotka
On Tue, 2009-08-18 at 22:37 +0200, Krzysztof Skrzętnicki wrote: It is. From command line: cabal install package --enable-documentation or add line documentation: True to .cabal/config or equivalent. Best regards Krzysztof Skrzętnicki Thanks a lot. Regards signature.asc

[Haskell-cafe] Re: Documentation design

2009-07-06 Thread Peter Hercek
I like your proposal. Few notes below. On Sun, 05 Jul 2009 23:45:31 -0400, Isaac Dupree wrote: My dream situation: both haddock-pages and hscolour-pages would be super-hyperlinked and super-readable. For example, haddock would list all a module's definitions, not just its exports. In

[Haskell-cafe] Re: Documentation on hackage

2009-06-15 Thread Maurí­cio
who needs this kind of documentation? http://hackage.haskell.org/packages/archive/tfp/0.2/doc/html/Types-Data-Num-Decimal-Literals.html The code below is shown under 'Source' links in that documentation. I don't understand it, but it seems everything is generated automatically. What should the

Re: [Haskell-cafe] Re: Documentation on hackage

2009-06-15 Thread Claus Reinke
who needs this kind of documentation? http://hackage.haskell.org/packages/archive/tfp/0.2/doc/html/Types-Data-Num-Decimal-Literals.html The code below is shown under 'Source' links in that documentation. I don't understand it, but it seems everything is generated automatically. What should the

[Haskell-cafe] Re: Documentation bug -- building ghc from darcs sources

2009-06-12 Thread Simon Marlow
On 12/06/2009 08:00, Michael Vanier wrote: I've been trying to build ghc head from the darcs repo using these instructions: http://hackage.haskell.org/trac/ghc/wiki/Building/GettingTheSources Unfortunately, when I do ./darcs-all --extra get as described under Getting more packages it fails

[Haskell-cafe] Slow documentation generation on Hackage

2009-06-08 Thread Niemeijer, R.A.
Hello everyone. Last night I uploaded my first Hackage library with documentation (StrictBench). I learned that it takes somewhere between 2 and 8 hours for the link to the documentation to become active. This is confusing for first-time package authors (I went to #haskell to ask what I had

Re: [Haskell-cafe] Slow documentation generation on Hackage

2009-06-08 Thread Brandon S. Allbery KF8NH
On Jun 8, 2009, at 04:10 , Niemeijer, R.A. wrote: Hence I wanted to ask if this is a bug or if there is a good technical or social reason for it, and whether there is any way around it. Auto-running haddock on upload strikes me as a good way to open hackage.haskell.org to a denial of

Re: [Haskell-cafe] Slow documentation generation on Hackage

2009-06-08 Thread Brandon S. Allbery KF8NH
On Jun 8, 2009, at 04:36 , Brandon S. Allbery KF8NH wrote: On Jun 8, 2009, at 04:10 , Niemeijer, R.A. wrote: Hence I wanted to ask if this is a bug or if there is a good technical or social reason for it, and whether there is any way around it. Auto-running haddock on upload strikes me as

RE: [Haskell-cafe] Slow documentation generation on Hackage

2009-06-08 Thread Niemeijer, R.A.
. Allbery KF8NH [mailto:allb...@ece.cmu.edu] Sent: maandag 8 juni 2009 10:41 To: Brandon S. Allbery KF8NH Cc: Niemeijer, R.A.; haskell-cafe@haskell.org Subject: Re: [Haskell-cafe] Slow documentation generation on Hackage On Jun 8, 2009, at 04:36 , Brandon S. Allbery KF8NH wrote: On Jun 8, 2009

Re: [Haskell-cafe] Slow documentation generation on Hackage

2009-06-08 Thread Ketil Malde
Niemeijer, R.A. r.a.niemei...@tue.nl writes: If that is the main concern, would the following not work? [...] Result: immediate documentation for every contributor with good intentions Or simply, on upload, generate the doc directory with a temporary page saying that documentation will

Re: [Haskell-cafe] Slow documentation generation on Hackage

2009-06-08 Thread Thomas ten Cate
On Mon, Jun 8, 2009 at 11:05, Niemeijer, R.A.r.a.niemei...@tue.nl wrote: which, face it, is going to be all of them; I doubt Haskell is popular enough yet to be the target of DoS attacks Second that. I think this is a good case in which some security should be traded in for usability. And even

Re: [Haskell-cafe] Slow documentation generation on Hackage

2009-06-08 Thread wren ng thornton
Thomas ten Cate wrote: Niemeijer, R.A. wrote: which, face it, is going to be all of them; I doubt Haskell is popular enough yet to be the target of DoS attacks Second that. I think this is a good case in which some security should be traded in for usability. Those who would trade security

Re: [Haskell-cafe] Slow documentation generation on Hackage

2009-06-08 Thread Duncan Coutts
On Mon, 2009-06-08 at 11:24 +0200, Ketil Malde wrote: Niemeijer, R.A. r.a.niemei...@tue.nl writes: If that is the main concern, would the following not work? [...] Result: immediate documentation for every contributor with good intentions Having the server generate docs itself

Re: [Haskell-cafe] Slow documentation generation on Hackage

2009-06-08 Thread Ross Paterson
On Mon, Jun 08, 2009 at 04:36:14AM -0400, Brandon S. Allbery KF8NH wrote: Additionally, I *think* haddock is run as part of the automated build tests, which (again) happen on a regular schedule instead of being triggered by uploads to avoid potential denial of service attacks. That's

[Haskell-cafe] alex documentation

2009-03-19 Thread j . romildo
Hello. I need the documentation of alex (a lexical analyser generator in Haskell) in PDF format, so I used the Makefile in the doc directory of the distribution of alex to get it. But unfortunatly, the documentation includes some code listings that are too wide and does not fit in the default

[Haskell-cafe] Missing documentation for Haddock

2009-02-27 Thread Colin Paul Adams
On http://haskell.org/haddock/doc/html/module-attributes.html the not-home attribute is missing (it's documentation is present, but the attribute itself is not named). -- Colin Adams Preston Lancashire ___ Haskell-Cafe mailing list

Re: [Haskell-cafe] Missing documentation for Haddock

2009-02-27 Thread David Waern
2009/2/27 Colin Paul Adams co...@colina.demon.co.uk: On http://haskell.org/haddock/doc/html/module-attributes.html the not-home attribute is missing (it's documentation is present, but the attribute itself is not named). Thanks for the report. By the way, the Haddock trac page is at:

Re: [Haskell-cafe] IntMap documentation error

2009-02-24 Thread Duncan Coutts
On Mon, 2009-02-23 at 17:22 -0600, Louis Wasserman wrote: In the documentation for Data.IntMap updateMin, a piece of example code both communicates incorrect intuition, and fails to even compile. updateMin :: (a - a) - IntMap a - IntMap a updateMin (\ _ - Nothing) (fromList [(5,a),

[Haskell-cafe] IntMap documentation error

2009-02-23 Thread Louis Wasserman
In the documentation for Data.IntMap updateMin, a piece of example code both communicates incorrect intuition, and fails to even compile. updateMin :: (a - a) - IntMap a - IntMap a updateMin (\ _ - Nothing) (fromList [(5,a), (3,b)]) -- code straight from the docs interactive:1:49: Couldn't

[Haskell-cafe] about documentation improvements

2009-01-16 Thread Manlio Perillo
About latest thread on better naming and documentation improvement, why don't organize an interactive session where: 1) normal users tell what's wrong about a package/module documentation 2) the package/module author/maintainer fix the documentation in real time, so that users can review it

Re: [Haskell-cafe] about documentation improvements

2009-01-16 Thread Duncan Coutts
On Fri, 2009-01-16 at 15:12 +0100, Manlio Perillo wrote: About latest thread on better naming and documentation improvement, why don't organize an interactive session where: 1) normal users tell what's wrong about a package/module documentation 2) the package/module author/maintainer fix

Re: [Haskell-cafe] about documentation improvements

2009-01-16 Thread Ross Paterson
On Fri, Jan 16, 2009 at 03:12:21PM +0100, Manlio Perillo wrote: About latest thread on better naming and documentation improvement, why don't organize an interactive session where: 1) normal users tell what's wrong about a package/module documentation 2) the package/module author/maintainer

Re: [Haskell-cafe] about documentation improvements

2009-01-16 Thread Gwern Branwen
-BEGIN PGP SIGNED MESSAGE- Hash: SHA512 On Fri, Jan 16, 2009 at 9:29 AM, Duncan Coutts wrote: On Fri, 2009-01-16 at 15:12 +0100, Manlio Perillo wrote: About latest thread on better naming and documentation improvement, why don't organize an interactive session where: 1) normal users

Re: [Haskell-cafe] about documentation improvements

2009-01-16 Thread Manlio Perillo
Duncan Coutts ha scritto: On Fri, 2009-01-16 at 15:12 +0100, Manlio Perillo wrote: About latest thread on better naming and documentation improvement, why don't organize an interactive session where: 1) normal users tell what's wrong about a package/module documentation 2) the package/module

Re: [Haskell-cafe] FFI documentation?

2008-11-09 Thread Magnus Therning
Nun Aurbiz wrote: Where do I find the documentation for the FFI for GHC? I've read the FFI report, the GHC user guide and scoured haskell.org but they all gloss over what commands you actually need to give GHC and how to give them. foreign import blah blah just gives me undefined references.

[Haskell-cafe] FFI documentation?

2008-11-08 Thread Nun Aurbiz
Where do I find the documentation for the FFI for GHC? I've read the FFI report, the GHC user guide and scoured haskell.org but they all gloss over what commands you actually need to give GHC and how to give them. foreign import blah blah just gives me undefined references.

Re: [Haskell-cafe] FFI documentation?

2008-11-08 Thread Luke Palmer
2008/11/8 Nun Aurbiz [EMAIL PROTECTED]: Where do I find the documentation for the FFI for GHC? I've read the FFI report, the GHC user guide and scoured haskell.org but they all gloss over what commands you actually need to give GHC and how to give them. foreign import blah blah just gives me

[Haskell-cafe] building documentation

2008-08-28 Thread Thomas Hartman
I'm on ubuntu, ghc 6.8.3. I built this using the Generic i386 Linux build at http://www.haskell.org/ghc/download_ghc_683.html How do I build local documentation that matches what I see at http://www.haskell.org/ghc/docs/latest/html/libraries/ -- and am I correct that this is 6.8.3 right now?

[Haskell-cafe] Haddock Documentation for Yhc Web Service available online

2008-03-05 Thread Dimitry Golubovsky
Hi, I have regenerated Haddock documentation for Haskell modules included into the Yhc Web Service. http://www.golubovsky.org:5984/_utils/yhcws/index.html Thanks. -- Dimitry Golubovsky Anywhere on the Web ___ Haskell-Cafe mailing list

Re: [Haskell-cafe] Haddock documentation of Data.Array.* is confusing

2008-02-20 Thread Bulat Ziganshin
Hello Alfonso, Tuesday, February 12, 2008, 11:32:20 PM, you wrote: Excuse me for the subject, but IMHO is absolutely true. Anyhow, the of course, you are right, but for practical goals i may suggest just to read module sources instead of reading [had]docs. seeing the implementation is much

Re: [Haskell-cafe] Haddock documentation of Data.Array.* is confusing

2008-02-20 Thread Alfonso Acosta
On Wed, Feb 20, 2008 at 10:17 PM, Bulat Ziganshin [EMAIL PROTECTED] wrote: Hello Alfonso, Tuesday, February 12, 2008, 11:32:20 PM, you wrote: Excuse me for the subject, but IMHO is absolutely true. Anyhow, the of course, you are right, but for practical goals i may suggest just to

[Haskell-cafe] array documentation is missing

2007-12-14 Thread Thomas Hartman
While trying to make Regex.TDFA 0.91 install on 6.8.2 I got [10 of 21] Compiling Text.Regex.TDFA.RunMutState ( Text/Regex/TDFA/RunMutState.\ hs, dist\build/Text/Regex/TDFA/RunMutState.o ) Text/Regex/TDFA/RunMutState.hs:601:9: Constructor `STUArray' should have 4 arguments, but has been

Re: [Haskell-cafe] array documentation is missing

2007-12-14 Thread Jed Brown
On 14 Dec 2007, [EMAIL PROTECTED] wrote: but I got stuck fixing it because the array documentation isn't there http://www.haskell.org/ghc/docs/latest/html/libraries/haskell98/Array.html Try the hierarchical library docs:

Re: [Haskell-cafe] Tiny documentation request

2007-09-11 Thread Jules Bean
Andrew Coppin wrote: OTOH, I recently discovered that GHCi has the ability to show you what's defined in a given module without me having to wait 40 seconds for Firefox to start... Shame you can't scroll its output. (And still no help if you're not sure of the module name.) !!! Run ghci in

Re: [Haskell-cafe] Tiny documentation request

2007-09-11 Thread Adrian Hey
Jules Bean wrote: Andrew Coppin wrote: OTOH, I recently discovered that GHCi has the ability to show you what's defined in a given module without me having to wait 40 seconds for Firefox to start... Shame you can't scroll its output. (And still no help if you're not sure of the module name.)

Re: [Haskell-cafe] Tiny documentation request

2007-09-10 Thread Sven Panne
On Sunday 09 September 2007 18:41, Andrew Coppin wrote: [...] Well, if I could collapse it with a single click, it would be much easier to scroll past it and get to the thing I'm looking for. I didn't say remove it, just give me the option to hide it. ;-) OK, that shouldn't be too hard to

Re: [Haskell-cafe] Tiny documentation request

2007-09-10 Thread manu
Neil Mitchell wrotes : Replicating actual tables with CSS is a nightmare - you shouldn't use table's for lots of things, I agree but there are sometimes when it really is the best option. Which isn't the case here ! Nested lists would easily do the trick... Fixing up the CSS and still

Re: [Haskell-cafe] Tiny documentation request

2007-09-10 Thread Brent Yorgey
Just bookmark: http://haskell.org/hoogle It's not perfect, but it probably solves lots of your problems. And if you use Firefox, you can even install Hoogle as one of the search engines in the upper-right search box. Nice and fast! -Brent ___

Re: [Haskell-cafe] Tiny documentation request

2007-09-10 Thread Andrew Coppin
Sven Panne wrote: On Sunday 09 September 2007 18:41, Andrew Coppin wrote: Oh goodie... So it's there to keep the machines happy? No, it's there to keep *me* happy when I'm looking for a module. ;-) Well, there's over 200 modules relating to graph theory alone. (Modules that I

Re: [Haskell-cafe] Tiny documentation request

2007-09-10 Thread Andrew Coppin
Brent Yorgey wrote: And if you use Firefox, you can even install Hoogle as one of the search engines in the upper-right search box. Nice and fast! I've never really understood what the benefit of this is... I mean, Google make the Google toolbar, but what's the point? Why not just click on

Re: [Haskell-cafe] Tiny documentation request

2007-09-10 Thread Ian Lynagh
On Sun, Sep 09, 2007 at 05:38:03PM +0200, Sven Panne wrote: On Sunday 09 September 2007 16:40, Andrew Coppin wrote: I have the following page bookmarked: http://haskell.org/ghc/docs/latest/html/libraries/ I'd like to ask 2 things. 1. Would it be possible to make the *huge* list of

  1   2   >