Innerhalb Macintosh - Inside Macintosh

In Macintosh befindet sich der Titel der von Apple Computer veröffentlichten Entwicklerdokumentationshandbücher , in denen die APIs und die Maschinenarchitektur des Macintosh- Computers dokumentiert sind .

Frühe Ausgaben

Die erste Inside Macintosh- Dokumentation für den Mac 128K wurde in zwei großen Ordnern mit fotokopierten 3-Loch- Seiten verteilt. Alle paar Monate wurden aktualisierte Abschnitte zum Einfügen in die Ordner verteilt. Einige der Originalabschnitte wurden von sehr frühen Mitgliedern der Macintosh-Gruppe geschrieben, darunter Chris Espinosa und Joanna Hoffman.

Im Juli 1982 wurde Caroline Rose beauftragt, die Softwaredokumentation zu übernehmen, während Bradley Hacker sich auf die Dokumentation der Hardware konzentrierte. Rose war nicht nur die Hauptautorin, sondern redigierte auch die Bände I - III und war Projektleiterin. 1984 schlossen sich weitere Autoren an, darunter Robert Anders, Mark Metzler, Kate Withey, Steve Chernicoff, Andy Averill und Brent Davis.  

Aufgrund zahlreicher Softwareänderungen in letzter Minute wurde die von Addison-Wesley zu veröffentlichende offizielle Version verzögert. In der Zwischenzeit wurde im April 1985 eine 25-Dollar-Werbeausgabe (bekannt als "Telefonbuchausgabe", da sie vom Telefonbuchverlag Lakeside Press veröffentlicht wurde ) erhältlich.

Addison-Wesley veröffentlichte die Bände I - III im Juli 1985 in zwei Formaten: als drei separate Taschenbücher und als ein gebundenes Buch, das alle drei Bände kombiniert. Es war die offizielle technische Dokumentation für die Originalmodelle Mac 128K, Mac 512K (" Fat Mac ") und Mac XL .   

Rezeption

Die Reaktionen auf die Bände I - III waren gemischt. Während viele die Dokumentation für ihre Klarheit, Gründlichkeit und Konsistenz lobten, waren andere anderer Meinung und beklagten sich insbesondere über das Fehlen von Beispielcode.

Zu den positiven Rückmeldungen gehörten:

  • In der Ausgabe von InfoWorld vom 27. Januar 1986 schrieb der Kolumnist John C. Dvorak, dass der Höhepunkt der Appleworld- Konferenz für viele die Veröffentlichung von Inside Macintosh durch Addison-Wesley war . „Es ist 75 Dollar und jeden Cent wert. Es sagt Ihnen alles, was Sie nie über den Macintosh wissen wollten - ein Muss für jeden Entwickler. “
  • Ebenfalls 1986 gewann Inside Macintosh Volumes I - III einen Award of Achievement im Wettbewerb der Society for Technical Communication in Nordkalifornien.
  • 1988 schrieb der bekannte Softwareentwickler und Kolumnist Stan Krute: „Wenn Pulitzers eine Kategorie für technisches Schreiben hätte, würde Inside Mac einen Preis gewinnen. [Seine Autoren] haben uns den bisher umfassendsten Einblick in ein komplexes kybernetisches System gegeben. “

Auf der negativen Seite:

  • Bruce F. Webster beschrieb in BYTE vom Dezember 1985 Inside Macintosh als "berüchtigt, teuer und dunkel", aber "für alle, die viel mit dem Mac anfangen wollen ... die einzige echte [gedruckte] Informationsquelle". Er zitierte Kathe Spracklen, Entwicklerin von Sargon , mit den Worten, dass das Buch "aus 25 Kapiteln besteht, von denen jedes erfordert, dass Sie die anderen 24 verstehen, bevor Sie es lesen."
  • In einem Mac-GUI-Artikel von Dog Cow wird Robert C. Platt mit den Worten zitiert: "Der beste Leitfaden für die ROMs des Mac ist Inside Macintosh . Leider ist Inside Macintosh auch die unverständlichste Dokumentation, die jemals geschrieben wurde."

Bände IV - VI

Diese Versionen von Inside Macintosh wurden später von Addison-Wesley veröffentlicht (wobei die Urheberschaft im Allgemeinen nur Apple Computer zugeschrieben wird):

  • Band IV (Oktober 1986) dokumentierte die Änderungen an der Systemsoftware im Mac Plus , die im Januar 1986 eingeführt wurden.
  • Band V (Februar 1988) dokumentierte den 1987 eingeführten Mac II und Mac SE . Er erörterte Color QuickDraw sowie die Hardware und andere neue Softwarekomponenten von Mac II und Mac SE.
  • Band VI (April 1991) beschrieb System 7 . Mit 32 Kapiteln war es dicker als die ersten drei Bände zusammen.

Alle diese Bände sollten zusammen gelesen werden. Es wurden keine Informationen wiederholt.

Neuer Ansatz

Kurz nach der Veröffentlichung von Band VI überarbeitete Apple die gesamte Inside Macintosh- Serie und teilte sie nach dem besprochenen Funktionsbereich in Bände auf, anstatt nach bestimmten Maschinenmodellen oder Funktionen. In dieser Form war die Serie weitaus kohärenter und eine viel bessere Referenz für Programmierer. Da dem klassischen Mac OS neue Funktionen hinzugefügt wurden , konnten neue Volumes (unten) geschrieben werden, ohne die zuvor veröffentlichten ungültig zu machen - im Gegensatz zu der ersten Serie, die im Laufe der Zeit zunehmend veraltet war.

Diese verwandten Dokumente wurden ebenfalls veröffentlicht:

In den späten 1990er Jahren stellte Apple die Veröffentlichung von Inside Macintosh als gedrucktes Buch ein und stellte es stattdessen mindestens seit 1994 als CD-ROM sowie online zur Verfügung. Seitdem wurde die CD-Variante eingestellt, obwohl Apple-Entwickler weiterhin Online-Dokumentation als Teil der Entwickler-CDs erhalten können. In der Online-Form sind die Informationen viel einfacher zu pflegen, aber einige Entwickler bevorzugen immer noch ein gedrucktes Format.

In Macintosh wird nur das klassische Mac OS behandelt . Für Mac OS X wurde eine neue Dokumentation eingeführt . Anfänglich enthielt diese Dokumentation nur die Carbon-Spezifikation, in der die in Carbon unterstützten APIs aufgeführt sind , sowie die von OpenStep geerbte Cocoa- Dokumentation . Später wurde die Kohlenstoffspezifikation in die Kohlenstoffreferenz umgestaltet, die die APIs tatsächlich dokumentierte (wobei viel Inhalt von Inside Macintosh übernommen wurde ). Heute sind die Carbon Reference und die Cocoa Reference in der ADC Reference Library zusammengefasst.

Verweise

Externe Links