Display operators

Edit online

Display operators define how multiple flags relate within the SMIT dialog, how the options for the flags are displayed, and what flags and options are available.

Item Descriptor

Item	Descriptor
C	To support interdependent flags (for example, flags that affect typestyle and pitch), combinations of flags must be used. Typically, there is a single match between a SMIT dialog field and a command line flag. The combination flag operator allows one field in a SMIT dialog to represent more than one command line flag. Referenced flags should be marked as non-display (Dn) type for SMIT dialogs, so that only the combination flag is displayed instead of the individual flags. The C operator syntax is: `C[xx,yy,...]` The xx and yy values are flag attributes. When a C attribute is defined, the limits field must also contain an R ring operator to define the popup list that is displayed to SMIT users. The R operator also defines how the options on the list map to command-line flags. `:111:Cs:C[_s,_p]R[Courier 10, Prestige 12= -s Courier -p10, -s Prestige -p12]):-s %I_s -p %I_p :999:_s:Dn:Courier :222:_p:Dn:10` In this example, the C operator defines that the -s and -p flags are combination attributes. The R ring defines that when the Courier 10 option is chosen from the pop up menu, the flags on the command line are -s Courier -p10. The -s %I_s -p%I_p attribute value is resolved when the SMIT dialog is built and determines which item in the ring is displayed as the default.
D	Designates the display mode. If the value is y, an object is built in the sm_cmd_opt object class. If the value is n, no object is built. The D operator allows programmers to suppress certain flags from being displayed in SMIT. If this operator is not specified, the object is built if the flag is referenced in the input pipeline.
S	Designates the sequence number in the id_seq_num field of the sm_cmd_opt object class. The sequence number controls the position of the item in relation to other items in the dialog screen. If no S operator is specified, the dialog starts with the ID number 100, and items are numbered in the sequence they are found in the colon file. The value for the S operator can be a string with a maximum length of 16 characters. For example, the following S operator entry places the item in position 100: `:100:_1:S[100]:60`

To support interdependent flags (for example, flags that affect typestyle and pitch), combinations of flags must be used. Typically, there is a single match between a SMIT dialog field and a command line flag. The combination flag operator allows one field in a SMIT dialog to represent more than one command line flag. Referenced flags should be marked as non-display (Dn) type for SMIT dialogs, so that only the combination flag is displayed instead of the individual flags.

The C operator syntax is:

C[xx,yy,...]

The xx and yy values are flag attributes. When a C attribute is defined, the limits field must also contain an R ring operator to define the popup list that is displayed to SMIT users. The R operator also defines how the options on the list map to command-line flags.

:111:Cs:C[_s,_p]R[Courier 10, Prestige 12= -s Courier
   -p10, -s Prestige -p12]):-s %I_s -p %I_p
:999:_s:Dn:Courier
:222:_p:Dn:10

In this example, the C operator defines that the -s and -p flags are combination attributes. The R ring defines that when the Courier 10 option is chosen from the pop up menu, the flags on the command line are -s Courier -p10. The -s %I_s -p%I_p attribute value is resolved when the SMIT dialog is built and determines which item in the ring is displayed as the default.

D Designates the display mode. If the value is y, an object is built in the sm_cmd_opt object class. If the value is n, no object is built. The D operator allows programmers to suppress certain flags from being displayed in SMIT. If this operator is not specified, the object is built if the flag is referenced in the input pipeline.

Designates the sequence number in the id_seq_num field of the sm_cmd_opt object class. The sequence number controls the position of the item in relation to other items in the dialog screen. If no S operator is specified, the dialog starts with the ID number 100, and items are numbered in the sequence they are found in the colon file.

The value for the S operator can be a string with a maximum length of 16 characters. For example, the following S operator entry places the item in position 100:

:100:_1:S[100]:60