Source header for 'ZX_SOURCES_LIBRARY'
ZXNet echo conference «code.zx»
From Evgeny Goljakov → To All 10 June 2001
Hi, All.
Here is a draft version of the subzha. Without this little thing there is no
It makes no sense to classify and collect ASSM subroutines at all.
The project is led by:
Alexander Mayorov (Mas), Evgeniy Golyakov (Spencer),
Dmitry Nesmachny (Merlin), you are God himself.
The goal of the ZX_SOURCES_LIBRARY (ZSL) project is:
1. Collection of low-level subroutines (p/p) in Z80 assembler;
2. Systematization of items by thematic sections of the library;
3. Sorting similar items within a section by length/speed;
4. Working in FAQ-server mode (with addresses in zxnet/fidonet)
It is supposed to automatically parse the sorts based on these header fields.
Where there are two lines of dots, n lines can be used.
═══ CUT ═══
Name:........................................................................
Autr:........................................................................
Date:................................
Assm:............................
Info:........................................................................
Link:........................................................
Size:............................
Memo:............................
Takt:............................
IN:................................................................
OUT:........................................................................
Unpb:........................................................................Data:........................................................
═══ EOF ═══
Now in more detail about each point:
═══ CUT ═══
Name:
-name, which is also the call label of this sub-number from others, which will be used for
assembling a project from disconnected sub-plots,
placed in different thematic sections. In the body of the program
this label must specify its first byte.
Autr:
-author of the subroutine and preferably e-mail address
Date:
- date of creation of the item (dd/mm/yyyy)
Assm:
-assembly editor, preferably indicating the version
Info:
- a brief description of the item in a few lines
Link:
-names of other called items from this one, separated by commas or starting on a new line,
perhaps this is the field that FAQserver will use to send the entire project, if
request for its component
Size:
-full size before installation
Memo:
-full working size with all variables and buffers
Takt:
- speed in processor cycles of all branches of the subdivision separated by commas or
from a new line, of course, if the number of branches is small
IN:
-required input parameters
OUT:
-state of output registers
Unpb:
-undocumented commands are better written in the form:
mnemonic/#hex code/analogue on documented commands or description of the impact on
flags, registers, cells, ports.
Data: - description of the variables, arrays, buffers used.
Indicate which are temporary and which are not. Maximum stack depth.
And other information that makes the process of interaction easier.═══ EOF ═══
This version of the subzha is made taking into account your wishes, which
I'm still collecting. This hat will mark the beginning of each procedure,
placed in the library, therefore, as they say, it’s not too late,
coders/programmers, make an effort to understand the text.
posted in CODE.ZX
crossposted in REAL.SPECCY
Thank you for your attention.