• Open Menu Close Menu
  • Apple
  • Shopping Bag
  • Apple
  • Mac
  • iPad
  • iPhone
  • Watch
  • TV
  • Music
  • Support
  • Search apple.com
  • Shopping Bag

Lists

Open Menu Close Menu
  • Terms and Conditions
  • Lists hosted on this site
  • Email the Postmaster
  • Tips for posting to public mailing lists
Re: Documentation
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Documentation


  • Subject: Re: Documentation
  • From: Allison Newman <email@hidden>
  • Date: Mon, 4 Aug 2008 19:50:57 +0200

Yup, I should have made that clearer in the initial post.

Basically what I was trying to get at is what happens when keyword searches fail to turn up the info that you need. I generally try searching in much the same way as you (API search, list archives, Google - though I use non-site limited search there), except I don't use AppKiDo (sorry!) I also try flipping through the index of the Hillegass book to see if there's maybe a chapter in there talking about what I want, that I may have forgotten about.

In this particular case for example, my searches failed, because I was searching on "screensaver" rather than "sleep". This happens quite often when you are coming from a non-OSX environment, such as Windows, Linux, Java, whatever - different platforms use different terminology for the same thing - you say 'bonjour' and I say 'zeroconf' type of thing. Or, as was my case this time, I was searching for "screensaver" because it was my screensaver that was getting in the way on my own computer, not the sleep function. I got fixated on the wrong word. I learned an awful lot about ScreenSaverView, ScreenSaverDefaults, and how to write my own screensaver, but absolutely nothing about how to turn off the system screensaver.

So, to reword my question, does anyone have a trick/useful reference document that helps them out when keyword searches aren't getting them the result they want?

Le 4 août 08 à 17:51, Andy Lee a écrit :

First rule of problem reporting: tell us what you tried. Since you didn't, here's my approach to searching in general for topics where I'm not sure where to start:

* full-text search in the Xcode documentation window
* search of the list archives via cocoabuilder.com
* Google search targeted at developer.apple.com, e.g., "prevent sleep site:developer.apple.com"
* AppKiDo (my app), which is actually my first choice if I think I can guess a substring that will be in a relevant API, but sometimes I can't. You can also do substring API search in Xcode.


--Andy


_______________________________________________

Cocoa-dev mailing list (email@hidden)

Please do not post admin requests or moderator comments to the list.
Contact the moderators at cocoa-dev-admins(at)lists.apple.com

Help/Unsubscribe/Update your Subscription:
This email sent to email@hidden


  • Follow-Ups:
    • Re: Documentation
      • From: Andy Lee <email@hidden>
References: 
 >Documentation (From: Allison Newman <email@hidden>)
 >Re: Documentation (From: Andy Lee <email@hidden>)

  • Prev by Date: Message Framework and Garbage Collection
  • Next by Date: Re: Irritating Problem with NSString Method and File Paths
  • Previous by thread: Re: Documentation
  • Next by thread: Re: Documentation
  • Index(es):
    • Date
    • Thread