Print

Please login or register.
1 Hour 1 Day 1 Week 1 Month Forever
Login with username, password and session length

[IoIxD]

I started becoming interested in Mac programming recently and was quite disappointed in the lack of good documentation for the C/C++ functions. Outside of literal scans of books, the only thing I could find was the Apple website which was only avaliable via Wayback Machine and had a horrible interface (a search bar that no longer worked)

So I took matters into my own hands.

This is generated via the header files from the copy of Universal Interfaces that I got with CodeWarrior 8. It's actually so new that it's intended for Carbon developers, but the functions that were removed in Carbon are still documented here.

Unfrotunately, "documented" is very literal here. It turns out Apple was horrible at documentation; many functions are not described and most struct fields are not either. I could probably find more information if I sat down and fully combed through the books, and if I do, I'm probably going to add it to this site. But in the mean time, this is better then what I found before.

I also invite anybody who has the time/knowledge to submit a pull request to the GitHub repo for the docs.

[Greystash]

This is an amazing resource!! Thank you lolxD!

[Jubadub]

Nice initiative! Yes, this sort of work is very much needed for more and better Mac OS 9.2.2 development!

I myself wanted to do this way back in 2021, until things... happened. And life priorities shifted. But I always wanted to see an initiative like yours become reality.

It may not be fully fleshed out yet, but what you got is already incredibly helpful, and it is good enough to encourage others to get started on developing their own Mac OS 9 apps.

Currently I'm working on a REALbasic DR1r33 project (with help of later versions to target certain additional platforms), but after that I have plans for another project, and that will likely be in pure ANSI C89 / ISO C90 (while still conforming with K&R C), using probably Fantasm 6 and the final version of Apple's MrC compiler. Once that is ongoing, your page will be of great help, and I will gladly submit a merge (AKA pull) request to your Git repo if I think I can flesh out any of the sections there.

[Knezzen]

This is GOLD! I can't the amount of times I have searched everywhere for some documentation on a API I stumbled upon and found... Nothing.

Great job!

[Jubadub]

Now that I'm developing an ANSI C89 Mac game, I finally remembered and came back for this. (My REALbasic app was put on hold for now.)

First thing I noticed is that, unfortunately, the website does not render fully on Classilla 9.3.4b... So if anyone of us could get that addressed somehow, that would be great. (The TLS part is addressed via Crypto Ancienne at least. I should retest the page with MacLynx...)

I will work around this for the time being and use the resource as is, though. Thanks again for creating this!

You mentioned this was generated based on Apple's "Universal Headers" from CodeWarrior 8... I wonder if that is the latest version of the headers. I think the final version is 3.4.1? I have to check. (Personally, I'm sticking with CW Pro 6.3 for the time being in case I also decide to target 68k, so this works fine for me eitherway.)

[IoIxD]

Late response, but how have you been using it?

I actually underestimated how hard it is to do this and have been using it alongside THINK Reference 2.0; in fact, I've mostly been using TR 2.0, only using my own site because it has a better search function.

I need to transfer everything from TR 2.0. I got about 70% there with a script, but I need to fix a lot of the files after doing that and there's still a lot of undocumented stuff because I can't automatically transfer stuff.

[thirdbanana]

Most impressive work! I should help me get back to coding classic Mac stuff; I will need all the help I can get 

About lack of documentation from Apple, I wonder if (1) They just never shared it or (2) they belong to that group of programmers (that I know very well) who think "my code is self-documenting!" I am looking at you Perl coders!