WhatsNew2042.txt
--------------------------------------------------------------
RadASM 2.0.4.2 bugtest

Что нового:

- Полностью переписан код парсинга свойств.
- Код свойств, называемый завершением границ может быть сделан необязательным($ endp ---> ? endp).
- Код свойств автоматически обновляется (Option/Code Editor Options/Code Properties/Auto refresh list).
- Улучшен парсинг имен глобальных структур (mystr MYSTRUCT <1,2,3>).
- Статические контролы теперь могут содержать вертикально центрированный текст.
- Улучшена поддержка hla.
- Улучшена поддержка fasm (используются masm api файлы).
- Поддерживается метод "перенеси и отпусти" для текста.
- Project / Scan Project. Сканирует Проект при поиске слова. Результат отображается в окне output.
- Добавлен обработчик исключений от donkey в эддин FlipCase.
- Добавлена возможность подсветки активной строки.
- Добавлена установка пути отладки (debug path setup).
- Обработка расширений файлов сделана более гибкой для тех, кто использует RadASM для редактирования не только ассемблерных, но и других исходников. Пользователи Hla должны изменить секцию [Open]. Смотрите ниже.
- Добавлено окно со списком файлов include / includelib. Вы должны обновить секцию  [Api] в  assembler.ini
- Проектный визард теперь имеет диалог выбора шаблонов.
- Проектный визард теперь может иметь максимум 16 типов проектов.
- Меню Make может иметь максимум 16 пунктов меню.
- Добавлен эддин DialogPreview от Donkey.

Известные проблеммы:

- Свойства для кода 'messages' не работают.

Ini-файлы ДОЛЖНЫ быть добавлены вручную  следующие секции.

masm.ini

[Code]
Code=? endp,$ proc
Const={C},$ equ
Data={C},$ db,$ dw,$ dd,$ dq,$ df,$ dt,$ byte,$ word,$ dword,$ qword
Macro=endm,$ macro
Struct=? ends,$ struct,$ struc

[CodeBlock]
1=$ proc,? endp,,,6
2=.if,.endif,.elseif,.else,0
3=.while,.endw,.break,,0
4=$ struct,? ends,,,6
5=$ struc,? ends,,,6
6=$ macro,endm,,,14
7=.data,,,,16
8=.data?,,,,16
9=.const,,,,16
10=.code,,,,16
11=BEGIN,END,,,0

Добавьте это в секцию [Api]
Inc=include
Lib=includelib

tasm.ini

[Code]
Code=? endp,$ proc
Const={C},$ equ
Data={C},$ db,$ dw,$ dd,$ dq,$ df,$ dt,$ byte,$ word,$ dword,$ qword
Macro=endm,$ macro
Struct=? ends,$ struct,$ struc

[CodeBlock]
1=$ proc,? endp,,,6
2=$ struct,? ends,,,6
3=$ struc,? ends,,,6

Добавьте это в секцию [Api]
Inc=include
Lib=includelib

fasm.ini

[Code]
Code=return,proc $
Const={C},$ =,$ equ
Data={C},$ db,$ dw,$ dd,$ dq,$ rb
Macro=},macro $
Struct=},struc $

[CodeBlock]
1=proc $,return,,,14
2=section,,,,16
3=struc $,},,,6
4=macro $,},,,6

Добавьте это в секцию [Api]
Inc=include,','
Lib=

GoAsm.ini

[Code]
Struct=? ends,$ struct
Code=? endf,$ frame
Const={C},$ =,$ equ
Data={C},$ db,$ dw,$ dd,$ dq
Macro=endu,$ usedata

[CodeBlock]
1=$ frame,? endf,,,6
2=$ struct,? ends,,,6
3=usedata,endu,,,6
4=#IFDEF,#ENDIF,#ELSE,0
5=#if,#endif,#else,#elseif,0
6=$ section,,,,16
7=.code,,,,16
8=.const,,,,16
9=.data,,,,16

Добавьте это в секцию [Api]
Inc=#include,","
Lib=

hla.ini

[Code]
Code={C},procedure $
Const={C},$ :=
Data={C},$ :dword,$ :string,$ :word,$ :byte
Macro=#endmacro,#macro
Struct=endrecord,$ :record

[CodeBlock]
1=begin,end,,,6
2=if,endif,elseif,else,0
3=$ :record,endrecord,,,6
4=#macro,#endmacro,,,6

[Open]
0="Source Files (*.hla;*.hhf),*.hla;*.hhf"
1="Resource Files (*.rc),*.rc"
2="Assembly Files (*.asm;*.inc),*.asm;*.inc"
3="Text Files (*.txt),*.txt"
4="All Files (*.*),*.*"
src="Source (*.hla),*.hla,hla"
hdr="Header (*.hhf),*.hhf,hhf"
mod="Module (*.hla),*.hla,hla"

Добавьте это в секцию [Api]
Inc=#include,(",")
Lib=

KetilO
Перевод на русский язык: amdtm , amdtm@mail.ru

-------------------------------------------------------

DlgToWin.txt
-------------------------------------------------------
Этот addin (эддин, плугин) создает весь код, необходимый для создания  приложения,  основанного на окне диалога, в RadASM.

