Where did the GHC API go?

On Sun, Dec 20, 2009 at 4:47 PM, Jason Dusek wrote:

...
Maybe I missed an email about this...

http://www.haskell.org/ghc/docs/latest/html/libraries/ghc/index.html

The link is down.

The link from the GHC Documentation page points here, which works for me:

http://www.haskell.org/ghc/docs/latest/html/libraries/index.html

Sorry, read that too quickly — you're asking about the API. That is indeed a dead link for me.

Simon Marlow

21 Dec 21 Dec

7:38 a.m.

On 21/12/2009 00:18, Tom Tobin wrote:

...

On Sun, Dec 20, 2009 at 6:17 PM, Tom Tobin wrote:

...
On Sun, Dec 20, 2009 at 4:47 PM, Jason Dusek wrote:

...
Maybe I missed an email about this...

http://www.haskell.org/ghc/docs/latest/html/libraries/ghc/index.html

The link is down.

The link from the GHC Documentation page points here, which works for me:

http://www.haskell.org/ghc/docs/latest/html/libraries/index.html

Sorry, read that too quickly — you're asking about the API. That is indeed a dead link for me.

Ian, is this something to do with the recent redirects that were added? Cheers, Simon

Note that other links have gone broken recently: http://haskell.org/ghc/docs/latest/html/libraries/base/Prelude.html#v:filter These links are relied upon by Hoogle and Google. I suspect they have the same cause. Thanks, Neil On Mon, Dec 21, 2009 at 12:38 PM, Simon Marlow wrote:

...

On 21/12/2009 00:18, Tom Tobin wrote:

...
On Sun, Dec 20, 2009 at 6:17 PM, Tom Tobin wrote:

...
On Sun, Dec 20, 2009 at 4:47 PM, Jason Dusek wrote:

...
Maybe I missed an email about this...

http://www.haskell.org/ghc/docs/latest/html/libraries/ghc/index.html

The link is down.

The link from the GHC Documentation page points here, which works for me:

http://www.haskell.org/ghc/docs/latest/html/libraries/index.html

Sorry, read that too quickly — you're asking about the API. That is indeed a dead link for me.

Ian, is this something to do with the recent redirects that were added?

Cheers, Simon _______________________________________________ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://www.haskell.org/mailman/listinfo/glasgow-haskell-users

Ian Lynagh

24 Dec 24 Dec

9:18 a.m.

On Wed, Dec 23, 2009 at 09:34:58PM +0000, Neil Mitchell wrote:

...

Note that other links have gone broken recently:

http://haskell.org/ghc/docs/latest/html/libraries/base/Prelude.html#v:filter

These links are relied upon by Hoogle and Google. I suspect they have the same cause.

Yes, this is now http://haskell.org/ghc/docs/latest/html/libraries/base-4.2.0.0/Prelude.html#... ~~~~~~~~~~~~ I'd suggest that Hoogle shold probably use its own copy of the docs, so that it stays in sync with them. Also, you probably want to index the set of libraries that come with the Haskell Platform, rather than just those that come with GHC. Thanks Ian

Isaac Dupree

10:08 a.m.

Ian Lynagh wrote:

...

On Wed, Dec 23, 2009 at 09:34:58PM +0000, Neil Mitchell wrote:

...
Note that other links have gone broken recently:

http://haskell.org/ghc/docs/latest/html/libraries/base/Prelude.html#v:filter

These links are relied upon by Hoogle and Google. I suspect they have the same cause.

Yes, this is now

http://haskell.org/ghc/docs/latest/html/libraries/base-4.2.0.0/Prelude.html#... ~~~~~~~~~~~~

I'm tempted to say: the older URL was better, because I could bookmark it once and go look anytime at a fairly up-to-date ("latest" a la the URL) version of base. But GHC includes multiple versions of base currently, so this wish doesn't even make as much sense as it could... -Isaac

Neil Mitchell

27 Dec 27 Dec

1:24 p.m.

Hi Ian,

...

Yes, this is now

http://haskell.org/ghc/docs/latest/html/libraries/base-4.2.0.0/Prelude.html#... ~~~~~~~~~~~~

I'd suggest that Hoogle shold probably use its own copy of the docs, so that it stays in sync with them. Also, you probably want to index the set of libraries that come with the Haskell Platform, rather than just those that come with GHC.

