Ronald,
Just to be clear, here are the steps to reproduce this bug:
1. Open any Xcode Documentation page 2. Right-click in the document, select "Open Page in Browser" 3. Assure your OS that you really want to open this document. 4. Wait for document to open in your browser, e.g. Safari. 5. Look for PDF link in top-right corner.6. Click the link.
Result: HTTP 404 "File not found"
Link is a local document with file:// URI. See my original message for a full link.
At the risk of being redundant, I don't see why Apple would ship documentation with broken links.
Is there a way to view the PDF inside Xcode? I don't see any PDF links or any menu/contextual menu items for viewing them.
Doug
On Sep 22, 2011, at 3:51 PM, Ronald Hayden wrote: The docs are inside an Xcode-specific package and require special effort to view otherwise, so we don't try and cover or document the other viewing cases. If you are going inside a specific app package to use content in another app, there will likely be various incompatibilities.
- Ron
On Sep 22, 2011, at 2:04 PM, Doug Hill < email@hidden> wrote: Ronald,
Thanks for your reply.
Indeed, my original question was w.r.t. viewing Xcode documentation in my browser (I'm using Firefox not Safari but still...)
Without getting into the debate whether PDF documentation is desirable (although it is) or whether we should have the option to download the PDF doc sets separately (although we should), it would have helped me a lot if the PDF links were removed if the documents those links point to are not there. Particularly as this is a known issue. Or maybe clue us into this fact by including a note in the Xcode release notes:"Don't bother clicking the PDF links in Xcode documentation - They don't work." I've spent a lot of time trying to figure out Xcode documentation, doc set updating, and puzzling over broken links thinking I've done something wrong.
Thanks.
Doug Hill Schematic Labs, Inc. On Sep 22, 2011, at 11:15 AM, Ronald Hayden wrote: Addendum: From your description it sounds like you might be viewing the local docs in Safari? If so, then it's expected that the PDF links won't work.
The local docs are optimized for viewing in Xcode, which has special functionality for handling things like the PDFs, so we don't have to take up a large amount of disk space duplicating the documentation in another format (we got many complaints about download and storage size when we included the PDFs locally).
-- Ron On Sep 22, 2011, at 11:01 AM, Ronald Hayden wrote: The PDFs aren't stored locally, but if you are online then they should be accessible.
Please file a bug and provide screenshots of the Documentation Preferences window and the doc window itself, so we can look into it.
-- Ron On Sep 22, 2011, at 12:18 AM, Doug Hill wrote: Ronald,
Thanks for the tip. I went ahead and checked the installed doc sets again. As best as I can tell the documentation is installed. I checked the help page, and it says I have the documentation locally, and they are up to date. From the "Setting Documentation Preferences" help document:
" If your documentation is up-to-date, the Get button is not displayed."
And indeed, in my Documentation Settings which display the available doc sets, there are no Get buttons for iOS or Mac OS X 10.6 documentation. There is still a Get button for Mac legacy documentation, which I haven't downloaded.
I certainly have all of the HTML versions of the documentation as these all load in Xcode and my browser. But the PDF button in the browser pages always fails because those documents are just not on my computer (I checked the documentation directory, did a Spotlight search).
It would be great to know where the PDF's went. Maybe I should put up "Missing" posters.
Doug Hill Schematic Labs, Inc. http://www.soundtracking.com/
On Sep 20, 2011, at 9:19 PM, Ronald Hayden wrote: Sounds like you don't have the doc set downloaded -- if you did, there'd be no PDF link there (it would be in the 'Related Items' topdown in the upper left). Try going to Preferences->Documentation and making sure you download the desired doc set.
-- Ron On Sep 20, 2011, at 12:56 PM, Doug Hill wrote: I wanted to see if there was any info about why the PDF links in Xcode documentation are broken. If I open a documentation page in my browser, then click the PDF button in the top-right corner, I get a 404.
For example:
This happens with every page I've tried.
Is there any way to get the PDF documentation or are these documentation pages all broken? I did a search on the xcode-users mailing list archive about this issue but didn't find anything conclusive.
Also, just in case this helps, here is the info about my docset from the Documentation window:.
"iOS 4.3 Library (v. 38.103) API reference and conceptual documentation for iOS 4.3. Copyright © 2011 Apple Inc. All rights reserved. Identifier: com.apple.adc.documentation.AppleiOS4_3.iOSLibrary
Xcode 4.0.2 Build 4A2002a
Thanks.
Doug Hill Schematic Labs, Inc.
|