1.5 Flags and Fields

The following sections list various flags and fields that are used by Message Tools:

1.5.1 Common Flags

The following table lists the flag options that are common to both XMsgUtil and XMsgTool when you are creating and updating an XLIFF file (see Creating/Updating an XLIFF File, Creating an XLIFF File, and Updating an XLIFF File):

Flag

Description

-c

Allow nested comments in C files

-e

Equate messages with same text

-f

Check that strings are length preceded

-d [TEXT]

Disregard the specified text

-l [LENGTH]

Set the specified maximum length for all messages

-t [TAG]

Isolate the strings with the specified tag

-w

Write output over the source file

-x

Disable automatic message tagging

1.5.2 DOS Create/Update XLIFF Flags

In addition to the flag options that can be used by both XMsgTool and XMsgUtil (see Common Flags), the following flags are specific to XMsgTool when you are creating and updating an XLIFF file (see Creating an XLIFF File and Updating an XLIFF File):

Flag

Description

-i

Create an XLIFF file.

-u

Update an XLIFF file without updating its label.

-ul

Update an XLIFF file and update its label.

-uol

Update the label for an XLIFF file only. The source file is omitted or ignored.

-p

Program name.

-v

Program version.

-tv

Translation version. The default is 1.0.

-lg

Language ID. For updates only. The default is 4 (English). For a complete list of language IDs, see Language IDs.

-st

One of the following types of source files:

  • MsgLib refers to messages in *.mlc and *.mlh files
  • CString refers to messages in other types of files

-ff

One of the following file formats to be created from the XLIFF file:

  • NLM specifies the NLM message file format
  • CWSysMsg specifies the Msglib system message file format
  • DOSSys specifies the format used by DOS system programs

-em

Create an msg file from the existing XLIFF file.

1.5.3 DOS Create MSG Flags

The following flags are specific to XMsgTool when you are creating an MSG file (see Creating an MSG File):

Flag

Description

-%

Do not expand '%' to '%%.'

-e

Explicit mode.

-d

Use DOS data sizes.

-w

Use Watcom 386 data sizes.

-b

Use Borland floating point data sizes.

-i

Do not export internal messages.

-t

Export translated messages.

-f

Pointers are far.

-n

Pointers are near.