RE: [Haskell-cafe] Re: Haddock + Hoogle == Javadoc on steroids

2008-09-29 Thread Mitchell, Neil
Hi Simon,

 http://joyful.com/repos/darcs-sm/api-doc is a mashup of 
 haddock, hoogle and hscolour (and darcsweb, darcs-graph - see 
 http://joyful.com/repos).

I can see the Haddock information, but not the Hoogle/HsColour mashup.
I'm using Firefox 3. Am I missing something? How do you get started with
a Hoogle query?

 had time to work on this, currently I hard-code the target in 
 hoogle and munge the haddock output slightly (see recent 
 patch in darcs-unstable).

I believe you emailed me privately with a question about pointing at
haddock documentation from Hoogle. I'm currently a bit out of sync with
emails as I've just moved house, don't yet have internet, and can't
check my gmail account from work. The answer, from what I can remember
of the question, is:

How do I get Hoogle to point at a particular documentation repo?

The answer is to add a line similar to:

@haddock
http://hackage.haskell.org/packages/archive/Cabal/latest/doc/html/

to the Text file you get out of haddock --hoogle.

You can also add an @hackage url, which is treated as the home page of
the package.

Thanks

Neil

==
Please access the attached hyperlink for an important electronic communications 
disclaimer: 

http://www.credit-suisse.com/legal/en/disclaimer_email_ib.html
==

___
Haskell-Cafe mailing list
Haskell-Cafe@haskell.org
http://www.haskell.org/mailman/listinfo/haskell-cafe


Re: [Haskell-cafe] Re: Haddock + Hoogle == Javadoc on steroids

2008-09-29 Thread Sean Leather

 Hi Neil.. my apologies, my nightly cron script clobbered it. Please try
 now, same url: http://joyful.com/repos/darcs-sm/api-doc


It seems the Contents link embeds the outer frame into the right-hand side
inner frame. Otherwise, it looks nice!

Sean
___
Haskell-Cafe mailing list
Haskell-Cafe@haskell.org
http://www.haskell.org/mailman/listinfo/haskell-cafe


Re: [Haskell-cafe] Re: Haddock + Hoogle == Javadoc on steroids

2008-09-29 Thread Neil Mitchell
Hi

 The answer is to add a line similar to:

 @haddock
 http://hackage.haskell.org/packages/archive/Cabal/latest/doc/html/

 to the Text file you get out of haddock --hoogle.

 You can also add an @hackage url, which is treated as the home page of
 the package.

 Aha, I had not detected that at all. Thanks for the tip. Also thanks to you
 and the haddock  hscolour authors for such fine tools.

It's entirely undocumented, and not a great interface - my hope is
that one day cabal will pass some --hoogle-extra flags or something to
haddock, but I've not yet decided how packages should specify where
they live - if you have any suggestions do let me know.

For your example page, its very nice. Perhaps, for the bottom left
Hoogle box, it would be easier if you used the code snipped:

form action='http://haskell.org/hoogle/' method='get'
input name='hoogle' id='hoogle' type='text' value= /
input id='submit' type='submit' value='Search' /
/form

That way the interface should look a bit nicer, as you don't need such
a large amount of space for a search box and you can format it the way
you want.

Thanks

Neil
___
Haskell-Cafe mailing list
Haskell-Cafe@haskell.org
http://www.haskell.org/mailman/listinfo/haskell-cafe