Too late. We had a stable link, I used it, Google used it, blog posts were written that linked to it, I've emailed my wife links to it, I've put them in Word documents, I've posted them on internal intranets. You can't create a link, put content behind it, then move the content - it just breaks the whole web. I can fix Hoogle, but I can't fix the rest of the web... I recommend putting in a permanent redirect from where the old docs used to be to base 4.0, and then never moving it forward. Or perhaps symlinking latest to always the latest version. Either way, I think breaking a huge set of links is a really bad idea. I also think it's a bad idea for Hoogle to link off to different documentation from the rest of Haskell, it's just not a good idea to fragment the Hoogle universe from the rest of the docs. Thanks, Neil

Malcolm Wallace

28 Dec 28 Dec

6:06 a.m.

...

Too late. We had a stable link, I used it, Google used it, blog posts were written that linked to it, I've emailed my wife links to it, I've put them in Word documents, I've posted them on internal intranets. You can't create a link, put content behind it, then move the content - it just breaks the whole web.

Neil Mitchell

5:04 p.m.

I've now updated Hoogle to point at the new links. I still think the old link's should be restored (perhaps as a permanent redirect code?), but at least it doesn't break Hoogle now. Thanks, Neil On Mon, Dec 28, 2009 at 11:06 AM, Malcolm Wallace wrote:

...

...
Too late. We had a stable link, I used it, Google used it, blog posts were written that linked to it, I've emailed my wife links to it, I've put them in Word documents, I've posted them on internal intranets. You can't create a link, put content behind it, then move the content - it just breaks the whole web.

And incidentally, the _ghc_docs_ themselves continue to use these stable links to library docs, most of which are currently broken.

All of the following links from documentation for ghc-6.12.1 give a 404 Not Found. (I do not claim the list is exhaustive.)

from http://www.haskell.org/ghc/docs/latest/html/users_guide/packages.html section 4.8 links to

http://www.haskell.org/ghc/docs/latest/html/libraries/Cabal/Distribution-Sim... section 4.8.8 links to

http://www.haskell.org/ghc/docs/latest/html/libraries/Cabal/Distribution-Ins...

http://www.haskell.org/ghc/docs/latest/html/libraries/Cabal/Distribution-Lic...

from http://www.haskell.org/ghc/docs/latest/html/users_guide/using-concurrent.htm... section 4.12 links to

http://www.haskell.org/ghc/docs/latest/html/libraries/base/Control-Concurren...

from http://www.haskell.org/ghc/docs/latest/html/users_guide/primitives.html section 7.2 links to

http://www.haskell.org/ghc/docs/latest/html/libraries/ghc-prim/GHC-Prim.html

from http://www.haskell.org/ghc/docs/latest/html/users_guide/syntax-extns.html section 7.3.10 links to http://www.haskell.org/ghc/docs/latest/html/libraries/base/GHC-Exts.html

from http://www.haskell.org/ghc/docs/latest/html/users_guide/arrow-notation.html section 7.10 links twice to

http://www.haskell.org/ghc/docs/latest/html/libraries/base/Control-Arrow.htm...

from http://www.haskell.org/ghc/docs/latest/html/users_guide/pragmas.html section 7.13.1 links to

http://www.haskell.org/ghc/docs/latest/html/libraries/Cabal/Language-Haskell...

from http://www.haskell.org/ghc/docs/latest/html/users_guide/special-ids.html section 7.15 links to

http://www.haskell.org/ghc/docs/latest/html/libraries/ghc-prim/GHC-Prim.html

from http://www.haskell.org/ghc/docs/latest/html/users_guide/lang-parallel.html section 7.18.1 links to

http://www.haskell.org/ghc/docs/latest/html/libraries/base/Control-Concurren... section 7.18.2 links to

http://www.haskell.org/ghc/docs/latest/html/libraries/stm/Control-Concurrent... section 7.18.4 links to

http://www.haskell.org/ghc/docs/latest/html/libraries/parallel/Control-Paral...

http://www.haskell.org/ghc/docs/latest/html/libraries/parallel/Control-Paral...

from http://www.haskell.org/ghc/docs/latest/html/users_guide/ffi.html section 8 incorrectly links to

http://www.haskell.org/ghc/docs/latest/html/libraries/base/Control-Concurren... where the real link ought to be http://www.haskell.org/ghc/docs/latest/html/libraries/base/Foreign.html