Как инсталлировать:
Скопировать DlgToWin.dll в C:\RadASM\AddIns
Скопировать *.rad в C:\RadASM\Templates

Отредактировать в файле RadASM.ini секцию [AddIns]

[AddIns]
1=FlipCase.dll,3
2=asciiTab.dll,1
3=MsdnHelp.dll,1
4=DlgToWin.dll,1

Как использовать:

В RadASM, откройте окно диалога в редакторе.
Выберите в меню Tools пункт "Dialog to window"
Выберите нужные настройки в появившемся окне и нажмите OK.
Результат появится в окне вывода (output window).
Скопируйте весь или выделенный код в свой asm-файл.
Вы можете отредактировать шаблоны (templates) в соответствии со своим стилем программирования.

KetilO
Перевод на русский язык: amdtm , amdtm@mail.ru
-----------------------------------------------------

ConfigMenu.txt
-----------------------------------------------------
Меню RadASM, настраиваемые пользователем.
-----------------------------

В RadASM Вы можете модифицировать меню: Make, Tools, Макро и Help.

Меню Make (Сделать).
----------
Старайтесь не изменять  меню Make, т.к. оно содержит сложно закодированные команды.
Тем не менее, Вы можете назначить свои собственные акселераторы, изменить текст меню и вставить разделители(сепараторы) между пунктами меню.

Меню Tools (Инструментальные средства).
-----------
Две самых верхних части меню Tools, которые могут быть изменены пользователями, также имеют кнопки (I и II) на панели управления с кнопками быстрого доступа (toolbar).  Не рекомендуется использовать эти пункты меню для добавления подменю.

Меню Macro (Макрос).
-----------
Часть меню Macro, которая может быть изменена пользователями, используется для воспроизведения предварительно записанных макросов, которые содержат последовательность нажатых клавиш. Вы можете сгруппировать макросы, используя подменю (т.е. "раскидать" по подменю).

Меню Help.
----------
Часть меню Help, которая может быть изменена  пользователями, использована для того, чтобы открывать файлы Справки. Вы можете использовать любой тип файла, с которым может работать Windows. Справочные файлы можно сгруппировать, используя подменю.

Создание подменю.
--------------------

Пример (меню Tools):

Menu item    Accelerator    Command    Description
Пункт меню Акселератор Команда    Описание
-----------------------------------------------------------------------------------------------
&Caculator Ваш выбор CALC.EXE    Открывает стандартный калькулятор windows.
&Notepad Ваш выбор NOTEPAD.EXE Открывает стандартный блокнот.
&Masm32 Нет(None)        Пункт меню, открывающий подменю.
..&Build Ваш выбор $B\build.bat,$ Строит проект masm32.
..&Run Ваш выбор ,$.exe    Запускает exe-файл.
&Goto Dos Ваш выбор COMMAND.COM Открывает окно команд dos.

KetilO
Перевод на русский язык: amdtm , amdtm@mail.ru
------------------------------------------------------------

E-HELP.TXT
------------------------------------------------------------
Эддин(модуль расширения, плугин) для radasm:

Этот эддин написан на power basic-е, поскольку таким образом я могу повторно использовать значительный объем кода, ранее написанный для своих собственных целей для аналогичного расширения пакета masm, разработанного hutch-ем.

Так или иначе, он объединяет функциональные возможности эддинов msdnhelp и melt.
Его главное отличие состоит в том, что он может работать не только с masm, но и с другими асемблерами. Эддин не является "черным ящиком", поэтому  при желании вы можете внести необходимые изменения в его работу.   
Эддины melt и msdnhelp должны быть отключены для правильной работы этого эддина!

Возможности эддина:
При нажатии клавиши "F1" в момент, когда курсор находится в кодовом окне на строке, в которой допущена ошибка (прим. переводчика: выявленная после ассемблирования), появится окно сообщения, содержащее соответствующий текст ошибки для этого номера ошибки, выданного masm (или другим ассемблером) в окно вывода output#1. Если в строке больше одной ошибки, нажимая "OK" вы получите текст следующей ошибки и так далее. Содержимое файла "error.txt" зависит от ассемблера и может быть отредактировано и дополнено вручную. Файл "error.txt" должен быть прописан в соответствующем .ini файле. Этот пакет содержит файл "error.txt" для masm, включая все общие ошибки для ml.exe, link.exe и rc.exe. Вы можете легко написать аналогичный  файл  ошибок для других ассемблеров или компоновщиков(линкеров) (формат файла ошибок описан ниже). Двойное нажатие мыши на номере ошибки в выходном окне также покажет соответствующий текст ошибки.

Если курсор находится вне  строки с ошибкой и вне  границ слова, по "F1"  выводится справка radasm.
Если  выделено ключевое слово из списка  ключевых слов radasm-а для подсветки синтаксиса из соответствующего .ini файла, то оно будет использовано  для поиска справочной информации в файле справки ассемблера. Если ключевое слово найдено, будет выведена справочная информация из справки ассемблера для этого ключевого слова. Иначе будет произведен поиск в списке ключевых слов машинных операций, если выделенное ключевое слово является машинной операцией. Если это ключевое слово найдено, будет выведена подсказка для этой машинной операции. Если ключевое слово не найдено в обоих списках, как в  списоке ключевых слов ассемблера, так и в списке машинных операций, то будет выведена справка win32api.

