Inside Macintosh es el título de los manuales de documentación para desarrolladores publicados por Apple Computer , que documentan las API y la arquitectura de la máquina de la computadora Macintosh .
Primeras ediciones
La primera documentación de Inside Macintosh , para Mac 128K , se distribuyó en dos grandes carpetas con páginas fotocopiadas y perforadas con 3 agujeros . Cada pocos meses, se distribuían secciones actualizadas para su inserción en las carpetas. Algunas de las secciones originales fueron escritas por miembros muy tempranos del grupo Macintosh, incluidos Chris Espinosa y Joanna Hoffman.
En julio de 1982, contrataron a Caroline Rose para hacerse cargo de la documentación del software, mientras que Bradley Hacker se centró en documentar el hardware. Además de ser la escritora principal, Rose editó los volúmenes I a III y fue la supervisora del proyecto. En 1984, otros escritores se unieron al esfuerzo, incluidos Robert Anders, Mark Metzler, Kate Withey, Steve Chernicoff, Andy Averill y Brent Davis.
Debido a numerosos cambios de software de última hora, la versión oficial que publicaría Addison-Wesley se retrasó. Mientras tanto, una edición promocional de $ 25 (conocida como la "edición de la guía telefónica" porque fue publicada por el editor de la guía telefónica Lakeside Press ) estuvo disponible en abril de 1985. [1]
Addison-Wesley publicó los volúmenes I-III en julio de 1985 en dos formatos: como tres libros de bolsillo separados y como un libro de tapa dura que combina los tres volúmenes. Era la documentación técnica oficial de los modelos Mac 128K, Mac 512K (" Fat Mac ") y Mac XL originales .
Recepción
Las reacciones a los volúmenes I-III fueron mixtas. Si bien muchos elogiaron la documentación por su claridad, minuciosidad y consistencia, otros no estuvieron de acuerdo, en particular quejándose de la falta de código de muestra.
Entre los comentarios positivos se encuentran los siguientes:
- En el número de InfoWorld del 27 de enero de 1986, el columnista John C. Dvorak escribió que lo más destacado de la Conferencia Appleworld , para muchos, fue la publicación de Addison-Wesley de Inside Macintosh . “Cuesta $ 75 y vale cada centavo. Te dice todo lo que nunca quisiste saber sobre Macintosh, algo imprescindible para cualquier desarrollador ". [2]
- También en 1986, Inside Macintosh Volumes I – III ganó un Premio al Logro en la competencia de la Sociedad de Comunicación Técnica del Norte de California.
- En 1988, el destacado desarrollador de software y columnista Stan Krute escribió: “Si Pulitzers tuviera una categoría de redacción técnica, Inside Mac ganaría un premio. [Sus escritores] nos han brindado la información más completa sobre un sistema cibernético complejo hasta ahora visto ". [3]
En el lado negativo:
- Bruce F. Webster en BYTE de diciembre de 1985 describió Inside Macintosh como "infame, caro y oscuro", pero "para cualquiera que quiera hacer mucho con Mac ... la única fuente real de información [impresa]". Citó a Kathe Spracklen, desarrolladora de Sargon , diciendo que el libro "consta de 25 capítulos, cada uno de los cuales requiere que usted comprenda los otros 24 antes de leerlo". [4]
- Un artículo de Dog Cow sobre la GUI de Mac cita a Robert C. Platt diciendo: "La mejor guía para las ROM de Mac es Inside Macintosh . Desafortunadamente, Inside Macintosh es también la documentación más incomprensible jamás escrita". [1]
Volúmenes IV-VI
Estas versiones de Inside Macintosh fueron publicadas posteriormente por Addison-Wesley (con la autoría atribuida solo a Apple Computer en general):
- El Volumen IV (octubre de 1986) documentó los cambios en el software del sistema en Mac Plus , que se introdujo en enero de 1986.
- El Volumen V (febrero de 1988) documentó Mac II y Mac SE , que se introdujeron en 1987. Se discutió Color QuickDraw , así como el hardware Mac II y Mac SE y otros componentes de software nuevos.
- El Volumen VI (abril de 1991) describió el Sistema 7 . Con 32 capítulos, era más grueso que los tres primeros volúmenes combinados.
Todos estos volúmenes fueron diseñados para leerse juntos; no se repitió ninguna información. [1]
Nuevo enfoque
Poco después de la publicación del Volumen VI, Apple renovó toda la serie Inside Macintosh , dividiéndola en volúmenes de acuerdo con el área funcional discutida, en lugar de modelos o capacidades de máquina específicos. De esta forma, la serie era mucho más coherente y una referencia mucho mejor para los programadores. A medida que se agregaron nuevas funciones al Mac OS clásico , se pudieron escribir nuevos volúmenes (a continuación) sin invalidar los publicados anteriormente, en contraste con la primera serie, que se volvió cada vez más desactualizada con el tiempo.
- Interfaces de aplicación AOCE
- Módulos de acceso al servicio AOCE
- Caja de herramientas de comunicaciones
- Dispositivos
- Archivos
- Imágenes con QuickDraw
- Comunicación entre aplicaciones
- Conceptos básicos de Macintosh Toolbox
- Memoria
- Más caja de herramientas de Macintosh
- Redes
- Utilidades del sistema operativo
- Descripción general
- Entorno y utilidades de QuickDraw GX
- Gráficos QuickDraw GX
- Objetos QuickDraw GX
- Impresión QuickDraw GX
- Extensión y controladores de impresión QuickDraw GX
- Descripción general del programador QuickDraw GX
- Tipografía QuickDraw GX
- Tiempo rapido
- Componentes QuickTime
- Numéricos de PowerPC
- Software del sistema PowerPC
- Procesos
- Sonar
- Texto
- X-Ref
Estos documentos relacionados también se publicaron:
- ResEdit Referencia
- Especificación de formato de fuente TrueType
A finales de la década de 1990, Apple dejó de publicar Inside Macintosh como un libro impreso, y en su lugar lo puso a disposición como un CD-ROM al menos desde 1994, [5] así como en línea. Desde entonces, la variante de CD se ha eliminado gradualmente, aunque los desarrolladores de Apple todavía pueden recibir documentación en línea como parte de los CD de desarrollador. En su forma en línea, la información es mucho más fácil de mantener, pero algunos desarrolladores aún prefieren un formato impreso.
Inside Macintosh cubre solo el Mac OS clásico ; se introdujo una nueva serie de documentos para Mac OS X . Inicialmente, esta documentación incluía solo la Especificación de carbono que identifica las API que eran compatibles con Carbon y la documentación de Cocoa heredada de OpenStep . Más tarde, la Especificación de carbono se refactorizó en la Referencia de carbono, que en realidad documentó las API (tomando gran parte del contenido de Inside Macintosh ). Hoy en día, Carbon Reference y Cocoa Reference están agrupados en la Biblioteca de referencia de ADC .
Referencias
- ↑ a b c Perro Vaca (2 de febrero de 2018). "Dentro de Macintosh" . GUI de Mac . Consultado el 27 de febrero de 2019 .
- ^ Dvorak, John C. (27 de enero de 1986). "Los nuevos productos de Apple son un bostezo, pero Mac es más rápido" . InfoWorld : 62.
- ^ Krute, John (enero de 1988). "Para las Mac" . Diario del Dr. Dobb : 92–93.
- ^ Webster, Bruce (diciembre de 1985). "Gráficos en color de microcomputadora: observaciones" . BYTE : 405.
- ^ Dentro del CD-ROM de Macintosh . ISBN 0201406748.
enlaces externos
- Documentación para desarrolladores de Apple
- Biblioteca de referencia de ADC