ZXNet эхоконференция «code.zx»

Hi, All.

Перед вами проектная версия субжа. Без этой малости не имеет
смысла вообще классифицировать и собирать ASSM-подпрограммы.

Проект ведут:
Александр Майоров (Mas), Евгений Голяков (Spencer),
Дмитрий Hесмачный (Merlin), Вы и сам господь Бог.


Целью проекта ZX_SOURCES_LIBRARY (ZSL) является:

1. Сбор низкоуровневых подпрограмм (п/п) на ассемблере Z80;
2. Систематезация п/п по тематическим разделам библиотеки;
3. Сортировка однотипных п/п внутри раздела по длине/скорости;
4. Работа в режиме FAQ-server'a (с адресами в zxnet/fidonet)

Предполагается автоматом разбирать сорцы по этим полям шапки.
Там где две строки точек - там можно использовать n строк.

═══ CUT ═══
Name:..........................................................
Autr:..........................................................
Date:................................
Assm:................................

Info:..........................................................

Link:..........................................................


Size:................................
Memo:................................
Takt:................................

IN:............................................................

OUT:...........................................................

Unpb:..........................................................

Data:..........................................................

═══ EOF ═══



Теперь подробней о каждом пункте:

═══ CUT ═══
Name:
-имя, она же метка вызова этой п/п из других, которая будет использоваться для
сборки проекта из разобщенных п/п,
размещенных по разным тематическим разделам. В теле программы
эта метка должна задавать первый ее байт.


Autr:
-автор подпрограммы и желательно e-mail адрес

Date:
-дата создания п/п (dd/mm/yyyy)

Assm:
-редактор ассемблера желательно с указанием версии

Info:
-краткое описание п/п в несколько строк

Link:
-имена других вызываемых п/п из этой, через запятую или с новой строки,
возможно, именно по этому полю FAQserver будет посылать весь проект, при
запросе его компонента

Size:
-полный размер до инсталяции

Memo:
-полный рабочий размер со всеми переменными и буферами

Takt:
-сорость в тактах процессора всех ветвей п/п через запятую или
с новой строки, конечно, если количество ветвей невилико

IN:
-требуемые параметры на входе

OUT:
-состояние регистров на выходе

Unpb:
-недокументированные команды лучше раписать в виде:
мнемоника/#hex код/аналог на документированных командах или описание влияния на
флаги, регистры, ячейки, порты.

Data: -описание используемых переменных, массивов, буферов.
Указать какие временные, какие нет. Максимальная глубина стека.
И прочая информация, облегчающая процесс взаиимодействия п/п.
═══ EOF ═══

Данная версия субжа сделана с учетом ваших пожеланий, которые
я еще собираю. Эта шапка будет венчать начало каждой процедуры,
помещенной в библиотеку, поэтому, как говорится, пока не позно,
кодеры/программеры, сделайте над собой усилие-вникните в текст.


posted in CODE.ZX
crossposted in REAL.SPECCY


Спасибо за внимание.