Part VII - Mastering Settings

Settings are special configurations placed at the source document's Config Area that can affect the conversion process. The Settings are all optional. The average user can live fine without them. But they are addictive, if you start using them, you'll never stop :)

Setting lines are special comment lines, marked by a leading identifier ("!") that makes them different from plain comments. The syntax is just as simple as variable setting, composed by a keyword and a value, separated from each by a colon (":").

%! keyword : value

Syntax details:

• The exclamation mark must be placed together with the comment char (%!), no spaces between them.

• The spaces around the keyword and the separator are optional.

• Keywords are case insensitive (case doesn't matter).

Rules:

• Settings are valid only inside the Config Area, and are considered plain comments if found on the document Body.

• If the same keyword appears more than one time on the Config Area, the last found will be the one used. Exception: options, preproc and postproc, which are cumulative.

• A setting line with an invalid keyword will be considered a plain comment line.

• This settings have precedence over RC file, but not on command line options.