Also added a new tool checkem.py in "doctools" folder: it helps
checking wether em and xml files are in sync or no.
This is a quite accurate job: I'm almost 100% sure (thanks to
checkem.py) that:
- All the functions defined in .em files are now mentioned in docs
(except of deprecated ones that i omitted on purpose)
- Function prototypes are the same in .em files and their doc
- All the function arguments have at least a basic doc element
- All the constants defined in .em files are in the docs
A 2nd round of review would be probably useful tought, expecially
on uoem.xml, who had the major changes: I didn't go deep into
what every function does and maybe some slightly changed their
behaviour during these years. This should be a more than good start
anyway: if there are some errors left, hope somebody will notice
and report them :)
The sync now goes back to POL095 era... after that, the format is
completely different and would require writing a 2nd dedicated
parser: I think it's not worth it.
The automatic parser is buildcorechanges.py and is located in a new
"doctools" folder. A real dev may move that folder later where he
will think it is more appropriate.
Parser tested only on Linux, but I wrote it to also work on Windows.