Re: "Hello World" examples for Apple Help?
Re: "Hello World" examples for Apple Help?
- Subject: Re: "Hello World" examples for Apple Help?
- From: Bill Cheeseman <email@hidden>
- Date: Tue, 22 Feb 2011 19:07:31 -0500
On Feb 22, 2011, at 5:10 PM, Todd Heberlein wrote:
> Some of the paths and directory layouts mentioned in the "Apple Help Programming Guide" (for example, for Mail) are not correct with the current Mail layout (although the example for Mail does look consistent with the current Safari directory structure). I'm thinking that the current Safari is still using the "old way" while Mail and Terminal are using the "new way", but I can't find any examples for the "new way".
The Apple Help Programming Guide is an amalgam of the old Leopard-and-older and new Snow-Leopard Help systems, and for that reason it is hopelessly confusing to anybody who doesn't already have a good understanding of what is going on. It desperately needs to be re-written, but that surely isn't going to happen any time soon.
The "Add Apple Help" chapter in my book, "Cocoa Recipes for Mac OS X: The Vermont Recipes (Second Edition, 2010)" gives a detailed explanation of how to write a Help book using the new Snow Leopard technique, with sample code. But you can't use this technique unless your application runs exclusively on Mac OS X 10.6 Snow Leopard or newer. If your application also supports Mac OS X 10.5 Leopard or older, you have to use the old Leopard-and-older technique, and the current edition of Apple's Programming Guide kind of mooshes that up with newer techniques in a very unhelpful way. Apple's own applications use both techniques, depending on how old they are. (My book does contain information about how to use both techniques in the same application, if you really want to do that. It isn't too hard.)
You can find my book at <http://www.peachpit.com/store/product.aspx?isbn=0321670418>.
--
Bill Cheeseman - email@hidden
_______________________________________________
Do not post admin requests to the list. They will be ignored.
Xcode-users mailing list (email@hidden)
Help/Unsubscribe/Update your Subscription:
This email sent to email@hidden