Если текущий файл является .rc файлом, то вместо справочного файла ассемблера будет использован справочный файл rc  и список  ключевых слов для rc. Иначе выводится справочная информация из справочного файла win32api.

Нажатие "Ctrl+F1" выводит справку  Msdn.

Я добавил(а) поддержку колесика мыши для всех .hlp файлов (включая те, что выводятся в меню Help)

Кроме того я закодировал(а) специальную возможность для комментариев. Клавиша "Tab"  или сочетание клавиш "ctrl+k" (это можно выбрать в менеджере эддинсов), вставляют соответствующий символ комментария (asm/rc файл) в текущую строку в указанной позиции и перемещают каретку в  эту позицию. Если в этой строке уже есть комментарий, комментарий репозиционируется, если он расположен не в правильной позиции, и каретка перемещается в эту позицию. Клавиша "Tab"  в листбоксах (listboxes) в кодовом окне работает как прежде. Я выбрал(а) клавишу "Tab" , поскольку я ее не использую при редактировании кода. Если Вы поступаете иначе, выберите "ctrl+k" или полностью отключите эту возможность. Менеджер эддинов позволяет сделать выбор между тремя позициями комментария.
 

Как установить "error.txt".
Добавьте клавишу "Текста"в секцию [Error] в .ini файле своего ассемблера

[Error]
1=...
;укажите путь + имя вашего файла с текстом ошибок
Text=$R\masm\bin\error.txt

[HelpFiles]
;справочный файл ассемблера
1=$H\Masm32.hlp
;справочный файл по машинным операциям (опкодам)
2=$H\x86eas.hlp
;справочный файл win32api
3=c:\tools\win-ide\docs\api reference\win32-help\win32.hlp
;справочный файл msdn
4=C:\Programme\Microsoft Visual Studio\MSDN98\98VSa\1031\msdnvs6a.col
;справочный файл rc
5=$B\Rc.hlp
;справочный файл radasm
6=$R\help\radasm.chm

Выражаю особую благодарность KetilO, который оказал мне значительную помощь в улучшении и отладке этого эддина!

elisabeth
Перевод на русский язык: amdtm , amdtm@mail.ru
----------------------------------------------------------

HlaReadMe.txt
----------------------------------------------------------
Использование RadASM для редактирования HLA кода.

Hla использует nmake и make-файл для построения проектов. В hla.ini вы можете найти секцию [Enviroment].
Вы должны изменить ее вручную для отображения вашей конфигурации.

Если вы вручную редактируете RadASM.ini, то внесите следующие изменения:
[FileBrowser]
Filter=.asm.inc.rc.txt.doc.rtf.dlg.mnu.rap.bmp.ico.cur.hla.hhf.
[Assembler]
Assembler=masm,fasm,tasm,nasm,hla
[Template]
Txt=.asm.inc.def.rc.txt.mak.tbr.hla.hhf.

KetilO
Перевод на русский язык: amdtm , amdtm@mail.ru
----------------------------------------------------------

LibProject.txt
----------------------------------------------------------
(Прим переводчика: Похоже, что это сообщение с форума).

Сначало, я хочу сказать, что я поражен количеством настраиваемых парвметров в ваших ini-файлах. Это послужило причиной  появления подобного сочинительства. Во всяком случае,  я полагаю, что теперь я все понял. Таким образом, если Вы хотите добавить тип "LIB Project" ("Проекта LIB" - тип похожий на  DLL Project), это должно выглядеть следующим образом:

(В RadASM.ini секция MakeFiles)

0=.rap
1=.rc
...
;9 добавлен Irving W. - Для проектов библиотек LIB Projects
9=.lib

(В MASM.ini секция Project)

;LIB Project добавлен Irving W.
Type=Win32 App,Console App,DLL Project,LIB Project

(В MASM.ini, добавьте новую секцию "LIB Project" и поместите это в нее)

;Секция LIB Project добавлена Irving W. - Для LIB-проектов
Files=1,1,0,1,0
Folders=1,0,0
MenuMake=0,1,1,1,0,0,0,0
;x=MakeFileToDelete/CheckExistsOnExit,
;(O)utput/(C)onsole/0,Command,
;MakeFile1[,MakeFile2[,MakeFile3...]]
1=4,O,$B\RC.EXE /v,1
2=3,O,$B\ML.EXE /c /coff /Cp /nologo /I$I,2
3=9,O,$B\LIB.EXE,3
4=0,0,,5

Приблизительно так?
По большому счету я изменил командное число 3 (линкер), чтобы использовать lib.exe
вместо link.exe, чтобы производился поиск .lib-файла вместо .exe- или .dll-файла.
В самом деле, как это будет работать? Я протестировал мои изменения, и пока что все работает правильно. В скором времени я собираюсь создать свою собственную библиотеку, и тогда  проверю все сам и узнаю, насколько все это хорошо работает.

