Delimiters of GNML parameters

Build 1501 on 14/Nov/2017  This topic last edited on: 24/Oct/2016, at 14:39

Delimiters for GNML parameters

GNML parameters are delimited by comma, except in tags with only one parameter.

Therefore:

>is 8pt<

but:

>is 8pt,2<

Parameter enclosures in GNML

Normally, GNML parameters are to be typed 'as-is', and do not need to be enclosed in quotes.

For example, the correct syntax is >is 8pt< or >is 8<. The wrong syntax is >is "8pt"< or >is "8"<.

There are two exceptions:

If the parameter is a multiple word string, e.g. for the color name as >co "Real red"< you need to enclose it.

When parameters are specified as "tags within tags", as in >t 1cm,1,0.25pt,C,70,'>f 9013<>pqr<>ir 2mm<'< where "tags within tag" are shown in red color and enclosed in single quotes.

Use the following characters to enclose such parameters:

Double straight quote "

Single straight quote '

Exclamation mark !

Enclosing characters should always appear in pairs, e.g. !param!, "param" or 'param'.

Avoid duplication of the same delimiter within one tag.

Correct: >t 1cm,1,0.25pt,C,70,'>f 9013<>co "Real red"'< (the parameter is enclosed in single quotes, while the color in double quotes).

Wrong: >t 1cm,1,0.25pt,C,70,'>f 9013<>co 'Real red''< (the parameter and color are enclosed in single quotes).

Important: Do not use curly quotes! It will cause a justification error. Pay special attention when copying tags from Word or similar documents where the quotes might be converted in curly quotes and pasted as such.