Macro Language Reference > Macros > System > tsgmpopt
  
tsgmpopt
Description
Sets the options for the use of the SGML parser.
 
Example 253. Examples of SGML parser options
tsgmpopt 0,sp0
tsgmpopt 1,x2,df"parse_log.log"
tsgmpopt 2,1,0,x0,pae24,mu1789
Syntax
tsgmpopt '0' ( ( 'x' parse_as:n )? ( 'sp' sp_flags:n )? ( 'pae' pae_flags:n )? ( 'pat' pat_flags:n )? ( 'df' error_file:s )? )
tsgmpopt '1' ( ( 'x' parse_as:n )? ( 'sp' sp_flags:n )? ( 'pae' pae_flags:n )? ( 'pat' pat_flags:n )? ( 'df' error_file:s )? )
tsgmpopt '2' replace:n suppress:n ( ( 'x' parse_as:n )? ( 'sp' sp_flags:n )? ( 'pae' pae_flags:n)? ( 'pat' pat_flags:n )? ( 'df' error_file:s )? ) ( 'mu' markup_flags:n )?
tsgmpopt '3' replace:n link_file:s ( ( 'x' parse_as:n )? ( 'sp' sp_flags:n )? ( 'pae' pae_flags:n )? ( 'pat' pat_flags:n )? ( 'df' error_file:s )? )
tsgmpopt
[no parameter]
Invoke the Advanced Settings dialog box.
Parse/command mode
0
DTD only
1
Normal
2
Parse and expand
3
Parse and transform
Select one of these options when setting up the parser options, then select further parameters depending on the option specified here.
replace
Toggle whether to replace the original stream:
0
No
1
Yes
suppress
Toggle whether to suppress the DTD in output:
0
No
1
Yes
linkfile
The name of the file supplying the conversion information for any transformation
x parse_as
The language to which the stream should be parsed:
0
SGML (default)
1
Unvalidated XML
2
Validated XML
sp flags
Use flags for standard parse option (for use with parse/command modes 0 and 1): see flags below.
pae flags
Use flags for parse and expand option (for use with parse/command mode 2): see flags below.
pat flags
Use flags for parse and transform option (for use with parse/command mode 3): see flags below.
flags
Flags:
1
Describe open entities in an external error log (all Parse/command modes)
2
Show information about relevant clauses in an error log (Parse/command modes 0 and 1).
4
Show generic IDs of open elements in an error log (Parse/command modes 0 and 1).
8
Expand references to changed entities (all entities) (Parse/command mode 2) (24).
32
Do not convert RSs or REs when outputting entity (Parse/command mode 2).
64
Prefer lower case (Parse/command mode 2).
128
Hoist omitted tags from start of internal entities (Parse/command mode 2).
256
Output comments in input document instance (Parse/command mode 3).
512
Output marked sections in input document instance (Parse/command mode 3).
1024
Output a DTD with same external ID as input document (Parse/command mode 3).
df fname
The filename for any external error output: should be specified when using flags 1, 2, or 4 with sp, pae or pat, unless it is known that the external error file is already set (and enabled). To disable external error output, simply specify df"".
mu markup
1
Add omitted tags using omitted tag minimization.
2
Replace short references with named entity references.
4
Change null end tags into unminimized end tags, and change net-enabling start tags into unminimized start tags.
8
Change empty tags into unminimized tags.
16
Change unclosed tags into unminimized tags.
32
Add omitted attribute names and vis 32
64
Add literal delimiters omitted from attribute values.
128
Add omitted attribute specifications.
256
Add omitted attribute specs for current attributes.
512
Add omitted rank suffixes.
1024
Put reserved names in upper case.
2048
Remove marked section declarations whose effective status is IGNORE, and replace each section declaration whose effective status is INCLUDE with its marked section.
Additional Information
 
Many parameters are optional for this macro, but the order in which the parameters are entered is key, for example sp<#> cant come after pae<#> or pat<#>).