Tuesday, May 3, 2016

Broken Apple Man Page Links

Dr. Drang (tweet):

Yesterday, I discovered that Apple had changed the URLs of all its online man pages. Without, I should add, creating redirects so old links would continue to work. This broke all the man page links I had here at ANIAT and undoubtedly broke links across the internet.


Most of the URL is the same, but the “mac” part is gone, and the whole library has been moved to the “legacy” subdirectory, which is kind of ominous. I suppose there could be another copy of the library outside the “legacy” subdirectory, but I haven’t found it, and so far neither has Google.

Nick Heer:

Adding a redirect from the prior URL to the new one is old-hat basic stuff. I’d be shocked about this if I didn’t run into an issue earlier this year where I discovered that Apple News links don’t automatically redirect from the http:// version to the https:// version, and simply display a 404 error page instead.

Apple has the same problem for regular documentation links.

Ole Begemann:

Linking to Apple’s site in a blog post is uncomfortable. Most links will be broken or the content will be totally different in a year.

Update (2016-05-03): Jack Lawrence:

I’ve spoken with the team & the redirects were added last weekend. Please test & let me know if you’re still having issues.

I just tested a bunch of links from my old blog posts, and the redirects all worked.

Comments RSS · Twitter

Leave a Comment