from http://www.haskell.org/ghc/docs/latest/html/users_guide/ffi-ghc.html section 8.2.4.2 links to

http://www.haskell.org/ghc/docs/latest/html/libraries/base/Control-Concurren...

from http://www.haskell.org/ghc/docs/latest/html/users_guide/ghci-windows.html section 11.2 links to

http://www.haskell.org/ghc/docs/latest/html/libraries/base/GHC-ConsoleHandle...

Regards, Malcolm

_______________________________________________ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://www.haskell.org/mailman/listinfo/glasgow-haskell-users

Mitar

5:55 p.m.

Hi! On Mon, Dec 28, 2009 at 11:04 PM, Neil Mitchell wrote:

...

I've now updated Hoogle to point at the new links. I still think the old link's should be restored (perhaps as a permanent redirect code?), but at least it doesn't break Hoogle now.

+1 I all the time get to 404 errors nowadays while trying to access documentation. Mitar

Simon Marlow

29 Dec 29 Dec

5:01 p.m.

On 28/12/09 11:06, Malcolm Wallace wrote:

...

...
Too late. We had a stable link, I used it, Google used it, blog posts were written that linked to it, I've emailed my wife links to it, I've put them in Word documents, I've posted them on internal intranets. You can't create a link, put content behind it, then move the content - it just breaks the whole web.

And incidentally, the _ghc_docs_ themselves continue to use these stable links to library docs, most of which are currently broken.

All of the following links from documentation for ghc-6.12.1 give a 404 Not Found. (I do not claim the list is exhaustive.)

