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

Electric запускается под Windows 95/98/ME, Windows NT 4.0, Windows 2000 или Windows XP. Система компилируется  Visual C++ 5.0 или более поздней версией (файлы проекта включены).

Дистрибутив Electric - это единственный файл в UNIX "tar" формате, GNU-архивированный. Он может быть распакован с помощью ряда программ, включая "WinZip" (см. http://www.gzip.org, где найдете больше информации). Для инсталляции Electric следуйте процедуре:

• Извлеките содержимое "tar" файла. При использовании WinZip удостоверьтесь, что опция "TAR File Smart CR/LF Conversion" установлена в диалоге "Configuration..." меню "Options". После извлечения вы получите директорию верхнего уровня, названную electric-ВЕРСИЯ с четырьмя поддиректориями: src, lib, examples и html.

• Для пользователей Visual C++ 5.0 и 6.0 откройте файл рабочего пространства Electric.dsw (и он, и связанный файл Electric.dsp находятся на верхнем уровне рядом с директорией src). Visual Studio .NET пользователи могут открыть Electric.vcproj. Если у вас есть трудности с любыми из этих файлов, используйте MAKE фал Electric.mak. Откомпилируйте Electric. Будет создана новая директория на верхнем уровне, названном Debug, который будет содержать все объектные файлы.

• Внутри директории Debug вы найдете исполняемый файл Electric. Переместите этот файл за пределы директории Debug и разместите его в директории верхнего уровня. Дважды щелкните по исполняемому файлу Electric,  чтобы запустить систему.

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

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

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

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

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

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

  • Загрузите Java Development Kit (JDK) с http://java.sun.com. Установите. Стандартное местоположение -  C:\jdk1.3, и этот путь будет здесь использован. Если вы установите куда-либо еще, приведите инструкции в соответствие.

• Отредактируйте переменные окружения в панели управления "System". На некоторых системах вам нужно щелкнуть по ярлычку "Environment" (окружение); на других щелкнуть по "Advanced" (расширенные), а затем щелкнуть по клавише "Environment Variables" (переменные окружения). В "System variables" (системные переменные), выберите "Path" (путь) и в окошко "Value:" (значение) добавьте следующую строку в конец:

  ;C:\jdk1.3\jre\bin\classic;C:\jdk1.3\bin

  Вы должны перезагрузить ваш компьютер после произведенных изменений.

• В Visual C++ используйте команду "Settings" меню "Project". Выберите закладку "C/C++" и категорию "Preprocessor". В окошко "Preprocessor definitions" добавьте в конец:

  ,FORCEJAVA=1

  В окошко "Additional include directories" добавьте в конец:

  ,C:\jdk1.3\include,C:\jdk1.3\include\win32

  Выберите закладку "Link" и категорию "General". В окошке "Object/library modules" введите следующее:

  jvm.lib

  Выберите закладку "Link" и категорию "Input". В окошке "Additional library path" введите:

  C:\jdk1.3\lib

• Интерфейс Electric Java работает лучше, если вы также установите "Bean Shell" (см. www.beanshell.org). Загрузите ".jar" файл и разместите его в субдиректории "java" вашей директории "lib". Вы должны использовать версию 1.1Alpha4 или более позднюю (версия 1.01 неприемлема).

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

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

• В компиляторе отредактируйте установки проекта (Project Settings) и найдите поле "Additional include directories" (под "C/C++"). Добавьте новый путь к установленному TCL включению (обычно "C:\Program Files\Tcl\include").

• Также в компиляторе отредактируйте установки проекта (Project Settings) и найдите поле "Additional library path" (под "Linker" - компоновщик). Добавьте новый путь к установленным библиотекам TCL (обычно  "C:\Program Files\Tcl\lib").

• Отредактируйте файл src/include/config.h и убедитесь, что постоянная "TCLLIBDIR" указывает на правильное местоположение файлов инициализации ("init.tcl" и других). Это обычно "C:\Program Files\Tcl\lib\tcl8.3" (заметьте, что каждая обратная косая черта двойная в этом файле, и вы должны следовать этому соглашению).

• Electric должна запускаться на дисплее, установленном в "65536 Colors" или "True Color". Любое уменьшение будет иметь следствием неправильное отображение цветов.

• Если у вас возникли трудности при чтении файлов курсора или иконок (".cur" или ".ico"), вы можете найти тексты кодов этих бинарных файлов в \src\graph\graphpc.uue. Используйте "WinZip" для извлечения файлов в ту же директорию.

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

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