This is such a simple thing, and I call this a major oversight on the part of the software vendor: I kept getting errors when trying to access the user manual or tutorials from within Finale PrintMusic 2006, getting errors that read something like “Could not open PMTOC.pdf”. I found the file after a quick search via Spotlight on my machine and it launched into Preview as this is the default Mac OS X handler for PDF. I got a table of contents, but it was only that. None of the links worked and it was essentially useless. I then noticed that the entire documentation was broken out into separate files. Linking to other local files apparently isn’t supported in Preview, or it doesn’t use the same protocol as Adobe Reader. Would have been better to make one PDF document, where anchors are supported in both Reader and Preview.
I hate Adobe Reader (and when the hell did they start calling it “Reader” instead of “Acrobat Reader”), but I suspected that this wasn’t going to work otherwise. There was no readme file to suggest that Acrobat was a requirement, so I’m guessing at this point. I grudgingly went and downloaded the Acrobat Reader from the Adobe site and installed it, and I’d like to take a moment to lament on Acrobat Reader’s strange installer: You download a download utility and it downloads another installer. Geeks will say “WTF? OK, whatever…” Non-geeks will just wonder what happened and why they still can’t open PDFs. Just make one installer, or one binary app that can be dragged to one’s hard drive.
And now everything works fine, except I have an extra PDF-reading program that I hoped I would never need.
Documentation has always been a tough subject. We have seen the demise of printed manuals. Electronic equivalents have been formatted to PDF, HTML, Flash, and so on, and sent to browsers, PDF readers, operating system help programs, or displayed within the programs own constructs. Vendors often will switch the tools they use, and wildly, between software version releases. It’s nutty how many ways it can exist, and I don’t know of any solution to this madness or even if there is one. My favorite method is the style that is used by PHP, complete and updated frequently as it lives online, with printer-friendly formatting and downloadable archives, and a number of freely-available tools that make it easy to use including Dashboard and Konfabulator Widgets.