This is a good point. These links are relative (unless I'm mistaken). they aren't pointing to the "latest" docs specifically. It would be onerous to have to update these links every time we bump a library version number. Ian - I think we should use the symlinks you suggested in your other message. I agree that linking to "latest" is/was a bad idea. The fact remains that it's done all over the place, and we can't fix that now. We should probably stop Google from indexing those pages, as that is probably the source of most of the links. Cheers, Simon

Ian Lynagh

6:43 a.m.

Hi Neil, On Sun, Dec 27, 2009 at 06:24:35PM +0000, Neil Mitchell wrote:

...

...
Yes, this is now

http://haskell.org/ghc/docs/latest/html/libraries/base-4.2.0.0/Prelude.html#... ~~~~~~~~~~~~

I'd suggest that Hoogle shold probably use its own copy of the docs, so that it stays in sync with them. Also, you probably want to index the set of libraries that come with the Haskell Platform, rather than just those that come with GHC.

Too late. We had a stable link, I used it, Google used it, blog posts were written that linked to it, I've emailed my wife links to it, I've put them in Word documents, I've posted them on internal intranets. You can't create a link, put content behind it, then move the content - it just breaks the whole web.

The .../latest/... URLs have always been unstable, by definition. Functions might move between modules, modules might appear and disappear, entire libraries might be added or removed, the format of internal anchor names might change, etc. I don't think it makes sense for hoogle to point to them. We could add redirects base/* -> base-4.2.0.0/* etc now, but we'd have to keep it up-to-date after each release. We could probably make a small shell script to do so, so maybe that would be the best plan. On the other hand, we might be better off just removing the latest/ link. People looking for library docs would be better served by a Haskell Platform doc page anyway. We'd need to work out what to do with the links in the GHC docs, though.

...

I also think it's a bad idea for Hoogle to link off to different documentation from the rest of Haskell, it's just not a good idea to fragment the Hoogle universe from the rest of the docs.

You could also use e.g. the http://haskell.org/ghc/docs/6.12.1/html/libraries/index.html docs, which are stable. Thanks Ian

Simon Marlow

30 Dec 30 Dec

9:38 a.m.

On 29/12/09 11:43, Ian Lynagh wrote:

...

You could also use e.g. the http://haskell.org/ghc/docs/6.12.1/html/libraries/index.html docs, which are stable.

I've added symlinks for now. Cheers, Simon

Neil Mitchell

4 Jan 4 Jan

3:15 p.m.

Hi, As a suggestion to stop this issue repeating, why not have the latest URL be an automatic and visible forward to the stable and guaranteed URL? (I can't remember the HTTP code, but I think it's permanent redirect) That way people are less likely to see these "unstable" URL's in their web browser, copy them, and have them end up all over the place. I think Google will also avoid indexing them at the latest URL. As it happens, I've put in another timebomb into Hoogle by linking to http://haskell.org/ghc/docs/latest/html/libraries/base-4.2.0.0/Prelude.html#... - the very URL Ian said the docs had moved to (but is again unstable and not guaranteed in the long term). Having the URL redirection would have avoided that mistake. (I'll fix Hoogle as well though) Thanks, Neil 2009/12/30 Simon Marlow :

...

On 29/12/09 11:43, Ian Lynagh wrote:

...
You could also use e.g. the http://haskell.org/ghc/docs/6.12.1/html/libraries/index.html docs, which are stable.

I've added symlinks for now.

Cheers, Simon _______________________________________________ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://www.haskell.org/mailman/listinfo/glasgow-haskell-users

Ian Lynagh

24 Dec 24 Dec

9:15 a.m.

On Mon, Dec 21, 2009 at 12:38:08PM +0000, Simon Marlow wrote:

...

On 21/12/2009 00:18, Tom Tobin wrote:

...
On Sun, Dec 20, 2009 at 6:17 PM, Tom Tobin wrote:

...
On Sun, Dec 20, 2009 at 4:47 PM, Jason Dusek wrote:

...
Maybe I missed an email about this...

http://www.haskell.org/ghc/docs/latest/html/libraries/ghc/index.html

The link is down.

The link from the GHC Documentation page points here, which works for me:

http://www.haskell.org/ghc/docs/latest/html/libraries/index.html

Sorry, read that too quickly — you're asking about the API. That is indeed a dead link for me.

Ian, is this something to do with the recent redirects that were added?

It's fallout from #3532 (put library docs in versioned directories so that we can have multiple versions installed). I've fixed the online 6.12.1 docs, and filed #3785 to remind myself to fix it properly for 6.12.2. Thanks Ian

Andrés Sicard-Ramírez

9:57 a.m.

On Thu, Dec 24, 2009 at 9:15 AM, Ian Lynagh wrote:

...

I've fixed the online 6.12.1 docs,

The link is down for me: http://www.haskell.org/ghc/docs/6.12.1/html/libraries/ghc/index.html -- Andrés

Ian Lynagh

10:06 a.m.

On Thu, Dec 24, 2009 at 09:57:58AM -0500, Andrés Sicard-Ramírez wrote:

...

On Thu, Dec 24, 2009 at 9:15 AM, Ian Lynagh wrote:

...
I've fixed the online 6.12.1 docs,

The link is down for me:

http://www.haskell.org/ghc/docs/6.12.1/html/libraries/ghc/index.html

Which page is linking to there? Thanks Ian

Andrés Sicard-Ramírez

10:11 a.m.

2009/12/24 Ian Lynagh

...

On Thu, Dec 24, 2009 at 09:57:58AM -0500, Andrés Sicard-Ramírez wrote:

...
On Thu, Dec 24, 2009 at 9:15 AM, Ian Lynagh wrote:

...
I've fixed the online 6.12.1 docs,

The link is down for me:

http://www.haskell.org/ghc/docs/6.12.1/html/libraries/ghc/index.html

Which page is linking to there?

http://www.haskell.org/ghc/docs/6.12.1/html/ -- Andrés

Ian Lynagh

10:23 a.m.

On Thu, Dec 24, 2009 at 10:11:55AM -0500, Andrés Sicard-Ramírez wrote:

...

2009/12/24 Ian Lynagh

...
On Thu, Dec 24, 2009 at 09:57:58AM -0500, Andrés Sicard-Ramírez wrote:

...
On Thu, Dec 24, 2009 at 9:15 AM, Ian Lynagh wrote:

...
I've fixed the online 6.12.1 docs,

The link is down for me:

http://www.haskell.org/ghc/docs/6.12.1/html/libraries/ghc/index.html

Which page is linking to there?

http://www.haskell.org/ghc/docs/6.12.1/html/

Thanks, fixed. Thanks Ian

5615

Age (days ago)

5630

Last active (days ago)

List overview

Download

19 comments

9 participants

participants (9)

Andrés Sicard-Ramírez
Ian Lynagh
Isaac Dupree
Jason Dusek
Malcolm Wallace
Mitar
Neil Mitchell
Simon Marlow
Tom Tobin

Where did the GHC API go?

Tom Tobin

Tom Tobin

tags

participants (9)