ASMED ========================================================================= Назначение : редактор предназначен для использования программистами, преимущественно при работе с кросс-средствами для микропроцессоров. Особенности: Редактирование неограниченного числа файлов. Размер редактируемого текста неограничен. Подсветка синтаксиса и темплеты. Извлечение слов по определенным признакам - например имен макросов. Окно "дерева" проекта, содержащее все входящие в проект файлы. Окно просмотра сообщение об ошибках. Переключение окон редактирование несколькими способами. Вызов внешних программ (Tools) и их файлов помощи с определенными параметрами. Подключение дополнительных модулей (Plug-Ins) Практически все свойства редактора могут быть настроены пользователем. Команды меню : File - New File - создание нового файла Open Project - открытие нового проекта Open File - открытие файла, если выбран файл с расширением "pro" это равносильно команде Open As Project Открыть два раза один файл нельзя! Если попытаться открыть файл, который уже есть в редаторе, то это окно просто станет активным. Open As Project - открытие файла проекта и основного файла проекта Save - запись текущего файла SaveAs - запись под другим именем Special Save - сохранение текущего файла в HTML или RTF формате Save All - сохраниение всех открытых файлов Save As Project - сохранить текущий файл как основной файл проекта и сформировать файл проекта Close - закрыть текущее окно Close All - закрыть все окна Print - печать текста Print Setup - настройка печати Quit - выход из программы Edit - Undo - отменить последнее действие (глубина неограничена) Redo - отменить команду Undo Cut, Copy, Paste, Delete - работа с выдекленным блоком и буфером обмена Find, FindNext - поиск в тексте Replace - поиск и замена Show Clipboard - просмотр содерожимого буфера обмена Project - Create Project - создание одтельной директории для проекта, формирование файла проекта и основного файла проекта. Define - сделать текущий файл редактора основным файлом проекта и сформировать файл проекта Tree - сформировать дерево проекта (делается автоматически при загрузке проекта) Project Manager - вызов менеджера проекта и архива Extract Macros - извлечение определенных слов для подсветки их синтаксиса Wizard - содержит под-меню запуска плаг-инов Pr. Options - настройка опций проекта (?) ZIP Project - архивирование всех файлов в директории проекта UnZIP Project - разархивирование проекта. Tools - Grep - поиск строк в файлах ###### - запуск внешних программ Options - Font - смена шрифта : << - уменьшение >> - увеличение Word Wrap - вкл/выкл переноса AutoIndent - вкл/выкл выравнивания Syntax - вкл/выкл подветки синтаксиса Line Numbers - вкл/выкл показ номеров строк All Chars - вкл/выкл показ служебных символов (эти 6 команды дествуют только на текущий сеанс работы) Main Setup - настройка системы Change - смена конфигурации New - создание новой конфигурации Edit Current - редактирование текущей конфигурации Edit Config - смена и редактирование корнфигурации Tree in Tray - управление положением окна дерева. Panels : File Panel - настройна кнопок панели редактора Tools Panel - настройка кнопок внешних программ. Plug-In Panel - настройка кнопок добавлений. All Up - установка всех панелей вверху экрана. Save Panels - сохранение положения панелей Show Tips - управление показом "Do You Know" при старте. Все настройки могут вызываться двойным щелчком по пустому месту на соответствующей панели. Window - Tile, Cascad, Arrange Icons - управление размещением окон Zoom - распахивание/свертывание окон Next/Previous - переход между окнами Close - закрытие текущего окна List - вызов списка окон Notes - загрузка (или формирование) описания проекта Pr. Tree - переход к окну "дерева" Message - переход окна сообщений Close Tray - закрытие панели дерева и сообщений Help - Ну хелп есть хелп А в окне "About" можно посмотреть на мою рожу, отправить мне e-mail или сходить на мою домашнюю страничку в интернете :-) =========================================================================== Переход между окнами : - через список файлов в меню Windows - через список окон (меню Window->List или Alt-0) - вперед-назад (меню Window->Next/Previous, F6/Sh-F6) - если окна масимализированы - панелью табстопов (между редактором и панелью дерева/сообщений) Панель дерева-сообщений : - можно менять размер как всей панели по вертикали так и относительных размеров окна дерева и окна сообщений - можно поместить дерево в трее или в левой части основного окна - крайняя левая вертикальная панель-кнопка - прячет и показывает окно дерева - крайняя кнопка слева на полосе статуса - прячет и показывает всю панель, - команды в меню Window->Pr.Tree/Message/Close Tray - кнопки на панели редактора (если Вы их уда поставили :) Окно "дерева" : -показывает иерархию проекта. -по нажатию правой кнопки мыши появляется меню (пока 1 пункт), если нажать, то если этого файла нет сейчас в редакторе он загрузится, если есть - станет активным - файлы из дополнительных секций открываются по ассоциацаа с их расширением Панели управления : - слева на каждой панели есть кнопкка спрятать-показать. - потянув за левую кнопку каждой панели можно сделать ее "плавающей" - панели могут быть расположены как вверху, так слева или справа. Файл описания проекта (Notes) : при создании генерируется небольшой шаблон. Файл проекта : эго текст не виден, в нем записывается вся нужная информация - название основного файла проекта, опции (?), тип проекта и др. ========================================================================== Конфигурация (меню Options-> Main Setup) Change Setup - загрузка другой конфигурации Edit Setup - редактирование произвольной конфигурации Edit Current - редактирование текущей конфигурации New Setup - создание новой конфигурации New, based on - создание новой конфигурации, используя данные имеющейся. ----- Страница Editor Setup : Configuration Name - название конфигурации Syntax Defining Files - файлы описания синтаксиса Auto Save - вкл/выкл автосохранения, переключение автосохранения всех фвйлов или только текущего, задание периода автосохранения. Editor Properties - настройка свойств редактора, темплетов. ---- Страница Test Processing : Tree Strings - слова, предшествующие имени файла Cancel Tree Delimetrs - если стоят ПЕРЕД Tree Strings - то эта строка не включается в дерево File Delimetrs - символы, которые могут окружать имя файла Extract Macroses - файл конфигурации извлечения макросов Plug_in's List File - файл списка плагинов для данной конфигурации. Search Directories - список каталогов, в которых производится поиск файлов при загрузке из Tree. Каталоги разделяются ";". Для упрощения ввода рядом со строкой ввода находится кнопка выбора каталогов. Страница External Tools : Список внешних программ, икон на их кнопках и горячих клавиш Add - добавить Edit - изменить Delete - улалить В режиме добавления/редактирования : Title - название программы Program - имя файла программы или (CME-файла) Prefix - префикс, если нужен. Для досовских программ - "command /c", может где-то понадобиться "start /m" или что-то еще. Working Dir - рабочий каталог программы, обычно $PROJDIR Parametrs - параметры запуска программы Filter - имя программы-фильтра, для перехода от файла сообщений программы к файлу сообщений и ошибок ASMEDa Tool Button - настройка иконы на кнопке данной программы Hot Key - горячая клавиша. Чтобы они не пересекались - следите сами! Help File - файл помощи по данной программе, его горячая клавиша такая-же как и у программы но с Shift, поэтому поаккуратнее с использованием шифта для запуска самой программы! мета-имена в параметрах : $PROJFILE - имя основного файла проекта $PROJFILW - имя основного файла проекта без расширения $PROJEXT - расширение имени основного файла проекта (без точки!) $PROJ2FILE - имя 2-го основного файла проекта $PROJ2FILW - имя 2-го основного файла проекта без расширения $PROJDIR - каталог проекта $PROJECT - имя файла проекта $EDFILE - имя файла в текущем окне редактора $EDFILW - имя файла в текущем окне редактора без расширения мета-команды в параметрах #WAIT - метакоманда, запрещающая повторный запуск программы #LOCK - матакоманда, блокирующая все управление #SAVEALL - метакоманда, сохраняющая все файлы перез запуском tools #SAVECUR - метакоманда, сохраняющая текущий файл перез запуском tools ---- Страница File Names : Названия и маски для диалогов открытия и закрытия файлов, по умолчанию сожержит файлы проектов (*.PRO), текстовые файлы (TXT,ME,LST,INI,JRN,DIZ) и все файлы (*.*) Default Extention - расширение имени файлов по умолчанию. ========================================================================== Запуск внешних программ: Если явно задано имя файла внешней програмы то происходит ее запуск. Некоторые программы могут потребовать префикса (command /c для ДОС-программ, start /option и т.п.), иногда требуется указать рабочий каталог программы. Параметры запуска задаются мета-именами, которые при запуске заменяются на реальные значения. Если задано имя файла программы-фильтра сообщений, то после выполнения основной программы будеет выполнена программа фильтр со своими параметрами, каталог запуска фильтра совпадает с каталогом запуска основной программы. Программа-фильтр может быть специальной программой (COM,EXE) или скриптом (MSF), написанном на встроенном псевдо-Бейсике. Если в процессе работы фильтра будет создан файл $asmed.err то он автоматически будет загружен в окно сообщений. Если требуется выполнить запуск подряд нескольких программ, то все поля кроме имени программы следует оставить пустыми, а в нем указать имя командного (CME) файла. CME-файлы : командные файлы для запуска последовательности команд. каждая строка имеет следующий формат : [pref],prg_name,[w_dir],[param],[Flt_pref],[Flt_name],[Flt_Param] [;comments] Если вся строка комментариев - ПЕРВЫЙ символ = ";" Должно быть 6 запятых ! Примеры : 1.запуск mpasmwin в каталоге проекта, парметр - имя основного файла проекта, после этого запуск фильтра mpsm2msg с префиксом command /c и параметром - имя основного файла проекта без расширения, с добавлением расширения ".err" : ,mpasmwin, $PROJDIR, $PROJFILE,command /c,mpsm2msg, $PROJFILW.err 2.запуск piclab в какталоге проекта, без параметров и фильтра, с комментарием. command /c, piclab.exe, $PROJDIR,,,, ; Programmer MSF-файлы : скрипт фильтра, для преобразования выходных файлов сообщений и ошибок внешних программ. Представляет собой программу (текстовый файл), написанную на встроенном псевдо-Бейсике. Программа обрабатывает одну строку входного файла, задаваемого параметрами запуска. Возможно применение переменных, функций и условий. Зарезервированное слово REM - отменяет выполнение данной строки. Имя переменной - до 8 символом,первый не должен быть цифрой. Зарезервировано две переменных сответственно для входной и выходной строк - INPUT и OUTPUT. Условия : .... IF (выражение) .... .... ELSE .... .... ENDIF .... Вложенность условий не допускается! Функции : $Copy(source,form,count) - Копирование count символов начиная с from $Copy2Symb(source,symbol) - Выделение строки от начала до символа $CopyASymb(source,symbol) - Выделение строки от символа до конца строки $Delete(source,from,count) - Удаление count символов начиная с позиции from $Pos(substring,source) - Позиция подстроки sunstring в строке source $ConCat(a1,a2,...a10) - Соединение до 10 строк в одну $AddSpace(source,count) - Дополнение строки пробелами справа до длины count $DelRSpace(source) - Удаление начальный и конечных пробелов $Length(source) - Длина строки $Insert(string,source,pos) - Вставка строки string встроку source с позиции pos A+B, A-B - СУММА и РАЗНОСТЬ целых чисел. Вложенность функций не допускается! Для удобства ввода программы в окне редактирования есть строка SOURCE, в которую нужно ввести пример строки, выдаваемой внешней программой в файле сообщений и ошибок. Строка DEST (destination) - что получится при выполнении программы. Слева - представлена подсказка по функциям и их аргументам. В центре - окно для ввода программы. Справа - кнопки : Test - запуск программы Clear - очистка окна ввода программы Save - выход с сохранением программы Exit - выход без сохранения программы ============================================================================= Система помощи: В данной программу многоступенчатая система помощи. Если внешняя программа, подключаемая через Setup->Extrnal Tools имеет свой hlp-файл, то он может быть подключен и вызван через меню Help->Tools Help-> или через кнопки панели Tools. По нажатию F1 вызывается hlp-файл программы asmed, также для каждой конфигурации можно определить в Setup->Help-Add-On файлы помощи, вызываемые по Ctrl-F1, Shift-F1 и Alt-F1, при этом по Ctrl-F1 вызывается контекстная подсказка по ключевому слову, на котором стоит курсор. Все файлы помощи должны быть в формате Windows Help. ============================================================================= Структура каталогов программы: .....\ - EXE, CME, MSF, HLP файлы \PLUGINS\ - PLD, DLL, INI файлы от dll \CONFIGS\ - CFG, EMC, WRD, OPR файлы \PROJECTn\ - PRO, TXT, и другие файлы проекта \PROJECTm\ - .... ============================================================================= Зарезервированные расширения имен файлов: PRO - файл проекта CFG - файл конфигурации TPL - файл темплетов EMC - файл определений для извлечений макросов PLD - перечень plug-in_ов CME - командный файл для внешних программ PRL - файл пролога синтаксиса WRD - файл определений синтаксиса EPL - файл епилога синтаксиса MSF - файл скрипта фильтра сообщений ============================================================================== (с)1998 Alex Torres, 2:461/28@Fidonet, altor@geocities.com, altor@chat.ru http://www.geocities.com/SiliconValley/Lab/6311 ==============================================================================