[Dynapi-Dev] identification od versions

[SReindl <SR...@la...>]

Hi DynApicators,

as I follow the discussion in here and in the help list, I believe, one of
the problems is the identification of the versions.

So, why not inserting a line, which shows at least the date and time of
creation or, if there is some kind of central control (who?), a running
version number? This should help to avoid confusion.

Also, I would appreciate if (patch) authors could mark the lines they
changed, may be together with a short explanation of why they did it. If you
have problems with the file size, you can remove the comments by your own.

Thirdly, concerning the "documentation project": I would appreciate very
much, if the code could be documented by the author at least in so far as
that I would like to know the purpose and scope (see below) of the function.
It's not that I cannot understand, what she/he was doing, but it costs some
extra time to analyze the code.

Lastly, I think, many functions are merely ment for INTERNAL use inside of
the DynAPI. In the language of OOP, they would be marked protected or even
private. They are not part of the API. Could we get some agreement of how
name those functions and to distinguish them from "outer" (exported, public,
...) API functions? For users, it should be not neccessary to understand all
this internal stuff to use the API.

Greetings,

Dr. Stephan Reindl
 
Mail: SR...@la... <mailto:SR...@la...>
Internet: www.lamello.de <http://www.lamello.de>