Mac GUI

Macintosh Software Supplement 1985

Print this article



Probably the most famous Apple II manual ever is the January 1978 "Red Book," an 8.5x11 perfect bound volume whose contents looked like someone photocopied all the notes that could be found in Woz's desk drawer: some typewritten, some handwritten, with hand sketches too.

Even 6 years later in 1984, Apple's developer documentation for Macintosh had not changed much from the appearance of the Red Book. But to be fair, documenting the Apple II was a drop in the bucket compared to the monumental undertaking of explaining the entire Macintosh Toolbox, User Interface Guidelines, hardware implementation, and much more, so that programmers could develop new software for it.

Remember, in 1984, basically no one had ever programmed a computer that used windows, icons, and a mouse.


Documentation for Programming the Macintosh in 1984

The two main sources of printed documentation for Macintosh programming in 1984 were Inside Macintosh and the Macintosh Software Supplement. Both were distributed via 3-ring binder. Inside Macintosh cost $150, and the Software Supplement cost $100. This latter price also put you on the subscription list so Apple sent you Software Supplement updates as they became available. Both packages were available to anyone who sent in the money; they were not limited to Apple Certified Developers.

Inside Macintosh was eventually published as a softcover "Promotional Edition" in spring 1985, and as a finished hardcover by Addison-Wesley later that year. It is well-remembered and will be explored in a later blog article.

The Macintosh Software Supplement, on the other hand, seems to have been largely forgotten in the past three decades.

The remainder of this article is available only to logged-in Mac GUI members.


« Replacing the Flyback Transformer   •   Playing MazeWars »

Category tags: Lore, Programming

Comments

Dog Cow
Magician Magician

21215
Offline 
Post 10 Mar 2018 11:05 pm   

10 Mar 18

Added links to PDFs for February and May Software Supplement texts.




Moof! Moof! Dogcow!

Book: The New Apple II User's Guide
Dog Cow
Magician Magician

21215
Offline 
Post 21 Jun 2018 7:09 pm   

21 Jun 18

I now have complete copies of two Supplements from 1986, but not the disks. If anyone has the 1986 disks, please let me know. My email address is above, at the end of the article.

I am also still interested in the Software Supplements from 1984.


23 Jun 18: added a link to a Usenet post on the May 1985 Supplement. A good overview of its contents.

04 Aug 20: added disk information for October 1984 supplement




Moof! Moof! Dogcow!

Book: The New Apple II User's Guide


Last edited by Dog Cow on 04 Aug 2020 4:23 pm; edited 1 time in total
tanaquil
Member
50
Offline 
Post 29 Jun 2018 3:13 pm   

This is very cool, but the links to the pdf files don't seem to be working. Am I doing something wrong? Were they moved?

Thanks for all your work!

Dog Cow
Magician Magician

21215
Offline 
Post 29 Jun 2018 10:45 pm   

tanaquil wrote:
This is very cool, but the links to the pdf files don't seem to be working. Am I doing something wrong? Were they moved?
Yeah, the URLs changed. I updated them. Thanks for telling me.




Moof! Moof! Dogcow!

Book: The New Apple II User's Guide
adamtheknife
Member
53
Offline 
Post 19 Aug 2018 3:52 pm   

First off I just want to say that I have loved reading through all the entires on this blog, the information and research is simply amazing!

I have been playing around with an old Plus that I rescued from a dumpster 15 years ago and am in the process of playing around with what development was like for it. Your blog has been invaluable! Smile

I apologize if this was covered in this post but I am curious, after 1986, (or when the supplement stopped being offered) what was Apples official form of developer documentation? Was the supplement turned into an official publication like Inside Macintosh? Or did something else replace it?

Also, big "ask" but have you considered digitizing the copy you have in your collection thus far? I have tried to find a copy through the various means available to me and have not had any luck so far... (eBay, archive.org, etc.)

Dog Cow
Magician Magician

21215
Offline 
Post 23 Aug 2018 5:20 am   

adamtheknife wrote:

I apologize if this was covered in this post but I am curious, after 1986, (or when the supplement stopped being offered) what was Apples official form of developer documentation? Was the supplement turned into an official publication like Inside Macintosh? Or did something else replace it?

Also, big "ask" but have you considered digitizing the copy you have in your collection thus far? I have tried to find a copy through the various means available to me and have not had any luck so far... (eBay, archive.org, etc.)

Hi, after 1986, I think that both Inside Macintosh and Apple Technical Notes came to replace the Software Supplement. The original purpose of the Supplement was to allow for Macintosh cross-development on an Apple Lisa. In 1987, MPW, Macintosh Programmer’s Workshop, became the standard for native Macintosh software development.

I have partially digitized 1986 Software Supplements. I plan to do the rest too. No idea when.




Moof! Moof! Dogcow!

Book: The New Apple II User's Guide