[ moving to fpc-other; Michael is not subscribed to this list ]

Jürgen Hestermann wrote

You seem to imply that I am demanding something for myself. But I only report these documentation problems for potential new users because I think that Pascal should be used by more people while you seem to not care about them.

Claiming that Michael does not care about (new) people using Pascal is, given his work on FPC and in particular the FPC documentation for the past 19 or so years, nonsense.

He clearly does not share your priorities or opinions in this case, but trying to convince him (or anyone, for that matter) with arguments based on moral superiority (not speaking for yourself but potential new users, caring while the other person "does not seem to care") or hyperbole that degrades their over a decade old body of continued work ("If the diagrams stay like this they are too confusing to be of any use") is unlikely to have any positive effects, no matter how right you may feel that that you are or even be. To the contrary, in fact, since few people want to encourage this kind of behaviour towards themselves by being receptive to the underlying arguments when they are voiced in such a way.

Jonas

If you are realy trying to tell me that these diagrams are okay then I will stop reporting any issues about the documention now. Thanks for making this clear to me.

I don't like getting involved in this, but in my opinion having something misleading in the documentation is worse than having nothing, and having nothing is tantamount to omitting the feature from the compiler or runtimes.

The thing that the project really lacks is some sort of "how do I do this" facility.