Macintoshの内部

Inside Macintosh は、 Apple Computerが発行した開発者向けドキュメントで、Macintoshのクラシック Mac OSのAPIとアーキテクチャを文書化しています。

最初のMacintosh用の最初のInside Macintoshドキュメントは、コピーされた3 穴パンチページが入った 2 つの大きなバインダーで配布されました。数か月ごとに、更新されたセクションがバインダーに挿入されるように配布されました。元のセクションの一部は、Chris Espinosa や Joanna Hoffman など、Macintosh グループの初期のメンバーによって書かれました。これらのすべての巻は、情報が重複することなく、一緒に読めるように設計されていました。^[1]

1982 年 7 月、Caroline Rose がソフトウェア ドキュメントの作成を引き継ぐために雇用され、Bradley Hacker はハードウェアのドキュメント作成に専念しました。Rose は主任ライターであるだけでなく、第 1 巻から第 3 巻までを編集し、プロジェクト スーパーバイザーも務めました。1984 年には、Robert Anders、Mark Metzler、Kate Withey、Steve Chernicoff、Andy Averill、Brent Davis などのライターがプロジェクトに加わりました。  

土壇場でのソフトウェアの変更が多数あったため、アディソン・ウェズリー社から出版される予定の正式版は遅れた。その間、25ドルのプロモーション版（電話帳出版社レイクサイド・プレス社から出版されたため「電話帳版」と呼ばれる）が1985年4月に発売された。^[1]

Addison-Wesley 社は 1985 年 7 月に、第 1 巻から第 3 巻までを 2 つの形式で出版しました。3 つの独立したペーパーバックと、3 巻すべてを 1 冊にまとめたハードカバーの本です。これは、オリジナルの Macintosh、 Macintosh 512K (「Fat Mac」)、およびMacintosh XLの公式技術文書です。   

第 4 巻以降、著者は一般に Apple Computer のみに帰属する。第 4 巻 (1986 年 10 月)は、1986 年 1 月に発表されたMacintosh Plusのシステム ソフトウェアの変更点について記述している。第 5 巻 (1988 年 2 月)は、1987 年に発表されたMacintosh IIおよびMacintosh SEについて記述している。Color QuickDraw、Mac II および Mac SE ハードウェア、およびその他の新しいソフトウェア コンポーネントについて説明している。第 6 巻 (1991 年 4 月) はSystem 7について記述している。32 章から成り、最初の 3 巻を合わせたよりも分厚い。

第 6 巻が出版されて間もなく、Apple はInside Macintoshシリーズ全体を刷新し、特定のマシン モデルや機能ではなく、議論されている機能領域に応じて巻を分割しました。この形式により、シリーズははるかに一貫性が増し、プログラマーにとってはるかに優れたリファレンスになりました。クラシック Mac OSに新しい機能が追加されても、以前に出版されたものを無効にすることなく新しい巻を書くことができました。これは、時間の経過とともに次第に時代遅れになった最初のシリーズとは対照的です。

1990年代後半、AppleはInside Macintoshの印刷本としての出版をやめ、少なくとも1994年以降はCD-ROM、^[2]とオンラインでの出版に切り替えました。それ以降、CD版は段階的に廃止されましたが、Appleの開発者は開発者CDの一部としてオンラインドキュメントを引き続き受け取っていました。オンライン形式では情報の維持がはるかに簡単ですが、一部の開発者は依然として印刷形式を好みます。

Inside Macintosh はクラシック Mac OSのみをカバーしており、 Mac OS X用の新しいドキュメント セットが導入されました。当初、このドキュメントには、CarbonのAPI を特定する Carbon 仕様と、OpenStepから継承されたCocoaドキュメントのみが含まれていました。その後、Carbon 仕様は Carbon リファレンスにリファクタリングされ、 Inside Macintoshから多くのコンテンツが取り入れられ、API が実際にドキュメント化されました。Carbon リファレンスと Cocoa リファレンスは、 ADCリファレンス ライブラリ にまとめられています。

第 1 巻から第 3 巻までの反応はさまざまでした。多くの人がドキュメントの明瞭さ、徹底性、一貫性を高く評価しましたが、サンプル コードが不足していることに特に反対する人もいました。

1986 年 1 月 27 日のInfoWorld号で、コラムニストのJohn C. Dvorak は、多くの人にとってAppleworld ConferenceのハイライトはAddison-Wesley のInside Macintoshだったと書いています。「75 ドルで、その価値は十分あります。Macintosh について知りたくなかったことすべてが書かれています。開発者なら必読です。」^[3]また、1986 年には、Inside Macintosh Volumes I–III が Society for Technical Communication の北カリフォルニア大会で功績賞を受賞しました。1988 年には、ソフトウェア開発者でコラムニストの Stan Krute が、「ピューリッツァー賞に技術執筆部門があったら、Inside Mac が受賞するでしょう。[著者らは] 複雑なサイバネティック システムについて、これまでで最も包括的な洞察を与えてくれました。」^{[4]と書いています。}

1985 年 12 月のByteで、Bruce F. Webster はInside Macintoshについて「悪名高く、高価で、知られていないが、Mac で多くのことをしたい人にとっては、唯一の本当の [印刷された] 情報源」と評した。彼は、Sargonの開発者である Kathe Spracklenの言葉を引用して、この本は「25 の章から成り、各章を読む前に残りの 24 章を理解しておく必要がある」と述べた。^[5] Dog Cow の Mac GUI の記事では、Robert C. Platt の言葉を引用して、「Mac の ROM に関する最高のガイドはInside Macintoshです。残念ながら、Inside Macintosh はこれまでに書かれた中で最も理解しにくいドキュメントでもあります。」と述べた。 ^[1]