Одновременно я добавил пункт в меню "Tools"  для копирования .LIB и  .DEF-файлов в папки MASM32\Lib и MASM32\Include соответственно, так чтобы можно было использовать их в других проектах с  помощью include  и includelib.
Это  простой пакетный файл.
Все выглядит похожим на то, чтобы разместить его в меню "Make", если  Вы этого действительно пожелаете, но люди могут  захотеть сделать все типы проектов как только их БИБЛИОТЕКИ будут готовы.
Только что мне показалось удобным  разместить все функции PROTO в файле .DEF, так чтобы они были отделены от глобальных данных, определенных (указанных) в LIB. Однако я не уверен в правильности такого выбора, тк не знаю, планируете ли Вы использовать .DEF-файл или нет.  Ведь, другие люди могут использовать это иным образом.

Irving W
Перевод на русский язык: amdtm , amdtm@mail.ru
----------------------------------------------------------

OpenFile.txt
----------------------------------------------------------
В файле RadASM.ini вы можете определить эту секцию:

[Open]
1=.bmp.,MSPAINT.EXE
2=.doc.rtf.,WORDPAD.EXE

Если вы откроете файл с расширением .bmp, этот растровый рисунок будет показан в графическом редакторе MSPAINT.
Также Вы можете добавить растровый рисунок в свой проект и двойной щелчек мыши в Project Browser (Броузер проекта) также откроет MSPAINT.

Общий синтаксис (Формат) этого:

x=.Ext1.Ext2.Ext3.,ProgramToLaunch

где
x - числовой номер;
.Ext1. - расширение файла, типа .bmp.;
ProgramToLaunch - запускаемая программа для указанных расширений. 

KetilO
Перевод на русский язык: amdtm , amdtm@mail.ru
---------------------------------------------------------

Projects.txt
---------------------------------------------------------
Проекты RadASM V 1.0.6
-------------------------------------------------------------------

Распакуйте файлы архива утилитой Unzip  в папку: C:\RadASM

Этот файл содержит:
-------------------

-Проекты (Projects);
-Сниплеты (Sniplets);
-Шаблоны (Templates)

Проекты (Projects):
-------------------------------------------------------------------

-AviCap. Если у Вас есть web-камера или TV-тюнер, то  сможете хорошо  провести время.
-Twain. Если у Вас есть сканер или камера, то  сможете грабить картинки с помощью этого проекта.
-RichEditEditor. Знакомит с базовыми функциями редактора. Отличный
проект для новичков.
-TreeViewDir. Показывает как создавать TreeView директории.
Также включает изменяющую размеры панель (resize bar) и просмотровщик  (вьювер) текста.
-Textio. Показывает как создавать консоль. Очень простой проект.
-CodeSplit. Показывает как разделить окно RichEdit на две части.
-UserControl. Показывает один из способов использования новых пользовательских контролов.
-GradProgress. Показывает другой способ использования пользовательских контролов.
Make от Тола (Tola). Конвертирован в MASM  bitRAKE-ом. Также включает switch case  макрос от  bitRAKE-а.
-FlipCase. Эддин-проект RadASM-а.
-ClientRect. Начало создания edit-контрола?
-CtlColor. Показывает, как установить цвета фона и переднего плана(текста) в edit- и  static-контролах.
-ScreenMag. Показывает, как увеличить часть вашего экрана.
-Icon. Показывает как использовать контрол пиктограммы и как положить битмэп (растровый рисунок) на окно диалога.
-MsdnHelp. Эддинс от Qweerdy.
-asciiTab. Эдинс от MArtial_Code.
-Debug. Отладочные макросы Vkim-а.

Перевод на русский язык: amdtm , amdtm@mail.ru
---------------------------------------------------------

RadAscii.txt
---------------------------------------------------------
Тест RAdasm Эддина (модуля расширения, плагина)

Эй, Я возился с эддинами для Radasm...Это очень простое программирование...
KetilO сделал отличную работу...

Я посылаю свою тестовую dll вместе с исходниками...

Для Кетила Олсена:
Во время написания эддина я обнаружил следующее. Когда открывался проект,
происходило обновление меню... таким образом, любые эддины, которые я делал
были уничтожены... Я не нашел, где в вашем тестовом эддине, вы имеете дело с
этим, но я нашел способ обойти это... Я думаю, что RadASM-у необходимо посылать
сообщение PROJECTOPENED...

Так что же вы увидитев программе... Я использовал id-идентификатор пункта меню
в качестве id для кнопки на панели управления toolbar, я не имел никаких проблем,
так как ID является  уникальным в моей проге...
Секция панели управления toolbar является немного неряшливой, т.к. "вы редко
имеете дело с динамическими панелями toolbars..

Между прочим, есть предложение... расположенное строкой ниже. Можете ли вы добавить секцию в свойствах диалогов, где можно будет вводить дополнительные стили?
Этот способ освободит вас от необходимости писать дополнительный код для поддержки
малоиспользуемых стилей... 

У меня было несколько других задумок, но Я не могу вспомнить прямо сейчас....
возможно, завтра...

The Martial
Перевод этого сообщения с форума на русский язык: amdtm , amdtm@mail.ru
--------------------------------------------------------

