Часть 1: ВВЕДЕНИЕ

Пользователи Macintosh должны запустить System 7 или более позднюю версию. Electric приходит с файлами проектов для  Metrowerks и ProjectBuilder (OS/X), хотя она была создана с MPW и THINK_C.

Дистрибутив Electric - это единственный файл в UNIX "tar" формате, GNU-архивированный. На Macintosh используйте программу MacGzip для распаковки файла, и MacTar для извлечения файла. Чтобы установить Electric, следуйте процедуре:

• После извлечения файла будет создана директория верхнего уровня, названная electric-ВЕРСИЯ с четырьмя поддиректориями: src, lib, examples и html.

• Будьте осторожнее с Macintosh соглашением по переводу строки (line-feed), которое отличается от аналогичных в других операционных системах. Если вы используете старую "tar" программу (более старую, чем "MacTar"), вам может понадобиться установка опции "Convert Newlines" до распаковки "tar" файла. Также, если вы используете  "Internet Config", проверьте для полной уверенности его установки "Change Newline". Для уверенности в правильной работе распаковки проверьте файл cadrc, который находится в директории верхнего уровня. В этом файле будет меньше 10 строк текста. Если файл появляется с единственной строкой, или если есть ложные непечатные символы в начале или конце каждой линии, тогда преобразование файла было сделано некорректно.

• Для System 7, 8 и 9 есть Metrowerks проект (названный Electric.xml). Запустите Metrowerks, импортируйте этот файл, и сохраните его на верхнем уровне, рядом с директорией src. Благодаря размеру кода, который будет создан, вам может понадобиться увеличить размер Metrowerks части. Для System 10 (OS/X), есть ProjectBuilder файлы (папки, названные Electric.pbproj и English.lproj). Имейте в виду, что поддержка OS/X не полностью отлажена, так что пользуйтесь с осторожностью.

• Откомпилируйте Electric. Это создаст приложение Electric.

• Дважды щелкните по приложению Electric, чтобы запустить систему.

Есть некоторые детали, касающиеся дистрибуции Electric:

• Директория src содержит исходный код. Он иерархически организован по функциям.

• Директория html содержит одну поддиректорию, manual, в которой находится данное руководство в формате HTML. Для работы с документом откройте файл index.html внутри директории manual вашим web-браузером.

• Директория examples содержит несколько демонстрационных файлов.

• Симулятор IRSIM, интерпретатор LISP и интерфейс иностранных языков не распространяются как часть GNU загрузки. Пользователи, которые хотят добавить эти возможности, должны приобрести Static Free Software дополнения, описанные здесь. Используйте те же процедуры для извлечения этих файлов расширений (которые будут также GNU-архивированными tar файлами). Извлеките их в то же место, где основной дистрибутив, и это добавит необходимые файлы в дерево исходных файлов. Затем импортируйте файл проекта ElectricSFS.xml для создания  Metrowerks проекта Electric с языковым расширением.

• Для добавления интерпретатора TCL следуйте инструкциям:

  • Загрузите ActiveTcl с http://www.tcl.tk и установите его.

• В компиляторе добавьте путь к директории установки TCL "include".

• Также в компиляторе добавьте соответствующую библиотеку TCL к проекту.

• Отредактируйте соответствующий "mac" файл, включений в src/include (например, macsfsheaders.h), и раскомментируйте определение "FORCETCL".

• Установка Electric потребует еще некоторых усилий. Хотя Electric будет прекрасно стартовать из директории, где она построена, вы не сможете переместить исполняемый файл в другое место и рассчитывать, что он заработает. Причина в том, что Electric использует набор файлов поддержки (support files). Основной файл поддержки называется .cadrc. Вдобавок Electric нуждается в знании, где найти директории lib и html. Если эти файлы поддержки не найдутся, Electric не сможет инициализировать свой графический интерфейс пользователя (достаточно ввести "-quit", чтобы выйти из программы, если такое случится). Следует переместить файлы поддержки рядом с исполняемым файлом в общедоступное место. Затем создайте псевдоимя для исполняемого файла, которое разместите в любом удобном для вас месте. Когда запускается псевдоимя (alias) директория с исполняемым файлом становится текущей директорией, и все файлы поддержки будут найдены.

• Electric может говорить на вашем языке! В настоящее время он был переведен на французский. Обратитесь на сайт  Static Free Software, если вы заинтересованы в осуществлении перевода. Для использования другого языка вам надо получить дополнения Static Free Software и построить "International" версию Electric в ElectricIntl.xml или ElectricSFSIntl.xml. Перед компиляцией установите желаемый язык изменением процедуры "elanguage()" в "graph/graphmac.c".
  В любое время вы можете отменить использование иностранного языка и вернуться к английскому удалением файлов перевода. Эти файлы в папке "lib/international" с подпапками, которые имеют имена языков (например, перевод на французский находится в "lib/international/fr"). Ниже есть папка, названная "LC_MESSAGES", и внутри нее файлы перевода.