This appendix lists the diagnostic messages produced by the
UIL compiler. The severity, a description of the message, and a suggestion for
correcting the problem are listed for each message. The following strings are
used to represent data that varies in the actual message you receive from the
UIL compiler:
| String | Data Represented |
|---|---|
| %c | Character |
| %d | Decimal number |
| %s | String |
Messages are listed alphabetically by IDENT code.
Severity: Error More than one source file was specified. Only the first source file will be compiled.
User Action: Compile additional source files using separate invocations of the compiler.
Severity: Error The declaration of the marked procedure specified a different number of arguments than are present in this procedure reference.
User Action: Check that you are calling the correct function. If you intend to call the procedure with a varying number of arguments, omit the argument list in the procedure declaration.
Severity: Error The declaration of the marked procedure specified a different type of argument than is present in this procedure reference.
User Action: Check that you are passing the correct argument to the correct function. If you intend to call the procedure with varying argument types, declare the procedure specifying any for the type of the argument.
Severity: Error A backslash was followed by an unknown escape character. The \ (backslash) is the escape character in UIL. A selected set of single characters can follow a backslash such as \n for newline or \\ to insert a backslash. The character following the backslash was not one of the selected set.
User Action: If you want to add a backslash, use \\. See the UIL(5X) reference page for a description of the supported escape sequences.
Severity: Severe The compiler encountered an error in reading a binary widget meta-language description file.
User Action: Check that the file specified to the --wmd command line argument is a valid widget meta-language description file.
Severity: Error The character set portion of the locale specified in the LANG environment variable does not correspond to one of the character sets known to the UIL compiler.
User Action: See the UIL(5X) reference page for a description of the supported character sets. Change the value of $LANG to contain one of the known character sets.
Severity: Severe The compiler diagnosed an internal error.
User Action: Submit a software problem report.
Severity: Error The compiler could not perform the specified implicit type conversion.
User Action: Check that the value being specified is what is desired and that the type of the value being specified can be converted to the requested type. See the UIL(5X) reference page for a description of standard type conversions and Appendix C for a list of UIL argument types.
Severity: Error The indicated item contains a reference to the widget within which it is defined, either within its own definition or within the definition of one of the objects in the widget tree it controls.
User Action: Change the definition of the indicated item so that it does not reference the widget within which it is defined.
Severity: Error The indicated value is referenced either within its own declaration or recursively within the declaration of one of the values it depends on.
User Action: Change the declaration of the indicated value so that it does not depend on itself.
Severity: Error The compiler encountered an illegal control character in the UIL specification file. The decimal value of the character is given between the \ (backslash) characters.
User Action: Replace the character with the sequence specified in the message (for example, \3 if the control character's internal value is 3). UIL provides several built-in control characters such as \n and \r for newline and carriage return. See the UIL(5X) reference page for a complete list of supported escape sequences.
Severity: Error You specified a creation procedure for a Motif Toolkit widget. You can specify a creation procedure only for a user-defined widget.
User Action: Remove the procedure clause following the object type.
Severity: Error You specified a creation procedure when referencing an object. You can specify a creation procedure only when you declare the object.
User Action: Remove the procedure clause following the object type.
Severity: Error When defining a user-defined widget, you must specify the name of the creation function for creating an instance of this widget.
User Action: Insert a procedure clause following the widget type in the widget declaration. You also need to declare the creation procedure using a procedure declaration. For example:
procedure my_creation_proc();
object list_box:
user_defined procedure
my_creation_proc()
{ arguments ... };
Severity: Error At the point marked in the specification, one type of object (such as a widget) is required and your specification supplied a different type of object (such as value).
User Action: Check for misspelling or that you have referred to the intended object.
Severity: Informational If UIL encounters a character set that is neither a built-in character set nor user-defined, the character set of the string will be set to XmFONTLIST_DEFAULT_TAG. This message is printed for each unique chararacter that it had to set. In the message, the first string is the character set name the user used, and the second string is usually XmFONTLIST_DEFAULT_TAG.
Severity: Severe Check for incompatible unit types for the requested arithmetic operation.
Severity: Error Each of the letters used to represent a color in a color table must be unique. If not, that letter in an icon would represent more than one color; each pixel can have only one color associated with it at a time. The letter marked has been assigned to more than one color.
User Action: Choose which color the letter is to represent and remove any duplicates or assign them a new character.
Severity: Error A widget or gadget declaration can have at most one arguments list, one callbacks list, and one controls list.
User Action: If you want to specify multiple lists of arguments, controls, and callbacks, you can do so within one list. For example:
arguments { arguments_list1;
arguments_list2; };
Severity: Warning The same command line option has been repeated more than once (for example, the "-o" option or the "-v" option)
User Action: Remove duplicate command line option.
Severity: Severe The binary widget meta-language description file was compiled with a later version of Motif than that used by the UIL compiler.
User Action: Either get a later version of the UIL compiler or a widget meta-language description file compiled with an earlier version of Motif.
Severity: Warning The indicated object type does not support a gadget variant; only a widget variant is supported for this object type. The UIL compiler ignores the gadget indication, and creates widgets of this object type.
User Action: Specify that this object type is a widget instead of a gadget.
Severity: Error You have specified a color to be used in an icon that is not in that icon's color table. The invalid color is identified in the message by displaying the letter used to represent that color between the \ (backslashes). This letter was not defined in the specified color table.
User Action: Either add the color to the icon's color table or use a character representing a color in the color table. The default color table defines ' ' (space) as background and '*' (asterisk) as foreground.
Severity: Error The icons supported by UIL are rectangular (that is, x pixels wide by y pixels high). As a result, each of the strings used to represent a row of pixels in an icon must have the same length. The specified row does not have the same length as the first row.
User Action: Make all the strings in the icon function the same length.
Severity: Severe The include file name was not specified as a string literal.
User Action: Ensure that the include file name is a single or double quoted string literal and not a concatenated string or a value reference.
Severity: Error The structure of the UIL module is incorrect.
User Action: If there are any syntax errors reported, fix them and recompile. For example, if the error occurs before the first object declaration (that is, before your value and object declarations), check the syntax of the module header for unwanted; (semicolons) after the module clauses. If the error occurs at the end of the module, check that the module concludes with the keywords "end module;".
Severity: Warning The indicated enumerated value is not valid for the indicated argument.
User Action: Check the documentation of the indicated argument to determine the correct enumerated values it supports.
Severity: Error The indicated list item is not of the type required by the list. Arguments lists must contain argument entries, callbacks lists must contain callback entries, controls lists must contain control entries, and procedures lists must contain callback entries.
User Action: Check the syntax for the type of list entry that is required in this context and change the indicated list item.
Severity: Severe The compiler could not create the listing file noted in the message.
User Action: Check that you have write access to the directory you specified to hold the listing file.
Severity: Severe The compiler could not write a line into the listing file noted in the message.
User Action: Check to see that there is adequate space on the disk specified to hold the listing file.
Severity: Error You used a command line option that requires an argument and you did not provide that argument.
User Action: Omit the option or provide the argument.
Severity: Error The UIL compiler encountered a name longer than 31 characters. The compiler truncated the name to the leftmost 31 characters.
User Action: Shorten the name in the UIL module source.
Severity: Error The case-sensitivity clause, if specified, must be the first clause following the module's name. You have inserted another module clause before this clause.
User Action: Reorder the module clauses so that the case-sensitivity clause is first.
Severity: Error Certain UIL objects such as gadgets and widgets can be referred to before they are defined. The marked object is such an object. However, the compiler never found the object's declaration.
User Action: Check for misspelling. If the module is case sensitive, the spellings of names in declarations and in references must match exactly.
Severity: Warning The indicated argument does not support enumerated values.
User Action: Check the documentation of the argument to determine the correct type of value to provide for it.
Severity: Severe No source file was specified to compile.
User Action: Specify the name of a UIL specification file to compile.
Severity: Informational If the compiler reported error or severe diagnostics (that is, any of the diagnostic abbreviations starting with %UIL-E or %UIL-F), a UID file is not created. This diagnostic informs you that the compiler did not produce a UID file.
User Action: Fix the problems reported by the compiler.
Severity: Error A private value is one that is not imported or exported. In the context marked by the message, only a private value is legal. Situations where this message is issued include defining one value in terms of another, and arguments to functions. In general, a value must be private when the compiler must know the value at compilation time. Exported values are disallowed in these contexts, even though a value is present, because that value could be overridden at run time.
User Action: Change the value to be private.
Severity: Error You are using a feature of UIL that has not been implemented.
User Action: Try an alternate technique.
Severity: Warning You have created a string that has an embedded null character. Strings are represented in a UID file and in many Motif Toolkit data structures as null terminated strings. So, although the embedded nulls will be placed in the UID file, Motif Toolkit functions may interpret an embedded null as the terminator for the string.
User Action: Be very careful using embedded nulls.
Severity: Error Most arguments take values of a specific type. The value specified is not correct for this argument.
User Action: The message indicates the expected type of argument. Check that you have specified the intended value and that you specified the correct argument.
Severity: Error The indicated operand is not of a type that is supported by this operator.
User Action: Check the definition of the operator and make sure the type of the operand you specify is supported by the operator.
Severity: Severe The compiler ran out of virtual memory.
User Action: Reduce the size of your application.
Severity: Error The value specified is outside the legal range of its type.
User Action: Change the UIL module source.
Severity: Warning The name marked by the message is the same as the name of a built-in UIL name such as an argument name.
User Action: Be certain that you really want to override the particular name. If not, change the name being declared.
Severity: Severe Errors encountered during the compilation have caused the compiler to abort.
User Action: Fix the errors already diagnosed by the compiler and recompile.
Severity: Error The name marked by the message was used in a previous declaration. UIL requires that the names of all objects declared within a module be unique.
User Action: Check for a misspelling. If the module is case sensitive, the spellings of names in declarations and in references must match exactly.
Severity: Warning The indicated widget maps a single control to a subtree resource. For example, the pulldown control of a cascade button is mapped to the XmNsubMenuId resource. However, you have specified more than one control, resulting in the message.
User Action: Remove the extra children in the controls list.
Severity: Error The string associated with each color in a color table must hold exactly one character. You have specified a string with either fewer or more characters.
User Action: Use a single character to represent each color in a color table.
Severity: Warning You have specified a particular clause more than once in a context where that clause can occur only once. For example, the version clause in the module can only occur once.
User Action: Choose the correct clause and delete the others.
Severity: Warning Some error occurred while closing the indicated source file.
User Action: Check for operating or file system conditions that may have caused this problem. If the output file was successfully created, this warning can probably be ignored. If the output file was not created, attempt the compilation again.
Severity: Severe The compiler has a fixed limit of 100 for the number of source and include files that it can process. The file exceeding this limit is reported in the message.
User Action: Use fewer include files.
Severity: Error The specified source line contains a null character. The compiler ignores any text following the null character.
User Action: Replace each null character with the escape sequence \ (backslash).
Severity: Severe The compiler could not open the UIL specification file listed in the message.
User Action: Check that the file listed in the message is the one you want to compile, that it exists, and that you have read access to the file. If you are using a large number of include files, you may have exceeded your quota for open files.
Severity: Severe The compiler could not read a line of the UIL specification file listed in the message.
User Action: In the listing file, this message should appear following the last line the compiler read successfully. First check that the file you are compiling is a UIL specification file. If it is, the file most likely contains corrupted records.
Severity: Error The compiler encountered a source line greater than 132 characters. Characters beyond the 132 character limit were ignored.
User Action: Break each source line longer than 132 characters into several source lines. Long string literals can be created using the concatenation operator.
Severity: Severe The compiler diagnosed an internal error.
User Action: Get a listing and look where the error is being issued. Try fixing any faulty syntax in this area. If you are unable to prevent this error, submit a software problem report.
Severity: Informational This message lists a summary of the diagnostics issued by the compiler, and appears only when diagnostics have been issued.
User Action: Fix the problems reported. You can use the --w option qualifier to suppress informational and warning diagnostics that you have determined to be harmless.
Severity: Informational An argument or callback list has either a duplicate argument or duplicate reason.
User Action: This is not necessarily an error. The compiler is alerting you to make sure that you intended to override a prior argument's value. This informational message can be suppressed using the --w option qualifier.
Severity: Error At the point marked in the module, the compiler found a construct such as a punctuation mark, name, or keyword when it was expecting a different construct. The compiler continued analyzing the module at the next occurrence of the construct stated in the message.
User Action: Check the syntax of your UIL module at the point marked by the compiler. If the module specifies case-sensitive names, check that your keywords are in lowercase characters.
Severity: Error You exceeded a compiler limit such as the number of fonts in a font table or the number of strings in a translation table. The message indicates the limit imposed by the compiler.
User Action: Restructure your UIL module.
Severity: Warning You specified too many include directories using the --I option. The message indicates the limit imposed by the compiler.
User Action: Reduce the number of include directories specified. If necessary, consolidate some of your include files into fewer directories.
Severity: Severe The compiler could not create the UID file noted in the message. A UID file holds the compiled user-interface specification.
User Action: Check that you have write access to the directory you specified to hold the UID file. If you have a large number of source and include files, check that you have not exceeded your open file quota.
Severity: Severe An error occurred when trying to write to the indicated UID file.
User Action: Check that you have write access to the directory you specified to hold the UID file and that you have write access to the file, if it already exists. Also check that you have not run out of space in your file system.
Severity: Error The object pointed to in the message was either never defined or not defined prior to this point in the module. The compiler requires the object to be defined before you refer to the object.
User Action: Check for a misspelling of the object's name, a missing declaration for the object, or declaring the object after its first reference. If names in the module are case sensitive, the spellings of the name in the declaration and in the reference must match exactly.
Severity: Error The message is pointing to a context where a character set name is required. You have not specified the name of a character set in that context.
User Action: Check for misspelling. A list of the supported character sets is given in the UIL(5X) reference page. If you specified case-sensitive names in the module, check that the character set name is in lowercase characters.
Severity: Warning An unknown option has been used in the compiler command line.
User Action: Check what you typed on the command line.
Severity: Error The compiler detected a sequence of printable characters it did not understand. The compiler omitted the sequence of characters listed between the " " (double quotation marks).
User Action: Fix the UIL module source.
Severity: Warning The particular constraint argument you specified is not supported for the indicated widget or gadget parent.
User Action: See the UIL built-in tables in Appendix A for the constraints supported for the children of each object. If a widget creation function accepts a constraint argument that UIL rejects, this does not necessarily indicate that the UIL compiler is in error. Widget creation functions ignore arguments that they do not support, without notifying you that the argument is being ignored.
Severity: Warning Each widget or gadget supports a specific set of arguments, reasons, and children. The particular argument, reason, or child you specified is not supported for this widget or gadget.
User Action: See the UIL built-in tables in Appendix A and Appendix B for the arguments, reasons, and children supported for each object. If a widget creation function accepts an argument that UIL rejects, this does not necessarily indicate that the UIL compiler is in error. Widget creation functions ignore arguments that they do not support, without notifying you that the argument is being ignored.
Severity: Error The compiler detected a sequence that was not properly terminated, such as a string literal without the closing quotation mark.
User Action: Insert the proper termination characters.
Severity: Severe The compiler could not allocate enough memory to temporarily store the indicated value.
User Action: Reduce the size of the object being assigned to the indicated value.
Severity: Error The indicated object is referenced as a descendant of itself, either within its own definition or within the definition of one of the objects in the widget tree it controls.
User Action: Change the definition of the indicated object so that it is not a descendant of itself.
Severity: Severe The compiler could not open the widget meta-language description file listed in the message.
User Action: Check that the file listed in the message is the one you want to use, that it exists, and that you have read access to the file.
Severity: Error The indicated value is not of the specific type required by UIL in this context.
User Action: Check the definition of the function or clause.