«Inside Macintosh» — документация для разработчиков, опубликованная Apple Computer , в которой описываются API и архитектура классической Mac OS для компьютеров Macintosh .
Первая документация Inside Macintosh , для первого Macintosh , распространялась в двух больших папках с фотокопиями страниц с тремя перфорированными отверстиями . Каждые несколько месяцев распространялись обновленные разделы для вставки в папки. Некоторые из оригинальных разделов были написаны очень ранними членами группы Macintosh, включая Криса Эспинозу и Джоанну Хоффман. Все эти тома были разработаны для совместного чтения, без повторения какой-либо информации. [1]
В июле 1982 года Кэролайн Роуз была нанята для документирования программного обеспечения, в то время как Брэдли Хакер сосредоточился на документировании оборудования. Помимо того, что Роуз был ведущим писателем, он редактировал тома I–III и был руководителем проекта. В 1984 году к работе присоединились дополнительные писатели, в том числе Роберт Андерс, Марк Метцлер, Кейт Уити, Стив Черников, Энди Аверилл и Брент Дэвис.
Из-за многочисленных изменений в программном обеспечении в последнюю минуту официальная версия, которая должна была быть опубликована Addison-Wesley, была отложена. Тем временем, рекламное издание за 25 долларов (известное как «телефонная книга», поскольку оно было опубликовано издательством телефонной книги Lakeside Press ) стало доступно в апреле 1985 года. [1]
Addison-Wesley опубликовала Volumes I–III в июле 1985 года в двух форматах: как три отдельные книги в мягкой обложке и как одна книга в твердом переплете, объединяющая все три тома. Это официальная техническая документация для оригинального Macintosh, Macintosh 512K («Fat Mac») и Macintosh XL .
Начиная с тома IV, авторство приписывается только Apple Computer в целом. Том IV (октябрь 1986 г.) документирует изменения в системном программном обеспечении Macintosh Plus , представленного в январе 1986 г. Том V (февраль 1988 г.) документирует Macintosh II и Macintosh SE , представленные в 1987 г. В нем обсуждается Color QuickDraw , аппаратное обеспечение Mac II и Mac SE и другие новые программные компоненты. Том VI (апрель 1991 г.) описывает System 7. С 32 главами он толще, чем первые три тома вместе взятые.
Вскоре после публикации тома VI Apple переделала всю серию Inside Macintosh , разбив ее на тома в соответствии с обсуждаемой функциональной областью, а не конкретными моделями машин или возможностями. В таком виде серия гораздо более связна и является гораздо лучшим справочником для программистов. По мере добавления новых функций в классическую Mac OS новые тома могли быть написаны без аннулирования ранее опубликованных — в отличие от первой серии, которая со временем становилась все более устаревшей.
В конце 1990-х годов Apple прекратила публиковать Inside Macintosh в печатном виде, вместо этого на CD-ROM, по крайней мере с 1994 года, [2] и в онлайне. С тех пор вариант CD был постепенно выведен из обращения, хотя разработчики Apple по-прежнему получали онлайн-документацию как часть компакт-дисков разработчика. В онлайн-формате информацию гораздо проще поддерживать, но некоторые разработчики все еще предпочитают печатный формат.
Inside Macintosh охватывает только классическую Mac OS , а для Mac OS X был представлен новый набор документации . Первоначально эта документация включала только Carbon Specification, определяющую API в Carbon , и документацию Cocoa, унаследованную от OpenStep . Позднее Carbon Specification была реорганизована в Carbon Reference, которая фактически документирует API, взяв большую часть контента из Inside Macintosh . Carbon Reference и Cocoa Reference объединены в ADC Reference Library.
Реакции на тома I–III были неоднозначными. Многие хвалили документацию за ее ясность, основательность и последовательность, а другие не соглашались, в частности, из-за отсутствия примеров кода.
В выпуске InfoWorld от 27 января 1986 года обозреватель Джон С. Дворак написал, что для многих изюминкой конференции Appleworld стала публикация Addison-Wesley Inside Macintosh . «Она стоит 75 долларов и стоит каждого пенни. Она расскажет вам все, что вы никогда не хотели знать о Macintosh — это обязательно для любого разработчика». [3] Также в 1986 году Inside Macintosh Volumes I–III выиграли премию за достижения в конкурсе Общества технических коммуникаций Северной Калифорнии. В 1988 году разработчик программного обеспечения и обозреватель Стэн Крут написал: «Если бы у Пулитцеров была категория технического письма, Inside Mac выиграл бы приз. [Его авторы] дали нам самое полное представление о сложной кибернетической системе, которое когда-либо видели». [4]
Брюс Ф. Вебстер в Byte за декабрь 1985 года описал Inside Macintosh как «печально известную, дорогую и малоизвестную [но] для тех, кто хочет многого добиться с Mac [...] единственный настоящий [печатный] источник информации». Он процитировал Кейт Спраклен, разработчика Sargon , которая сказала, что книга «состоит из 25 глав, каждая из которых требует понимания остальных 24 перед прочтением». [5] Статья Mac GUI от Dog Cow цитирует Роберта К. Платта, который сказал: «Лучшее руководство по ПЗУ Mac — Inside Macintosh . К сожалению, Inside Macintosh также является самой непонятной документацией из когда-либо написанных». [1]