Шапка сорцов для 'ZX_SOURCES_LIBRARY'

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 ═══

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

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

10 июня 2001 года (а было тогда 03:02)
Evgeny Goljakov в своем письме к All писал:

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

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

Есть пpедложение для этого пpоекта создать саециальную эху. Имхо, каждая
подпpогpамма вызовет споpы и желание улучшить какие-то отдельные места. А чеpез
эху, силами многих людей, она будет отточена до совеpшенства. В качестве
пpецедента пpиведу печаталку Миши Жаpова.

Vega / ex-Style Group. 11 июня 2001 года

EG> Перед вами проектная версия субжа. Без этой малости не имеет
EG> смысла вообще классифицировать и собирать ASSM-подпрограммы.
EG> Целью проекта ZX_SOURCES_LIBRARY (ZSL) является:
EG> 1. Сбор низкоуровневых подпрограмм (п/п) на ассемблере Z80;
EG> 2. Систематезация п/п по тематическим разделам библиотеки;
EG> 3. Сортировка однотипных п/п внутри раздела по длине/скорости;
EG> 4. Работа в режиме FAQ-server'a (с адресами в zxnet/fidonet)
наверно хорошее начинание, однако подобный проект уже давно ведет Faster/TNL из
Ульяновска. Hеплохо бы Вам с ним связаться.

С Вами был .┌─┐┌─┐┬┌ .┌─┐ aka J7n/4D
│┼─┼│ ├┴┐│├┤
└┘┘ └└─┘┴ ┴└└─┘
j...@mail.ru

А куда процедуры слать? А то у меня тут валяется несколько
интересных процедурок, может кто ускорить сможет.

Hа этом усе. Пока, Evgeny!

[CGE] [ARTVIEW] [THE KNIGHT'S ARENA] [IF GAME]
to be continued ...

NEWART/n-Discovery/SPb * Coder, gfx artist, AY music's fanat

Evgeny Goljakov ==========> All:

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

Хорошая идея, полностью поддерживаю. Постараюсь предоставить
в ближайшее время несколько процедур.

Bye!
Pa...@nm.ru rscg.boom.ru [RC 2.0 70%] [ZX] [Real Software]

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

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

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

Хм, а ведь имя видимо придется с путем указывать? Hет никакой гарантии, что
файл с именем "MY BEST PROGRAMM" будет только одна в базе. Или еще как то
разрешать конфликты, например: если такое имя уже есть, то менять последний
байт и ссылки на этот файл, пришедшие вместе с ним тоже переимемовывать... Hо
это как то сложно и неуклюже... Как то по другому наверное надо...

EG> мнемоника/#hex код/аналог на документированных командах или
EG> описание влияния на флаги, регистры, ячейки, порты.

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

С уважением, Dmitriy.

SK> А куда процедуры слать? А то у меня тут валяется несколько
SK> интересных процедурок, может кто ускорить сможет.

В библиотеку предполагается брать п/п всех ассемблеров,
но ТОЛЬКО при заполнении субжа, помесченного в начале
исхонодо текста. Дабы не утонуть в лавине хаоса сорцов.

Пока мы говорим о полях шапки, куда слать - после.

SK> NEWART/n-Discovery/SPb * Coder, gfx artist, AY music's
SK> fanat
Спасибо за вномание.

VS> Есть пpедложение для этого пpоекта создать саециальную
VS> эху. Имхо, каждая подпpогpамма вызовет споpы и желание
VS> улучшить какие-то отдельные места. А чеpез эху, силами
VS> многих людей, она будет отточена до совеpшенства. В
VS> качестве пpецедента пpиведу печаталку Миши Жаpова.

Тематика эхи CODE.ZX полностью для этого подходит.

Удалились, господа, от субжа...

VS> Vega / ex-Style Group. 11 июня 2001
Спасибо за внимание.

DN> Хм, а ведь имя видимо придется с путем указывать? Hет
DN> никакой гарантии, что файл с именем "MY BEST PROGRAMM"
DN> будет только одна в базе. Или еще как то разрешать
DN> конфликты, например: если такое имя уже есть, то менять
DN> последний байт и ссылки на этот файл, пришедшие вместе с
DN> ним тоже переимемовывать... Hо это как то сложно и
DN> неуклюже... Как то по другому наверное надо...

Просто требовать уникальности имен п/п у присылающих

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