Filed under: iLife, Tips and tricks
Force help to be more helpful
Being the Kool-aid sipping, Apple fanatic that you are, I'm sure you have already updated to the latest versions of iLife and iWork, right? If you have then it's not unlikely for you to be experiencing the same kind of problem that Rob Griffiths over at Macworld is dealing with as well.Following his recent upgrade to the latest (and greatest!) version of iPhoto, Rob noticed some inconsistencies in the way Help was providing him information. Specifically, he had trouble with locating documentation on the new Faces feature when navigating through iPhoto's Help menu and launching the Help application. Rob was able to locate the documents he sought by using Leopard's Spotlight-esque Help-searching feature and querying for "Faces."
During our review of iPhoto '09 we did not come across any issues with the Help documentation. But we here at the TUAW headquarters at the Winter office in Hawaii are too stubborn to read directions. Rob's problem seems to be an old one that has occasionally plagued users through many versions of OS X. He points to another article at Macworld by Chris Breen which covers some tactics for wrangling Help back into line.
The culprit in this whodunit case turns out to be Help's cache file (in the library with the candlestick). According to Rob, "Help relies heavily on cache files to present its information to the user." For reasons unknown, upgrading an application does not necessarily cause the cache files to rebuild. In order to force the system to accomplish this, first quit iPhoto then navigate to the current user's home directory -> Library -> Caches (~/Library/Caches) and locate "com.apple.helpui." Once the cache file is located, drag it into the trash and restart iPhoto. Boom! You now have a working-as-intended iPhoto Help viewer.
While any application's help cache can become obsolete, Rob notes an increase in likelihood for Apple's own applications. Whether you're experiencing problems with an Apple app or not, deleting the cache file is very likely the solution. Have you had any issues with an application's help viewer? If so, which app was it and how did you resolve it? Let us know in the comments!
Get a WordPress.com Blog
![TUAW [Cafepress]](http://www.blogsmithmedia.com/www.tuaw.com/media/tuaw-cafepress-promo.png)


Reader Comments (Page 1 of 1)
Korpil said 2:30PM on 2-10-2009
I ALWAYS have problems with help... and yes, mainly with Apple's own documentation... whether it opens in a blank page, or I type a query which goes on forever, or double clicking simply goes nowhere... so, yes, I rely a lot on cache erasing....
Reply
Shannon said 2:49PM on 2-10-2009
Great tip.
Thanks for the info.
Reply
HandyMac said 2:53PM on 2-10-2009
I find OS X's Help system rather lame and have never used it much, so can't really respond from experience with it; however, this fix has been known since the days of 10.3 (at least), and as I noted at the Macworld article, there's an AppleScript available to make it easy, called Help Viewer Help, available here:
http://shopperturnpike.com/usefulsoftware
Reply
m00z said 3:38PM on 2-10-2009
CLIX http://rixstep.com/4/0/clix/ has some great scripts to clean the caches
Reply
Jesse Vohs said 3:51PM on 2-10-2009
I don't understand why Apple doesn't just create a wiki for their help pages. Make a tutorial on how to update the wiki, and ask users to submit change if they feel something isn't clear. Use the power of crowds, I'm sure there are many users out there that could write better instructions than the technical writers at Apple.
Then just build a synchronization engine to periodically check for updates to the help pages when the machine gets online, it's not like they'd be huge downloads, it's just text.
Reply