I don't have good memory so I often read fasm manual. But it takes me to much time find what I need and understand what Privalov want to say reading his description. I would like to see as simple documentation as possible. I mean some simple examples or gramma described in something like BNF.
E.g. in manual is written:
The file is a special directive and its syntax is dierent. This directive
includes a chain of bytes from file and it should be followed by the quoted
file name, then optionally numerical expression specifying oset in file preceded
by the colon, then – also optionally – comma and numerical expression
specifying count of bytes to include (if no count is specified, all data up to
the end of file is included).
It could be followed by short gramma description like this:
'file' <path_to_included_file> [ ':' <offset_at_file>] [ ',' <length_of_included_data> ]
Or some examples like:
file 'MyFile.txt'
file 'MyFile.txt':10
file 'MyFile.txt',20
file 'MyFile.txt':10,20