RadASM.txt
---------------------------------------------------------
RadASM V 1.0.9
-------------------------------------------------------------------

Распакуйте архив RadASM.zip утилитой Unzip  в папку C:\RadASM

Возможности:
-------------------------------------------------------------------

-Поддерживаются masm, tasm и fasm.
-Используются Mdi и RichEdit20 ver 3.0
-Может эмулировать вкладки редактирования IDE.
-Подсветка синтаксиса.
-Полностью написан код Api с выпадающими подсказками при вводе.
-Полностью написан код для Api-констант.
-Свойства кода (Code properties) предоставляют быстрый доступ в вашем проекте к подпрограммам, макросам, структурам, константам и данным (procs, macros, structs, conststants, data).
-Легко можно создавать и использоватьпроектные шаблоны.
-Легко можно получить доступ к сниплетам кода.
-Пункт меню Find Declare/Return
Стековый поиск подпрограмм proc, макросов, структур или меток и возвратов.
-Закладки. Стало проще перемещаться назад и вперед в вашем коде.
Поименованные закладки сохраняются в вашем проекте.
-Поиск и замена осуществляются во всех .asm- файлах и .inc-файлах проекта в одну команду.
-Создавайте поименованные ссылки в текстовых файлах проекта и прыгайте по ссылкам с помощью единичного нажатия клавиши.
-Редактор Диалоговых окон с более чем 20-ю доступными для выбора контролами.
-Определяемые пользователем контролы.
Создайте свои собственные контролыи ложите их на свои диалоговые окна.
-Редактор меню.
-Редактор информации о версии программы.
-Простой доступ к более, чем  к 4 справочным файлам по F1.
-Ассемблирование, линковка и запуск путем клика по кнопке на панели инструментов или с помощью акселераторов.
-Окно контролов Tool может быть:
Скрыто, пристыковано к границам окна, перемещено, изменен его размер и скомпановано.
-Настройка пользователем меню make, tools и help.
-Запись макроса с последовательностью клавиш.
-И так далее.

-------------------------------------------------------------------

В этом релизе все еще отсутствует справочный файл.
Я полагаю, что опытным программистам и так все хорошо понятно.
При установке ini-файлов подразумевается, что вы установили MASM32 в папку:
C:\Masm32
а RadASM установлен в:
C:\RadASM

Не столь важно.
-------------------------------------------------------------------

F1 в комбинации с Ctrl и Shift позволяет окрывать 4 справочных файла.
Отредактируйте RadASM.ini, если вы хотите изменить настройки по-умолчанию.

Щелкните по кнопке пункта  на панели Свойств кода (code properties tool) для просмотра параметров proc или макроса macro или просмотра членов структуры.

Сделайте двойной щелчек по пункту панели Свойств кода (code properties tool) для загрузки модуля и расположения каретки  в нужной позиции.

Сделайте двойной щелчек на сообщении с ошибкой, полученной от Rc or Ml, в Окне Вывода для загрузки модуля и расположения каретки в строке с ошибкой.

Все файлы проекта должны быть в папке проектов.

Редактор диалогового окна Dialogbox имеет опцию для защиты контролов от изменений (опцию залочки контролов), пункт Format/Lock Controls контекстного меню. Если нет возможности изменить размер или переместить контролы, то проверьте меню Format.
Панели инструментов Toolbars и панели состояния statusbars всегда залочены (защищены) и не могут быть перемещены или изменить свой размер.
Shift или Ctrl + назначенная клавиша перемещают или изменяют размер контрола.

Когда появляется список api-функций или список констант, нажмите клавишу
Tab или Ctrl+Space для копирования выделенного пункта в текст своего кода.
Нажмите стрелку курсор вниз для входа в окно списка. Когда вы находитесь в
окне списка, нажатие F1 выводит справку по выбранной api-функции.

Когда при вводе кода появляется подсказка по api-функции, нажмите Ctrl+Space для копирования подсвеченного слова в ваш код.

Есть опция для отключения прокрутки колесиком мыши. Отключите ее, если программное обеспечение вашей мыши обрабатывает сообщения от колесика мыши.

Откройте и просмотрите RadASM.ini и masm.ini , тк они имеют некоторые
дополнительные коментарии, которые могут помочь вам лучше понять опции компилятора/линкера и так далее.

Известные проблемы:
-------------------------------------------------------------------
-Не всегда появляются полосы прокрутки, когда вставляется текст в пустое окно редактора. Измените размер окна и они снова появятся.
-Проблемы с размером Шрифта. Не всегда вы можете получить выбранный шрифт.
-Tab tool  не всегда правильно прорисовывается, если перемещено в левый или правый угол. Перезапустите RadASM и tabs правильно прорисуется.

Устраненные Баги  и Улучшения:
-------------------------------------------------------------------
-Устранены некоторые незначительные баги.

Новые опции:
-------------------------------------------------------------------
-Автоматическое разворачивание групп проектных файлов.
-Установка цвета фона для панелей инструментов и диалогового
окна редактора.
-настройка пути к макросам.

