Внутри Macintosh - это заголовок руководств по документации для разработчиков, опубликованных Apple Computer, документирующие API и машинную архитектуру компьютера Macintosh.
Первая документация Inside Macintosh для Mac 128K была распространена в двух больших переплетах с фотокопированными страницами с перфорацией и 3 отверстиями. Каждые несколько месяцев обновленные разделы распространялись для вставки в подшивки. Некоторые из оригинальных разделов были написаны очень ранними членами группы Macintosh, включая Криса Эспинозы и Джоанну Хоффман.
В июле 1982 года Кэролайн Роуз была нанята, чтобы взять на себя документацию по программному обеспечению, а Брэдли Хакер сосредоточился на документировании оборудования. Помимо того, что она была ведущим сценаристом, Роуз редактировала тома I – III и была руководителем проекта. В 1984 году к усилиям присоединились другие писатели, в том числе Роберт Андерс, Марк Метцлер, Кейт Уити, Стив Черникофф, Энди Аверилл и Брент Дэвис.
Из-за многочисленных изменений программного обеспечения, внесенных в последнюю минуту, официальная версия, которую должна была опубликовать Addison-Wesley, была отложена. Между тем, в апреле 1985 года стало доступно рекламное издание за 25 долларов (известное как «издание телефонной книги», потому что оно было опубликовано издателем телефонной книги Lakeside Press ).
Издание Addison-Wesley Тома I – III в июле 1985 г. в двух форматах: как три отдельные книги в мягкой обложке и как одна книга в твердом переплете, объединяющая все три тома. Это была официальная техническая документация для оригинальных моделей Mac 128K, Mac 512K («Fat Mac ») и Mac XL.
Реакции на объемы I – III были смешанными. В то время как многие хвалили документацию за ее ясность, тщательность и последовательность, другие не соглашались, особенно жаловались на отсутствие образца кода.
Среди положительных отзывов были следующие:
С отрицательной стороны:
Эти версии Inside Macintosh были впоследствии опубликованы компанией Addison-Wesley (авторство приписывается только Apple Computer в целом):
Все эти тома предназначены для совместного чтения; информация не повторялась.
Вскоре после публикации тома VI Apple полностью переработала всю серию Inside Macintosh, разбив ее на тома в соответствии с обсуждаемой функциональной областью, а не с конкретными моделями машин или возможности. В этой форме серия была гораздо более последовательной и гораздо более удобной для программистов. По мере добавления новых функций к классической Mac OS новые тома (см. Ниже) можно было писать без аннулирования ранее опубликованных - в отличие от первой серии, которая со временем становилась все более устаревшей.
Эти связанные документы также были опубликованы:
В конце 1990-х Apple прекратила публиковать Inside Macintosh в виде печатной книги, вместо этого сделав ее доступной на компакт-диске, по крайней мере, с 1994 года, а также в Интернете. С тех пор вариант с компакт-диском был прекращен, хотя разработчики Apple все еще могут получать онлайн-документацию как часть компакт-дисков для разработчиков. В онлайн-форме информацию намного проще поддерживать, но некоторые разработчики по-прежнему предпочитают печатный формат.
Inside Macintosh охватывает только классическую Mac OS ; был представлен новый набор документации для Mac OS X. Первоначально эта документация включала только спецификацию Carbon, определяющую API, которые поддерживались в Carbon, и документацию Cocoa, унаследованную от OpenStep. Позже спецификация Carbon была преобразована в Carbon Reference, в которой фактически задокументированы API (заимствовано много контента из Inside Macintosh). Сегодня Carbon Reference и Cocoa Reference объединены в справочную библиотеку ADC.