[fpc-pascal] Documentation, syntax diagrams

[Michael Van Canneyt]

On Sat, 11 Jan 2014, Jürgen Hestermann wrote:

> Am 2014-01-11 13:14, schrieb Michael Van Canneyt:
>> I meant that I use a diagram typesetting package for LaTeX. This package 
>> definitely works like that.
>
> Then something is wrong with this package.
> Which one is it?

listings.sty

I didn't write this package, but I'm sure its author will appreciate your insights.

> And as I wrote, there are diagrams which do *not*
> repeat the header (diagram name) in the diagram:
> On pages 69,85,98,103,110,114 and 115 each diagram starts with a (bold) 
> keyword
> ("packed"/"class, "Interface", "extended record type", "class"/"record",
> "objcclass", "objcprotocol" and "objccategory")
> and not with the diagram name.
> This is what I would expect for all other diagrams too.
> Why this inconsistency?

I don't necessarily consider this inconsistent.

> If the diagrams stay like this they are too confusing to be of any use.

That is your opinion, to which you are of course entitled.

Feel free to make suggestions for improvements. 
If I consider the suggestions good, I will certainly incorporate them.

But I kindly suggest you change your tone. You may not realize it, 
but your tone is edging on arrogant.

Michael.