Новые возможности:
-------------------------------------------------------------------
-Многоуровневая отмена для удаленных контролов окна диалога.
-Одновременный  выбор нескольких контролов на диалоговом окне.
Ctrl+LeftClick  на контроле или
Ctrl+Draw на диалоге. Выбранное можно переместить, вырезать, скопировать,
удалить, выровнять или сделать одинакового размера.
-Новое окно контролов (tool window) показывает открытые файлы как
табулированные кнопки в своем окне.
Если вы выберете Option / Code Editor / Always Maximized вы получите что-то очень     похожее на  IDE редактор с вкладками. Вы можете расположить окно контролов, где пожелаете, но помните, что  RadASM должен быть перезапущен, если вы
переместили их в левый или правый угол.
-Запись макросов с последовательностью нажатых клавиш.
Макросы могут быть снабжены акселераторами. Также предусмотрен простой менеджмент для макросов. Помните, что суммарное количество пунктов в меню
Make, Tools и Macro никогда не должно превышать 50-ти.
-Опция "Автоматическая загрузка файла" в окне редактора при открытии проекта   от NEMO получила дальнейшее развитие.
Теперь вы можете выбрать файлы, которые нужно  автоматически открывать при
открытии проекта с помощью  пункта Auto Load в контекстном меню панели Project
(правый клик мыши). Опция Auto Open для главного asm-файла была удалена
из эддина  FlipCase.
-Опция Auto Show / Hide ToolBox от NEMO была улучшена путем добавления небольшой задержки.
-Для сообщения AIM_TIMER  RadASM-а изменена задержка с  500мс на 100мс.

Эддины:
-------------------------------------------------------------------
RadASM Direct от _Shawn.
asciiTab от Martial Code.
msdnHelp от Qweerdy
FlipCase от KetilO.
DlgToWin от KetilO.

Отладка:
-------------------------------------------------------------------
отладочные макросы vkim-а выводят свои сообщения в окне вывода
RadASM. Теперь после обновления опции дополнительно отображаются
имя файла и номер строки.

Совет:
-------------------------------------------------------------------
-Если вы ассоциировали  .rap-файлы с RadASM вы сможете ложить на
Рабочий стол ярлыки для ваших проектов.
Одновременно это работает и для  .asm-файлов.

-RadASM.ini содержит секцию [Open]. Здесь вы можете указать
расширения файлов, которые будут открываться внешними (другими)
приложениями.

-Добавленный проект эддина 'FlipCase' имеет некоторую информацию о том, как создавать эддин. Эддин содержит 4 функции:
1. Flip case (изменять регистр) выделенного текста.
2. Auto show / hide output window (Автоматически показывать/прятать окно вывода).
3. Auto show / hide toolbox (Автоматически показывать/прятать окно инструментов).
Отключите ненужные функции редактированием RadASM.ini

Благодарности:
-------------------------------------------------------------------
bitRAKE за его справку по ключевым словам masm и  NMAKE project (проект).
Irwing W. за его работу над LIB Project.
sch.jnn за его идеи и тестирование программы.
sch.jnn за его работу над записью и воспроизведением макросов  нажатых
клавиш на клавиатуре.
Willie за его идеи и тестирование предварительных релизов.
Qweerdy за его плагин "Справка msdn".
vkim за его отладочные макросы.
MArtial_Code за его плагин asciiTab.
_Shawn за его RadASM Direct,  так что мне все еще не нужна своя  web-страница.
_Shawn за его эддин и  шаблон  Win32EXE.
LuHa за его for his splash screen.
NEMO за его улучшения  FlipCase.
Всем, чьи имена я не упомянул и за все их отчеты о багах
и идеи. Мне, делающему все возможное, чтобы отблагодарить вас всех. :D

Я разрабатываю и использую RadASM на  PIII 500Mhz
со 128Mb памяти, используя Win98SE, Win2k Professional и Windows XP.
RichEdit20 V 3.0 работает на всех ОС. RichEdit20 V 2.0 не будет работать
должным образом.
ini-файлы тестировались в течении короткого времени, поэтому при неправильном
ini-файле вы можете получить общую ошибку защиты GPF и непредсказуемые результаты.
Помните, что проектный файл  (.rap) также является простым ini-файлом.

Присылайте отчеты о багах и предложения по улучшению на e-mail адрес:

ketil.olsen@jm-data.no

Надеюсь, что это  инструментальное средство для ассемблера будет вам полезно.

Ketil Olsen
Перевод на русский язык: amdtm , amdtm@mail.ru

---------------------------------------------------------

RadLib.txt
---------------------------------------------------------
RadASM - очень гибкая система и вы можете увеличить ее функциональность,
применяя средства, аналогичные средству для создания статических библиотек.
Если вы хотите сделать библиотеку функций,  не связываясь с DLL,
вы можете использовать статическую библиотеку (с includelib). Я сделал это,
планирая написать свою маленькую библиотеку,  и Кетил Олсен посоветовал
прислать ему мои изменения сюда на тот случай, если другие люди также пожелают
написать свои .LIB-файлы. Я подробно опишу, как  модифицировать INI-файлы
для MASM (но, по все видимости, те же методы можно использовать  для FASM).
Предполагая, что так намного удобнее или легче для понимания, я также оставил
в RadLib.zip исходные копии встроенных файлов  RadASM.INI и MASM.INI, которые
я изменил этим способом . Вы можете заменить свои старые файлы новыми, но тогда
они перезапишут все остальные настройки в ваших  INI-файлах. Если вы не хотите
этого,  прочитайте нижеследующую информацию о том, как внести изменения 
за 3 простых шага.

