Шапка сорцов для 'ZX_SOURCES_LIBRARY' — ZXNet «code.zx»

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

ZXNet echo conference «code.zx»



from: Evgeny Goljakov
to: All
date: 10 June 2001
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 Спасибо за внимание.