Changes

Just say "dialog" instead of "parameter dialog" related to Dialog annotation

The Dialog annotation is more widely useful than just for parameters.

Not touching the revision history, where "parameter dialog" is still mentioned.

Really remove "Parameters" as default for 'group'

What we did in the past was just to remove it from the Dialog example.

Reorganize description of Dialog annotation

Merge descriptions of Dialog 'tab' and 'group'

Remove 'parameter' prefix from Dialog and Selector annotation pseudo code definitions

Say 'entire group' instead of 'parameter-group'

Clean up source line break

Allow sentences to start with inline listing to avoid unusual use of 'parameter'

Break out example of tool-specific choice of group

Fix title case in new section heading

Protect space after \LaTeX

Align duplicated parts of lexing rules

This isn't the first time we have issues with these being out of sync.  Hopefully, maintenance will become easier now with the duplicated part being a substring of the full lexing rules.

Remove HTML footer links to bibliography and index

Avoid use of connectorSizing in example before it has been described

Show HTML footer link to document index as magnifying glass in page top right corner

Fine tune padding for correct centering of page header content

Stop saying that 'promote' isn't a Modelica function

Fixes #2843.

It's rather embarrassing that we missed this in #2590.

Fix formatting of 'STRING' and 'Q-IDENT'

Use table to present extended BNF

This is similar to how we present string escape sequences, with good formatting of the textual descriptions.

Of the two present spellings 'NONDIGIT' and 'NON-DIGIT', go with the latter

Remove obsolete comment about boldface lexical units

The comment was obsolete for two reasons:
- The boldface formatting was lost in the conversion to LaTeX.
- There are annotations making use of both S-CHAR, NON-DIGIT, and UNSIGNED-INTEGER, none of which were marked with boldface in 3.4.  With so many of the lexical units actually being used, there seems to be little value in marking them.

Rephrase sentence with 'IDENTs'

This seemed like a better fix than just changing to:
  \lstinline[language=grammar]!IDENT!s

Refer to Selector.caption as "a caption for display in the file dialog"

Say "a dialog is shown" instead of "a menu pops up"

Preferring "is shown" over "pops up", since the former is more general.

More systematic use of \lstinline for figure annotations Axis and Curve

Also fixing some issues with missing punctuation.

Break out presentation of item list from its first item

(This problem was present already in 3.4.)

Fix more formatting of "(:)" for flexible array dimension clarification

Add missing plural 's'

Clean up example "Variables with array dimensions"

Fixes #2855.

(I have checked that the longer lines don't wrap.)

Fine tune padding at top of HTML pages

Addressing change requested by Hans in review comment.

Just say "dialog" instead of "parameter dialog" related to Dialog annotation

The Dialog annotation is more widely useful than just for parameters.

Not touching the revision history, where "parameter dialog" is still mentioned.

Really remove "Parameters" as default for 'group'

What we did in the past was just to remove it from the Dialog example.

Reorganize description of Dialog annotation

Merge descriptions of Dialog 'tab' and 'group'

Remove 'parameter' prefix from Dialog and Selector annotation pseudo code definitions

Say 'entire group' instead of 'parameter-group'

Clean up source line break

Allow sentences to start with inline listing to avoid unusual use of 'parameter'

Break out example of tool-specific choice of group

Fix title case in new section heading

Protect space after \LaTeX

Align duplicated parts of lexing rules

This isn't the first time we have issues with these being out of sync.  Hopefully, maintenance will become easier now with the duplicated part being a substring of the full lexing rules.

Remove HTML footer links to bibliography and index

Avoid use of connectorSizing in example before it has been described

Show HTML footer link to document index as magnifying glass in page top right corner

Fine tune padding for correct centering of page header content

Stop saying that 'promote' isn't a Modelica function

Fixes #2843.

It's rather embarrassing that we missed this in #2590.

Fix formatting of 'STRING' and 'Q-IDENT'

Use table to present extended BNF

This is similar to how we present string escape sequences, with good formatting of the textual descriptions.

Of the two present spellings 'NONDIGIT' and 'NON-DIGIT', go with the latter

Remove obsolete comment about boldface lexical units

The comment was obsolete for two reasons:
- The boldface formatting was lost in the conversion to LaTeX.
- There are annotations making use of both S-CHAR, NON-DIGIT, and UNSIGNED-INTEGER, none of which were marked with boldface in 3.4.  With so many of the lexical units actually being used, there seems to be little value in marking them.

Rephrase sentence with 'IDENTs'

This seemed like a better fix than just changing to:
  \lstinline[language=grammar]!IDENT!s

Refer to Selector.caption as "a caption for display in the file dialog"

Say "a dialog is shown" instead of "a menu pops up"

Preferring "is shown" over "pops up", since the former is more general.

More systematic use of \lstinline for figure annotations Axis and Curve

Also fixing some issues with missing punctuation.

Break out presentation of item list from its first item

(This problem was present already in 3.4.)

Fix more formatting of "(:)" for flexible array dimension clarification

Add missing plural 's'

Clean up example "Variables with array dimensions"

Fixes #2855.

(I have checked that the longer lines don't wrap.)

Fine tune padding at top of HTML pages

Addressing change requested by Hans in review comment.