1. Потребуется только одна крошечная модификация в RadASM.INI, поэтому я опишу ее
в самом начале. В секции [Makefiles] должен быть список с расширениями файлов (0=.rap,
1=.rc, 2=.asm, 3=.obj и тд), которые используются в RadASM. Необходимо добавить .lib в
конце этого списка. По-умолчанию в RadASM.INI, последним стоит "8=.txt" , так что .lib будет под номером 9. Добавьте это в секцию [Makefiles] в файле RadASM.INI:

--------------------------------------------------------------------------------
9=.lib
--------------------------------------------------------------------------------

2. Этот шаг все еще не делает ничего полезного. Следующий шаг - отредактировать
MASM.INI.  В этом файле необходимо отредактировать всего одну секцию и
добавить еще одну новую. Во-первых, название  проектного типа добавится в
список, выводимый RadASM в окне "New Project" (Новый проект). Я выбираю
"LIB Project" в качестве названия, но вы можете выбрать любое другое название.
В секции проекта [Project] файла MASM.INI, добавьте в список название проекта
следующим образом:

--------------------------------------------------------------------------------
Type=Win32 App,Console App,Dll Project,LIB Project
--------------------------------------------------------------------------------

3. В заключении, вы добавляете секцию с настройками для проектов библиотек
(LIB Projects). Я копирую/вставляю настройки проекта Dll Project и использую их
в качестве шаблона, для  полного соответствия. Замените в строкe c [DLL Project]
на [LIB Project] ( должно быть название проектного типа, т.е. "LIB Project" или любое
другое, которое вам нужно)  и далее в строке с командой замените LINK.EXE
LIB.EXE. Добавьте новую секцию в MASM.INI:

--------------------------------------------------------------------------------
[LIB Project]
Files=1,1,0,1,0
Folders=1,0,0
MenuMake=0,1,1,0,0,0,0,0
1=4,O,$B\RC.EXE /v,1
2=3,O,$B\ML.EXE /c /coff /Cp /nologo /I$I,2
3=9,O,$B\LIB.EXE,3
4=0,0,,5
--------------------------------------------------------------------------------

(Далее в этом файле следуют коментарии; Если вам интересно, вы можете
прочитать их, чтобы ознакомится с более подробным описанием формата секциии)

Я выделил полужирным шрифтом части, которые отличаются от Dll-проекта. Как вы
можете видеть, название отличается. Следующая отличающаяся строка "3="
(команда линкера).
Цифра "9" - это ссылка на строку "9=.lib" в файле RadASM.ini. Она
дает знать RadASM  удалить старый .lib-файл, если он существует перед линковкой,
и проверить его наличие после линковки. Если файл существует, это значит, что проект успешно слинкован.
Символ "O" означет, что нужно отображать выходные сообщения в окне вывода Output,
в результате чего вы сможете увидеть любые сообщения, генерируемые линкером.
$B заменяется путем к вашей директории Masm32\Bin, а цифра "3" означает использовать название вашего .OBJ-файла в качестве аргумента командной строки (3=.obj в списке с типами файлов) для линкера. Если вас заинтересовало это руководство, вы можете посмотреть коментарии в INI-файлах. Это только часть того, что я могу сделать в RadASM (хорошая работа, KetilO!).

Всего один раз настроив свои INI-файлы, вы сможете создаватьновые проекты библиотек
LIB Project точно также, как любой другой новый проект в RadASM. Это хорошая идея - поместить объявления ваших функций PROTOs в отдельный файл, так что вы можете включать их в любые проекты, использующие эту библиотеку. Далее используя  только директивы include и includelib, вы подготовите  библиотеку функций к использованию в других своих проектах.

Также я модифицировал меню "Tools" - добавил инструмент для автоматического
копирования include-  и library-файлов  из директории вашего проекта в директории
masm32\Include и masm32\Lib соответственно. Я энергично поработал над этим
небольшим дополнением, так чтобы в нем не было жестко закодированого копирования
в папки C:\masm32\Include и C:\masm32\Lib, а также чтобы могло появиться этот сообщение.
Я думаю, что это сообщение получилось достаточно длинным.

Irving W
Перевод на русский язык: amdtm , amdtm@mail.ru
---------------------------------------------------------

ToolsMenu.txt
---------------------------------------------------------
Команды меню Tools
----------------------

В RadASM.ini вы найдете эту секцию:

[MenuTools]
9=RadASM &Direct,0,T,C:\RadASM\AddIns\RadASM Direct.exe
8=-,0,T,
7=Masm32 &Run,0,T,,$.exe
6=Masm32 &Build,0,T,C:\Masm32\Bin\build.bat,$
5=-,0,T,
4=Note&pad (.rap),0,T,NOTEPAD.EXE,0
3=&Notepad,0,T,NOTEPAD.EXE,O
2=&Calculator,0,T,CALC.EXE
1=&Goto Dos,0,T,COMMAND.COM

