Skip to Content

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!

Categories

iLife Tips and tricks

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?...
 

Add a Comment

*0 / 3000 Character Maximum

5 Comments

Filter by:
Jesse Vohs

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.

February 10 2009 at 3:44 PM Report abuse rate up rate down Reply
m00z

CLIX http://rixstep.com/4/0/clix/ has some great scripts to clean the caches

February 10 2009 at 3:37 PM Report abuse rate up rate down Reply
HandyMac

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

February 10 2009 at 2:53 PM Report abuse rate up rate down Reply
Shannon

Great tip.

Thanks for the info.

February 10 2009 at 2:48 PM Report abuse rate up rate down Reply
Korpil

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....

February 10 2009 at 2:30 PM Report abuse rate up rate down Reply
Buy an ad here

Hot Apps on TUAW

Tweets

© 2012 AOL Inc. All Rights Reserved.