                         Директивы редактора

Все директивы редактора начинаются с сочетания символов @. поэтому компилятором gnu as воспринимаются как комментарии и не обрабатываются

+-----------+--------------------------+
| @.CharSet | Задание кодировки файла  |
+-----------+--------------------------+

 Редактор может работать одновременно с файлами в разных кодировках, кодировка текущего файла указывается в строке статуса редактора.

Допустимые имена кодировок:

ISO8859-1  ISO8859-15  ISO8859-2  CP1250  CP1251  CP1252  CP1253  CP1254  CP1255  CP1256  CP1257  CP1258  CP437  CP850  CP852  CP866  CP874  KOI8  MACINTOSH  UCS2L  UCS2B  UTF8

Кодировка указывается без кавычек, через пробел от директивы @.CharSet

Директива может располагаться в любом месте файла, но должна быть первой в строке.

Текст после определения кодировки является комментариями по правилам gnu as

Пример использования: - задание кодировки UTF8

@.CharSet UTF8  этот текст уже является комментарием


+--------+-----------------------------------------------------+
| @.ITEM | Объединение определений символов в группу поддерева |
+--------+-----------------------------------------------------+

Формат:

equ TopSymbol, 0

@.ITEM TopSymbol
.equ Child1,1
.equ Child2,2

В навигаторе символов (F5 Символы) эти символы будут сгруппированы в виде ветви дерева:

TopSymbol
  |
  +-----Child1
  |
  +-----Child2

Группа символов сбрасывается как только будет встречена директива @.end или пустая строка


+--------+------------------------------------------------+
| @.DESC | Задание примечания для подпрограммы или модуля |
+--------+------------------------------------------------+

Директива задает описание показываемое при нажатии кнопки F1 на метке или имени включаемого файла
Обычно это директива применяется в .asm файлах для меток подпрограмм


Формат для задания описания подпрограммы по имени метки

@.desc name=имя_комментируемой_метки type=proc
@
@ Текст комментария для метки указывающей на подпрограмму
@
@.enddesc


Формат для задания описания включаемого файла
Обычно эта директива применяется для создания описаний .inc файлов которые включаются в компиляцию при помощи директивы .include в .asm файлы
@.desc type=module
@
@ Текст комментария
@
@.enddesc


+----------+---------------------------------------------------+
| @.CONFIG | Задание возможных значений для указанного символа |
+----------+---------------------------------------------------+

Директива задает группу значений определенных директивой @.ITEM для выбранного символа.
Обычное использование - это назначение значений для символа определенного в директиве .equ

Формат использования:

@ задаем возможные значения директивой @.ITEM:
 @.ITEM values
.equ value1, 1
.equ value2, 2
.equ value3, 3
@.END

@ определяем символ который должен принимать значения values
.equ symbolName, value1

@ задаем группу значений values для символа symbolName
@.CONFIG symbolName=values

Теперь при нажатии кнопки F4 "Изменить" на значении value1 в определении symbolName редактор предоставит выбор значений из списка values в диалоговом окне