Формат следующий:

X=MenuText,AcceleratorKeyNo,T,CommandToExecute[,Param1[,Param2[,...ParamX]]]

Param (необязателен) может быть именем файла, символом O для отображения OpenFileDialog или цифрой от 0 до 9 для получения файла из проекта. Проектные файлы:

0=xxx.rap
1=xxx.rc
2=xxx.asm
3=xxx.obj
4=xxx.res
5=xxx.exe
6=xxx.def
7=xxx.dll
8=xxx.txt
9=xxx.lib

Param также может быть символом  $. $ заменяется названием самого верхнего окна редактора без расширения. Это применяется в 6= и 7=
7= также иллюстрирует случай, когда не указана команда для выполнения (CommandToExecute). Это значит, что param будет командой(прим. переводчика: а не файлом).
Воспользуйтесь пунктом меню RadASM Option / Tools для добавления, удаления или внесения изменений в меню Tools.

KetilO
Перевод на русский язык: amdtm , amdtm@mail.ru
---------------------------------------------------------

VCDebug.txt
---------------------------------------------------------
Re: Отладка Win32Asm приложений  в Visual C++
Что касается меня, я поступаю следующим образом.

Сначало сделайте dgbldall.bat
==============================================
@echo off

if not exist rsrc.rc goto over1
c:\masm32\bin\rc /v rsrc.rc
c:\masm32\bin\cvtres /machine:ix86 rsrc.res
ver1

if exist %1.obj del %1.obj
if exist %1.exe del %1.exe

c:\masm32\bin\ml /c /coff /Zi %1.asm
if errorlevel 1 goto errasm

if not exist rsrc.obj goto nores

c:\masm32\bin\Link /SUBSYSTEM:WINDOWS /DEBUG %1.obj rsrc.obj
if errorlevel 1 goto errlink

dir %1.*
goto TheEnd

:nores
c:\masm32\bin\Link /SUBSYSTEM:WINDOWS /DEBUG %1.obj
if errorlevel 1 goto errlink
dir %1.*
goto TheEnd

:errlink
echo _
echo Link error
goto TheEnd

:errasm
echo _
echo Assembly Error
goto TheEnd

:TheEnd

pause
==============================================

Во-вторых,
Вставьте нижеследующий текст в "секцию меню" Edit файла Qedit.ini

&Debug Build All,c:\MASM32\BIN\DgBldall.bat {b}
==============================================

В-третьих, создайте  исполняемый файл своего приложения, выбрав новый пункт "Debug Build All"  в меню qedit.

Затем, "перенесите и отпустите" ( Drag & Drop) исполняемый файл своего приложения на ярлык Visual Studio...

Перевод на русский язык: amdtm , amdtm@mail.ru
---------------------------------------------------------

WordList.txt
---------------------------------------------------------
Эддин wordlist преследует две цели:

1. Автопреобразование регистра.
2. По желанию можно вызвать выпадающее окно со списком wordlist (Ctrl+Space).

Также в эддин wordlist добавлены свойства проектов / файлов, такие как:

1. Имена процедур или функций (Proc).
2. Декларированные имена глобальных данных.
3. Имена констант.
4. Имена Макросов.
5. Имена структур Struct.

Для того, чтобы обновить список, щелкните кнопку обновления на панели свойств.

Проверка автопреобразования регистра:
-----------------------
Проверка выполняется тогда, когда Вы нажимаете любую клавишу, если это не буква и не цифра.
Проверка не выполняется в комментариях или строках (те в значениях строковых констант/переменных).
Не выполняется никакого сопоставления  в декларированных именах глобальных данных.
Символы в верхнем регистре никогда не преобразуются в нижний регистр.

Окно со списком слов  Wordlist :
-----------------
Чтобы вызвать окно со списком слов wordlist нажмите Ctrl + Space.
Чтобы спрятать окно со списком, нажмите Esc.
Чтобы войти в окно со списком нажмите стрелку вниз.
Для того, чтобы скопировать выбранное слово нажмите Tab, Ctrl + Space или выполните двойной щелчек на слове.

Выбор слов в окне со списком (listbox) осуществляется по части слова, слева от каретки. Когда окно со списком показано, Вы можете вводить больше символов, чтобы ограничить (сузить) диапазон выбора похожих слов в списке или удалять символы, чтобы расширить диапазон выбор.

Опции:
--------
1. Wordlist Convert. Выполняет преобразование регистра, если установлен флажок.
2. Prop. На Wordlist. Свойства добавляются в список слов wordlist, если установлен флажок.

Установка:
--------
1. Скопируйте masmApiWord.api в C:\RadASM
2. Добавьте следующие строки к секцию [Api] в файле masm.ini

   [Api]
   Trig=invoke
   Call=masmApiCall.api
   Const=masmApiConst.api
   Struct=masmApiStruct.api
   Word=masmApiWord.api

Файл masmApiWord.api является простым текстом, так что Вы можете добавлять свои собственные слова.

KetilO
Перевод на русский язык: amdtm , amdtm@mail.ru
---------------------------------------------------------