Внутри Macintosh - Inside Macintosh

Внутри Macintosh - это название руководств по документации для разработчиков, опубликованных Apple Computer , в которых описаны API и машинная архитектура компьютера Macintosh .

Ранние издания

Первая документация Inside Macintosh для Mac 128K была распространена в двух больших папках с фотокопированными страницами с перфорацией в 3 отверстия . Каждые несколько месяцев обновленные разделы распространялись для вставки в папки. Некоторые из оригинальных разделов были написаны очень ранними членами группы Macintosh, включая Криса Эспинозы и Джоанну Хоффман.

В июле 1982 года Кэролайн Роуз была нанята, чтобы взять на себя документацию по программному обеспечению, а Брэдли Хакер сосредоточился на документировании оборудования. Помимо того, что она была ведущим сценаристом, Роуз редактировала тома I – III и была руководителем проекта. В 1984 году к усилиям присоединились другие писатели, в том числе Роберт Андерс, Марк Метцлер, Кейт Уити, Стив Черникофф, Энди Аверилл и Брент Дэвис.  

Из-за многочисленных изменений программного обеспечения, внесенных в последнюю минуту, официальная версия, которую должна была опубликовать Addison-Wesley, была отложена. Тем временем в апреле 1985 года стало доступно рекламное издание за 25 долларов (известное как «издание телефонной книги», потому что оно было опубликовано издателем телефонных книг Lakeside Press ).

Эддисон-Уэсли опубликовал Тома I – III в июле 1985 года в двух форматах: в виде трех отдельных книг в мягкой обложке и в виде одной книги в твердом переплете, объединяющей все три тома. Это была официальная техническая документация для оригинальных моделей Mac 128K, Mac 512K (« Fat Mac ») и Mac XL .   

Прием

Реакции на тома I – III были смешанными. В то время как многие хвалили документацию за ее ясность, полноту и последовательность, другие не соглашались, особенно жалуясь на отсутствие образца кода.

Среди положительных отзывов были следующие:

  • В номере InfoWorld от 27 января 1986 года обозреватель Джон Дворжак написал, что самым ярким событием конференции Appleworld для многих стала публикация Аддисон-Уэсли « Inside Macintosh» . «Это 75 долларов и стоит каждого пенни. В нем рассказывается все, что вы никогда не хотели знать о Macintosh - это необходимо для любого разработчика ».
  • Также в 1986 году Inside Macintosh Volumes I – III получил награду за достижения в конкурсе Общества технической коммуникации Северной Калифорнии.
  • В 1988 году известный разработчик программного обеспечения и обозреватель Стэн Круте писал: «Если бы у Пулитцеров была категория технического письма, Inside Mac выиграла бы приз. [Его авторы] дали нам наиболее полное представление о сложной кибернетической системе, которую мы когда-либо видели ».

С отрицательной стороны:

  • Брюс Ф. Вебстер в BYTE за декабрь 1985 г. описал Inside Macintosh как «печально известный, дорогой и непонятный», но «для всех, кто хочет много делать с Mac ... единственным реальным [печатным] источником информации». Он процитировал Кэте Спраклен, разработчика Sargon , которая сказала, что книга «состоит из 25 глав, каждая из которых требует, чтобы вы поняли другие 24, прежде чем читать ее».
  • В статье Dog Cow о графическом интерфейсе пользователя для Mac Роберт Платт сказал: «Лучшее руководство по ПЗУ для Mac - это Inside Macintosh . К сожалению, Inside Macintosh также является самой непонятной документацией из когда-либо написанных».

Том IV – VI

Эти версии Inside Macintosh были впоследствии опубликованы компанией Addison-Wesley (авторство приписывается только Apple Computer в целом):

  • Том IV (октябрь 1986 г.) документировал изменения в системном программном обеспечении Mac Plus , которое было представлено в январе 1986 г.
  • В томе V (февраль 1988 г.) описаны Mac II и Mac SE , представленные в 1987 году. В нем обсуждаются Color QuickDraw , а также оборудование Mac II и Mac SE и другие новые программные компоненты.
  • Том VI (апрель 1991 г.) описывает Систему 7 . Он состоял из 32 глав и был толще, чем первые три тома вместе взятые.

Все эти тома предназначены для совместного чтения; информация не повторилась.

Новый подход

Вскоре после публикации тома VI Apple переработала всю серию Inside Macintosh , разбив ее на тома в соответствии с обсуждаемой функциональной областью, а не конкретными моделями машин или возможностями. В этой форме серия была гораздо более последовательной и гораздо более удобной для программистов. По мере того, как к классической Mac OS были добавлены новые функции , новые тома (см. Ниже) можно было писать без признания недействительными уже опубликованных ранее - в отличие от первой серии, которая со временем становилась все более устаревшей.

Также были опубликованы эти связанные документы:

В конце 1990-х Apple прекратила публикацию « Inside Macintosh» в виде печатной книги, вместо этого сделав ее доступной на компакт-диске, по крайней мере, с 1994 года, а также в Интернете. С тех пор вариант с компакт-диском был прекращен, хотя разработчики Apple по-прежнему могут получать онлайн-документацию как часть компакт-дисков для разработчиков. В онлайн-форме поддерживать информацию намного проще, но некоторые разработчики по-прежнему предпочитают печатный формат.

Macintosh "Inside" охватывает только классическую Mac OS ; для Mac OS X был представлен новый набор документации . Первоначально эта документация включала только спецификацию Carbon, определяющую API-интерфейсы , которые поддерживались в Carbon, и документацию по Какао, унаследованную от OpenStep . Позже спецификация Carbon была преобразована в Carbon Reference, которая фактически документировала API (заимствовав много контента из Inside Macintosh ). Сегодня справочник по углероду и справочник по какао объединены в Справочную библиотеку ADC .

Рекомендации

внешние ссылки