[fpc-pascal] Documentation, syntax diagrams

[Jürgen Hestermann]

Am 2014-01-09 08:26, schrieb Michael Van Canneyt:
 >> That what should be declared is repeated in the declaration
 >> itself which makes no sense to me.
 >> A syntax diagram for 'type declaration' (which is written in the heading already)
 > The heading is a caption.
 > In typesetting, normally that is not considered part of the diagram itself,
 > just like a table or figure caption is not considered part of the table or figure.

But why is the heading part of the diagram?
It should be just that: A heading (in an extra line before the diagram).
For example on page 29:


String Type
----- string type -- STRING --|--------------------------------|----
                               \-- [ -- unsigned integer -- ] --/

There is already the heading "String Type",
then - as part of the diagram (surrounded by lines) - "string type" appears again!
Why?
That's totally confusing.
It should be like this:

String Type:
----- STRING ----|--------------------------------|----
                  \-- [ -- unsigned integer -- ] --/

or

String Type =
----- STRING ----|--------------------------------|----
                  \-- [ -- unsigned integer -- ] --/