Re: Where did the GHC API go?
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#v:filter - 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 marlo...@gmail.com: 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 ___ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
Re: Where did the GHC API go?
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
Re: Where did the GHC API go?
Hi Neil, On Sun, Dec 27, 2009 at 06:24:35PM +, Neil Mitchell wrote: Yes, this is now http://haskell.org/ghc/docs/latest/html/libraries/base-4.2.0.0/Prelude.html#v:filter 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 ___ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
Re: Where did the GHC API go?
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 ___ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
Re: Where did the GHC API go?
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-Simple.html section 4.8.8 links to http://www.haskell.org/ghc/docs/latest/html/libraries/Cabal/Distribution-InstalledPackageInfo.html# %tInstalledPackageInfo http://www.haskell.org/ghc/docs/latest/html/libraries/Cabal/Distribution-License.html#t :License from http://www.haskell.org/ghc/docs/latest/html/users_guide/using-concurrent.html section 4.12 links to http://www.haskell.org/ghc/docs/latest/html/libraries/base/Control-Concurrent.html 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.html 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-Extension.html 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-Concurrent.html section 7.18.2 links to http://www.haskell.org/ghc/docs/latest/html/libraries/stm/Control-Concurrent-STM.html section 7.18.4 links to http://www.haskell.org/ghc/docs/latest/html/libraries/parallel/Control-Parallel.html http://www.haskell.org/ghc/docs/latest/html/libraries/parallel/Control-Parallel-Strategies.html 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-Concurrent.html 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-Concurrent.html 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-ConsoleHandler.html Regards, Malcolm ___ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
Re: Where did the GHC API go?
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 malcolm.wall...@cs.york.ac.uk 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-Simple.html section 4.8.8 links to http://www.haskell.org/ghc/docs/latest/html/libraries/Cabal/Distribution-InstalledPackageInfo.html#%tInstalledPackageInfo http://www.haskell.org/ghc/docs/latest/html/libraries/Cabal/Distribution-License.html#t:License from http://www.haskell.org/ghc/docs/latest/html/users_guide/using-concurrent.html section 4.12 links to http://www.haskell.org/ghc/docs/latest/html/libraries/base/Control-Concurrent.html 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.html 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-Extension.html 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-Concurrent.html section 7.18.2 links to http://www.haskell.org/ghc/docs/latest/html/libraries/stm/Control-Concurrent-STM.html section 7.18.4 links to http://www.haskell.org/ghc/docs/latest/html/libraries/parallel/Control-Parallel.html http://www.haskell.org/ghc/docs/latest/html/libraries/parallel/Control-Parallel-Strategies.html 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-Concurrent.html 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-Concurrent.html 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-ConsoleHandler.html Regards, Malcolm ___ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://www.haskell.org/mailman/listinfo/glasgow-haskell-users ___ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
Re: Where did the GHC API go?
Hi! On Mon, Dec 28, 2009 at 11:04 PM, Neil Mitchell ndmitch...@gmail.com 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 ___ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
Re: Where did the GHC API go?
Hi Ian, Yes, this is now http://haskell.org/ghc/docs/latest/html/libraries/base-4.2.0.0/Prelude.html#v:filter 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 ___ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
Re: Where did the GHC API go?
On Mon, Dec 21, 2009 at 12:38:08PM +, Simon Marlow wrote: On 21/12/2009 00:18, Tom Tobin wrote: On Sun, Dec 20, 2009 at 6:17 PM, Tom Tobinkorp...@korpios.com wrote: On Sun, Dec 20, 2009 at 4:47 PM, Jason Dusekjason.du...@gmail.com 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 ___ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
Re: Where did the GHC API go?
On Wed, Dec 23, 2009 at 09:34:58PM +, 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#v:filter 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 ___ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
Re: Where did the GHC API go?
On Thu, Dec 24, 2009 at 9:15 AM, Ian Lynagh ig...@earth.li 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 ___ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
Re: Where did the GHC API go?
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 ig...@earth.li 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 ___ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
Re: Where did the GHC API go?
Ian Lynagh wrote: On Wed, Dec 23, 2009 at 09:34:58PM +, 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#v:filter 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 ___ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
Re: Where did the GHC API go?
2009/12/24 Ian Lynagh ig...@earth.li 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 ig...@earth.li 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 ___ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
Re: Where did the GHC API go?
On Thu, Dec 24, 2009 at 10:11:55AM -0500, Andrés Sicard-Ramírez wrote: 2009/12/24 Ian Lynagh ig...@earth.li 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 ig...@earth.li 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 ___ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
Re: Where did the GHC API go?
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 marlo...@gmail.com wrote: On 21/12/2009 00:18, Tom Tobin wrote: On Sun, Dec 20, 2009 at 6:17 PM, Tom Tobinkorp...@korpios.com wrote: On Sun, Dec 20, 2009 at 4:47 PM, Jason Dusekjason.du...@gmail.com 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 ___ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
Re: Where did the GHC API go?
On 21/12/2009 00:18, Tom Tobin wrote: On Sun, Dec 20, 2009 at 6:17 PM, Tom Tobinkorp...@korpios.com wrote: On Sun, Dec 20, 2009 at 4:47 PM, Jason Dusekjason.du...@gmail.com 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
Where did the GHC API go?
Maybe I missed an email about this... http://www.haskell.org/ghc/docs/latest/html/libraries/ghc/index.html The link is down. -- Jason Dusek ___ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
Re: Where did the GHC API go?
On Sun, Dec 20, 2009 at 4:47 PM, Jason Dusek jason.du...@gmail.com 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 ___ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
Re: Where did the GHC API go?
On Sun, Dec 20, 2009 at 6:17 PM, Tom Tobin korp...@korpios.com wrote: On Sun, Dec 20, 2009 at 4:47 PM, Jason Dusek jason.du...@gmail.com 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. ___ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
