This page describes the format and contents of each reference page in Section 6, which covers the functions from the Xmu utilities library that may be useful to Xt programmers.  Note that not all vendors supply Xmu with their X Window System software.

NAME

Function − a brief description of the function. 

SYNOPSIS

This section shows the signature of the function: the names and types of the arguments, and the type of the return value.  It also shows the header file that must be included to declare the function.  For predefined resource converters and event handlers, this section shows how to register the function, rather than the actual function signature. 

Inputs

This subsection describes each of the function arguments that pass information to the function. 

Outputs

This subsection describes any of the function arguments that are used to return information from the function.  These arguments are always of some pointer type, and you should use the C address-of operator (&) to pass the address of the variable in which the function will store the return value.  Note that because the list of function arguments is broken into "Input" and "Output" sections, they do not always appear in the same order that they are passed to the function.  See the function signature for the actual calling order. 

Returns

This subsection explains the return value of the function, if any. 

AVAILABILITY

This section appears for functions that were added in Release 5, and are not available in earlier releases. 

DESCRIPTION

This section explains what the function does and describes its arguments and return value.  If you’ve used the function before and are just looking for a refresher, this section and the synopsis above should be all you need. 

USAGE

This section appears for most functions and provides less formal information about the function: when and how you might want to use it, things to watch out for, and related functions that you might want to consider. 

STRUCTURES

This section shows the definition of structures, enumerated types, typedefs, or symbolic constants used by the function. 

SEE ALSO

This section refers you to related functions, prototype procedures, Intrinsics widget classes, or widget methods.  The numbers in parentheses following each reference refer to the sections of this book in which they are found.