diff options
| author | Matt Dew <marcoz@osource.org> | 2011-10-28 21:54:31 -0600 |
|---|---|---|
| committer | Matt Dew <marcoz@osource.org> | 2011-10-28 21:54:31 -0600 |
| commit | ba6dd48929114560d838aa29ce4111d8fdbf96e1 (patch) | |
| tree | 1c5517ea6311e423cae3306ab552c68c61a13b67 /specs/appC.xml | |
| parent | 9dd4f4d51c31e4d89f5057cae23e49991594939a (diff) | |
added xref links
Diffstat (limited to 'specs/appC.xml')
| -rwxr-xr-x | specs/appC.xml | 286 |
1 files changed, 143 insertions, 143 deletions
diff --git a/specs/appC.xml b/specs/appC.xml index a93dcef..7307a67 100755 --- a/specs/appC.xml +++ b/specs/appC.xml @@ -14,7 +14,7 @@ implemented an Xt<<emphasis remap='I'>Widget</emphasis>>Create (for exampl <function>XtLabelCreate</function>) function, in which most of the code was identical from widget to widget. In the Intrinsics, a single generic -<function>XtCreateWidget</function> +<xref linkend='XtCreateWidget' xrefstyle='select: title'/> performs most of the common work and then calls the initialize procedure implemented for the particular widget class. </para> @@ -26,9 +26,9 @@ Xt<<emphasis remap='I'>Widget</emphasis>>Add and an Xt<<emphasis remap= and <function>XtButtonBoxDeleteButton</function>). In the Intrinsics, the Composite generic procedures -<function>XtManageChildren</function> +<xref linkend='XtManageChildren' xrefstyle='select: title'/> and -<function>XtUnmanageChildren</function> +<xref linkend='XtUnmanageChildren' xrefstyle='select: title'/> perform error checking and screening out of certain children. Then they call the change_managed procedure implemented for the widget's Composite class. @@ -51,30 +51,30 @@ as: <para> Pop-up shells in some of the prototypes automatically performed an -<function>XtManageChild</function> +<xref linkend='XtManageChild' xrefstyle='select: title'/> on their child within their insert_child procedure. Creators of pop-up children need to call -<function>XtManageChild</function> +<xref linkend='XtManageChild' xrefstyle='select: title'/> themselves. </para> <para> -<function>XtAppInitialize</function> +<xref linkend='XtAppInitialize' xrefstyle='select: title'/> and -<function>XtVaAppInitialize</function> +<xref linkend='XtVaAppInitialize' xrefstyle='select: title'/> have been replaced by -<function>XtOpenApplication</function> +<xref linkend='XtOpenApplication' xrefstyle='select: title'/> and -<function>XtVaOpenApplication</function>. +<xref linkend='XtVaOpenApplication' xrefstyle='select: title'/>. </para> <para> To initialize the Intrinsics internals, create an application context, open and initialize a display, and create the initial application shell instance, an application may use -<function>XtAppInitialize</function> +<xref linkend='XtAppInitialize' xrefstyle='select: title'/> or -<function>XtVaAppInitialize</function>. +<xref linkend='XtVaAppInitialize' xrefstyle='select: title'/>. </para> <funcsynopsis id='XtAppInitialize'> @@ -188,30 +188,30 @@ Specifies the number of entries in the argument list. </variablelist> <para> The -<function>XtAppInitialize</function> +<xref linkend='XtAppInitialize' xrefstyle='select: title'/> function calls -<function>XtToolkitInitialize</function> +<xref linkend='XtToolkitInitialize' xrefstyle='select: title'/> followed by -<function>XtCreateApplicationContext</function>, +<xref linkend='XtCreateApplicationContext' xrefstyle='select: title'/>, then calls -<function>XtOpenDisplay</function> +<xref linkend='XtOpenDisplay' xrefstyle='select: title'/> with <emphasis remap='I'>display_string</emphasis> NULL and <emphasis remap='I'>application_name</emphasis> NULL, and finally calls -<function>XtAppCreateShell</function> +<xref linkend='XtAppCreateShell' xrefstyle='select: title'/> with <emphasis remap='I'>application_name</emphasis> NULL, <emphasis remap='I'>widget_class</emphasis> <function>application\%Shell\%Widget\%Class</function>, and the specified <emphasis remap='I'>args</emphasis> and <emphasis remap='I'>num_args</emphasis> and returns the created shell. The modified <emphasis remap='I'>argc</emphasis> and <emphasis remap='I'>argv</emphasis> returned by -<function>XtDisplayInitialize</function> +<xref linkend='XtDisplayInitialize' xrefstyle='select: title'/> are returned in <emphasis remap='I'>argc_in_out</emphasis> and <emphasis remap='I'>argv_in_out</emphasis>. If <emphasis remap='I'>app_context_return</emphasis> is not NULL, the created application context is also returned. If the display specified by the command line cannot be opened, an error message is issued and -<function>XtAppInitialize</function> +<xref linkend='XtAppInitialize' xrefstyle='select: title'/> terminates the application. If <emphasis remap='I'>fallback_resources</emphasis> is non-NULL, -<function>XtAppSetFallbackResources</function> +<xref linkend='XtAppSetFallbackResources' xrefstyle='select: title'/> is called with the value prior to calling -<function>XtOpenDisplay</function>. +<xref linkend='XtOpenDisplay' xrefstyle='select: title'/>. </para> <funcsynopsis id='XtVaAppInitialize'> @@ -313,9 +313,9 @@ resource specifications for the created shell. </variablelist> <para> The -<function>XtVaAppInitialize</function> +<xref linkend='XtVaAppInitialize' xrefstyle='select: title'/> procedure is identical in function to -<function>XtAppInitialize</function> +<xref linkend='XtAppInitialize' xrefstyle='select: title'/> with the <emphasis remap='I'>args</emphasis> and <emphasis remap='I'>num_args</emphasis> parameters replaced by a varargs list, as described in Section 2.5.1. @@ -324,20 +324,20 @@ in Section 2.5.1. <para> As a convenience to people converting from earlier versions of the toolkit without application contexts, the following routines exist: -<function>XtInitialize</function>, -<function>XtMainLoop</function>, -<function>XtNextEvent</function>, -<function>XtProcessEvent</function>, -<function>XtPeekEvent</function>, -<function>XtPending</function>, -<function>XtAddInput</function>, -<function>XtAddTimeOut</function>, -<function>XtAddWorkProc</function>, -<function>XtCreateApplicationShell</function>, -<function>XtAddActions</function>, -<function>XtSetSelectionTimeout</function>, +<xref linkend='XtInitialize' xrefstyle='select: title'/>, +<xref linkend='XtMainLoop' xrefstyle='select: title'/>, +<xref linkend='XtNextEvent' xrefstyle='select: title'/>, +<xref linkend='XtProcessEvent' xrefstyle='select: title'/>, +<xref linkend='XtPeekEvent' xrefstyle='select: title'/>, +<xref linkend='XtPending' xrefstyle='select: title'/>, +<xref linkend='XtAddInput' xrefstyle='select: title'/>, +<xref linkend='XtAddTimeOut' xrefstyle='select: title'/>, +<xref linkend='XtAddWorkProc' xrefstyle='select: title'/>, +<xref linkend='XtCreateApplicationShell' xrefstyle='select: title'/>, +<xref linkend='XtAddActions' xrefstyle='select: title'/>, +<xref linkend='XtSetSelectionTimeout' xrefstyle='select: title'/>, and -<function>XtGetSelectionTimeout</function>. +<xref linkend='XtGetSelectionTimeout' xrefstyle='select: title'/>. </para> <funcsynopsis id='XtInitialize'> @@ -417,23 +417,23 @@ Specifies the command line parameters. </varlistentry> </variablelist> <para> -<function>XtInitialize</function> +<xref linkend='XtInitialize' xrefstyle='select: title'/> calls -<function>XtToolkitInitialize</function> +<xref linkend='XtToolkitInitialize' xrefstyle='select: title'/> to initialize the toolkit internals, creates a default application context for use by the other convenience routines, calls -<function>XtOpenDisplay</function> +<xref linkend='XtOpenDisplay' xrefstyle='select: title'/> with <emphasis remap='I'>display_string</emphasis> NULL and <emphasis remap='I'>application_name</emphasis> NULL, and finally calls -<function>XtAppCreateShell</function> +<xref linkend='XtAppCreateShell' xrefstyle='select: title'/> with <emphasis remap='I'>application_name</emphasis> NULL and returns the created shell. The semantics of calling -<function>XtInitialize</function> +<xref linkend='XtInitialize' xrefstyle='select: title'/> more than once are undefined. This routine has been replaced by -<function>XtOpenApplication</function>. +<xref linkend='XtOpenApplication' xrefstyle='select: title'/>. </para> <funcsynopsis id='XtMainLoop'> @@ -444,13 +444,13 @@ This routine has been replaced by </funcsynopsis> <para> -<function>XtMainLoop</function> +<xref linkend='XtMainLoop' xrefstyle='select: title'/> first reads the next alternate input, timer, or X event by calling -<function>XtNextEvent</function>. +<xref linkend='XtNextEvent' xrefstyle='select: title'/>. Then it dispatches this to the appropriate registered procedure by calling -<function>XtDispatchEvent</function>. +<xref linkend='XtDispatchEvent' xrefstyle='select: title'/>. This routine has been replaced by -<function>XtAppMainLoop</function>. +<xref linkend='XtAppMainLoop' xrefstyle='select: title'/>. </para> <funcsynopsis id='XtNextEvent'> @@ -474,13 +474,13 @@ Returns the event information to the specified event structure. </variablelist> <para> If no input is on the X input queue for the default application context, -<function>XtNextEvent</function> +<xref linkend='XtNextEvent' xrefstyle='select: title'/> flushes the X output buffer and waits for an event while looking at the alternate input sources and timeout values and calling any callback procedures triggered by them. This routine has been replaced by -<function>XtAppNextEvent</function>. -<function>XtInitialize</function> +<xref linkend='XtAppNextEvent' xrefstyle='select: title'/>. +<xref linkend='XtInitialize' xrefstyle='select: title'/> must be called before using this routine. </para> @@ -504,12 +504,12 @@ Specifies the type of input to process. </varlistentry> </variablelist> <para> -<function>XtProcessEvent</function> +<xref linkend='XtProcessEvent' xrefstyle='select: title'/> processes one X event, timeout, or alternate input source (depending on the value of <emphasis remap='I'>mask</emphasis>), blocking if necessary. It has been replaced by -<function>XtAppProcessEvent</function>. -<function>XtInitialize</function> +<xref linkend='XtAppProcessEvent' xrefstyle='select: title'/>. +<xref linkend='XtInitialize' xrefstyle='select: title'/> must be called before using this function. </para> @@ -534,21 +534,21 @@ Returns the event information to the specified event structure. </variablelist> <para> If there is an event in the queue for the default application context, -<function>XtPeekEvent</function> +<xref linkend='XtPeekEvent' xrefstyle='select: title'/> fills in the event and returns a nonzero value. If no X input is on the queue, -<function>XtPeekEvent</function> +<xref linkend='XtPeekEvent' xrefstyle='select: title'/> flushes the output buffer and blocks until input is available, possibly calling some timeout callbacks in the process. If the input is an event, -<function>XtPeekEvent</function> +<xref linkend='XtPeekEvent' xrefstyle='select: title'/> fills in the event and returns a nonzero value. Otherwise, the input is for an alternate input source, and -<function>XtPeekEvent</function> +<xref linkend='XtPeekEvent' xrefstyle='select: title'/> returns zero. This routine has been replaced by -<function>XtAppPeekEvent</function>. -<function>XtInitialize</function> +<xref linkend='XtAppPeekEvent' xrefstyle='select: title'/>. +<xref linkend='XtInitialize' xrefstyle='select: title'/> must be called before using this routine. </para> @@ -560,15 +560,15 @@ must be called before using this routine. </funcsynopsis> <para> -<function>XtPending</function> +<xref linkend='XtPending' xrefstyle='select: title'/> returns a nonzero value if there are events pending from the X server or alternate input sources in the default application context. If there are no events pending, it flushes the output buffer and returns a zero value. It has been replaced by -<function>XtAppPending</function>. -<function>XtInitialize</function> +<xref linkend='XtAppPending' xrefstyle='select: title'/>. +<xref linkend='XtInitialize' xrefstyle='select: title'/> must be called before using this routine. </para> @@ -628,19 +628,19 @@ Specifies the parameter to be passed to <emphasis remap='I'>proc</emphasis> when </variablelist> <para> The -<function>XtAddInput</function> +<xref linkend='XtAddInput' xrefstyle='select: title'/> function registers in the default application context a new source of events, which is usually file input but can also be file output. (The word <emphasis remap='I'>file</emphasis> should be loosely interpreted to mean any sink or source of data.) -<function>XtAddInput</function> +<xref linkend='XtAddInput' xrefstyle='select: title'/> also specifies the conditions under which the source can generate events. When input is pending on this source in the default application context, the callback procedure is called. This routine has been replaced by -<function>XtAppAddInput</function>. -<function>XtInitialize</function> +<xref linkend='XtAppAddInput' xrefstyle='select: title'/>. +<xref linkend='XtInitialize' xrefstyle='select: title'/> must be called before using this routine. </para> @@ -687,15 +687,15 @@ Specifies the parameter to be passed to <emphasis remap='I'>proc</emphasis> when </variablelist> <para> The -<function>XtAddTimeOut</function> +<xref linkend='XtAddTimeOut' xrefstyle='select: title'/> function creates a timeout in the default application context and returns an identifier for it. The timeout value is set to <emphasis remap='I'>interval</emphasis>. The callback procedure will be called after the time interval elapses, after which the timeout is removed. This routine has been replaced by -<function>XtAppAddTimeOut</function>. -<function>XtInitialize</function> +<xref linkend='XtAppAddTimeOut' xrefstyle='select: title'/>. +<xref linkend='XtInitialize' xrefstyle='select: title'/> must be called before using this routine. </para> @@ -732,8 +732,8 @@ Client data to pass to <emphasis remap='I'>proc</emphasis> when it is called. <para> This routine registers a work procedure in the default application context. It has been replaced by -<function>XtAppAddWorkProc</function>. -<function>XtInitialize</function> +<xref linkend='XtAppAddWorkProc' xrefstyle='select: title'/>. +<xref linkend='XtInitialize' xrefstyle='select: title'/> must be called before using this routine. </para> @@ -794,20 +794,20 @@ Specifies the number of entries in <emphasis remap='I'>args</emphasis>. </variablelist> <para> The procedure -<function>XtCreateApplicationShell</function> +<xref linkend='XtCreateApplicationShell' xrefstyle='select: title'/> calls -<function>XtAppCreateShell</function> +<xref linkend='XtAppCreateShell' xrefstyle='select: title'/> with <emphasis remap='I'>application_name</emphasis> NULL, the application class passed to -<function>XtInitialize</function>, +<xref linkend='XtInitialize' xrefstyle='select: title'/>, and the default application context created by -<function>XtInitialize</function>. +<xref linkend='XtInitialize' xrefstyle='select: title'/>. This routine has been replaced by -<function>XtAppCreateShell</function>. +<xref linkend='XtAppCreateShell' xrefstyle='select: title'/>. </para> <para> An old-format resource type converter procedure pointer is of type -<function>XtConverter</function>. +<xref linkend='XtConverter' xrefstyle='select: title'/>. </para> <funcsynopsis id='XtConverter'> @@ -884,7 +884,7 @@ Attempt the type conversion. <para> If successful, return the size and pointer to the data in the <emphasis remap='I'>to</emphasis> argument; otherwise, call -<function>XtWarningMsg</function> +<xref linkend='XtWarningMsg' xrefstyle='select: title'/> and return without modifying the <emphasis remap='I'>to</emphasis> argument. </para> </listitem> @@ -907,14 +907,14 @@ It should be a pointer to a static variable. <para> The procedure type -<function>XtConverter</function> +<xref linkend='XtConverter' xrefstyle='select: title'/> has been replaced by -<function>XtTypeConverter</function>. +<xref linkend='XtTypeConverter' xrefstyle='select: title'/>. </para> <para> The -<function>XtStringConversionWarning</function> +<xref linkend='XtStringConversionWarning' xrefstyle='select: title'/> function is a convenience routine for old-format resource converters that convert from strings. </para> @@ -950,19 +950,19 @@ Specifies the name of the type to which the string could not be converted. </variablelist> <para> The -<function>XtStringConversionWarning</function> +<xref linkend='XtStringConversionWarning' xrefstyle='select: title'/> function issues a warning message with name "conversionError", type "string", class "XtToolkitError, and the default message string "Cannot convert "<emphasis remap='I'>src</emphasis>" to type <emphasis remap='I'>dst_type</emphasis>". This routine has been superseded by -<function>XtDisplayStringConversionWarning</function>. +<xref linkend='XtDisplayStringConversionWarning' xrefstyle='select: title'/>. </para> <para> To register an old-format converter, use -<function>XtAddConverter</function> +<xref linkend='XtAddConverter' xrefstyle='select: title'/> or -<function>XtAppAddConverter</function>. +<xref linkend='XtAppAddConverter' xrefstyle='select: title'/>. </para> <funcsynopsis id='XtAddConverter'> @@ -1029,13 +1029,13 @@ Specifies the number of entries in <emphasis remap='I'>convert_args</emphasis>. </varlistentry> </variablelist> <para> -<function>XtAddConverter</function> +<xref linkend='XtAddConverter' xrefstyle='select: title'/> is equivalent in function to -<function>XtSetTypeConverter</function> +<xref linkend='XtSetTypeConverter' xrefstyle='select: title'/> with <emphasis remap='I'>cache_type</emphasis> equal to <function>XtCacheAll</function> for old-format type converters. It has been superseded by -<function>XtSetTypeConverter</function>. +<xref linkend='XtSetTypeConverter' xrefstyle='select: title'/>. </para> <funcsynopsis id='XtAppAddConverter'> @@ -1113,20 +1113,20 @@ Specifies the number of entries in <emphasis remap='I'>convert_args</emphasis>. </varlistentry> </variablelist> <para> -<function>XtAppAddConverter</function> +<xref linkend='XtAppAddConverter' xrefstyle='select: title'/> is equivalent in function to -<function>XtAppSetTypeConverter</function> +<xref linkend='XtAppSetTypeConverter' xrefstyle='select: title'/> with <emphasis remap='I'>cache_type</emphasis> equal to <function>XtCacheAll</function> for old-format type converters. It has been superseded by -<function>XtAppSetTypeConverter</function>. +<xref linkend='XtAppSetTypeConverter' xrefstyle='select: title'/>. </para> <para> To invoke resource conversions, a client may use -<function>XtConvert</function> +<xref linkend='XtConvert' xrefstyle='select: title'/> or, for old-format converters only, -<function>XtDirectConvert</function>. +<xref linkend='XtDirectConvert' xrefstyle='select: title'/>. </para> <funcsynopsis id='XtConvert'> @@ -1260,14 +1260,14 @@ Returns the converted value. </variablelist> <para> The -<function>XtConvert</function> +<xref linkend='XtConvert' xrefstyle='select: title'/> function looks up the type converter registered to convert <emphasis remap='I'>from_type</emphasis> to <emphasis remap='I'>to_type</emphasis>, computes any additional arguments needed, and then calls -<function>XtDirectConvert</function> +<xref linkend='XtDirectConvert' xrefstyle='select: title'/> or -<function>XtCallConverter</function>. +<xref linkend='XtCallConverter' xrefstyle='select: title'/>. The -<function>XtDirectConvert</function> +<xref linkend='XtDirectConvert' xrefstyle='select: title'/> function looks in the converter cache to see if this conversion procedure has been called with the specified arguments. If so, it returns a descriptor for information stored in the cache; @@ -1276,29 +1276,29 @@ otherwise, it calls the converter and enters the result in the cache. <para> Before calling the specified converter, -<function>XtDirectConvert</function> +<xref linkend='XtDirectConvert' xrefstyle='select: title'/> sets the return value size to zero and the return value address to NULL. To determine if the conversion was successful, the client should check <emphasis remap='I'>to_return.addr</emphasis> for non-NULL. The data returned by -<function>XtConvert</function> +<xref linkend='XtConvert' xrefstyle='select: title'/> must be copied immediately by the caller, as it may point to static data in the type converter. </para> <para> -<function>XtConvert</function> +<xref linkend='XtConvert' xrefstyle='select: title'/> has been replaced by -<function>XtConvertAndStore</function>, +<xref linkend='XtConvertAndStore' xrefstyle='select: title'/>, and -<function>XtDirectConvert</function> +<xref linkend='XtDirectConvert' xrefstyle='select: title'/> has been superseded by -<function>XtCallConverter</function>. +<xref linkend='XtCallConverter' xrefstyle='select: title'/>. </para> <para> To deallocate a shared GC when it is no longer needed, use -<function>XtDestroyGC</function>. +<xref linkend='XtDestroyGC' xrefstyle='select: title'/>. </para> <funcsynopsis id='XtDestroyGC'> @@ -1336,18 +1336,18 @@ Specifies the shared GC to be deallocated. References to sharable GCs are counted and a free request is generated to the server when the last user of a given GC destroys it. Note that some earlier versions of -<function>XtDestroyGC</function> +<xref linkend='XtDestroyGC' xrefstyle='select: title'/> had only a <emphasis remap='I'>gc</emphasis> argument. Therefore, this function is not very portable, and you are encouraged to use -<function>XtReleaseGC</function> +<xref linkend='XtReleaseGC' xrefstyle='select: title'/> instead. </para> <para> To declare an action table in the default application context and register it with the translation manager, use -<function>XtAddActions</function>. +<xref linkend='XtAddActions' xrefstyle='select: title'/>. </para> <funcsynopsis id='XtAddActions'> @@ -1386,19 +1386,19 @@ the most recently registered action is used. If duplicate actions exist in an action table, the first is used. The Intrinsics register an action table for -<function>XtMenuPopup</function> +<xref linkend='XtMenuPopup' xrefstyle='select: title'/> and -<function>XtMenuPopdown</function> +<xref linkend='XtMenuPopdown' xrefstyle='select: title'/> as part of X Toolkit initialization. This routine has been replaced by -<function>XtAppAddActions</function>. -<function>XtInitialize</function> +<xref linkend='XtAppAddActions' xrefstyle='select: title'/>. +<xref linkend='XtInitialize' xrefstyle='select: title'/> must be called before using this routine. </para> <para> To set the Intrinsics selection timeout in the default application context, use -<function>XtSetSelectionTimeout</function>. +<xref linkend='XtSetSelectionTimeout' xrefstyle='select: title'/>. </para> <funcsynopsis id='XtSetSelectionTimeout'> @@ -1418,8 +1418,8 @@ To set the Intrinsics selection timeout in the default application context, use <para> Specifies the selection timeout in milliseconds. This routine has been replaced by -<function>XtAppSetSelectionTimeout</function>. -<function>XtInitialize</function> +<xref linkend='XtAppSetSelectionTimeout' xrefstyle='select: title'/>. +<xref linkend='XtInitialize' xrefstyle='select: title'/> must be called before using this routine. </para> </listitem> @@ -1429,7 +1429,7 @@ must be called before using this routine. <para> To get the current selection timeout value in the default application context, use -<function>XtGetSelectionTimeout</function>. +<xref linkend='XtGetSelectionTimeout' xrefstyle='select: title'/>. </para> <funcsynopsis id='XtGetSelectionTimeout'> @@ -1448,15 +1448,15 @@ the Intrinsics abort the selection request. <para> This routine has been replaced by -<function>XtAppGetSelectionTimeout</function>. -<function>XtInitialize</function> +<xref linkend='XtAppGetSelectionTimeout' xrefstyle='select: title'/>. +<xref linkend='XtInitialize' xrefstyle='select: title'/> must be called before using this routine. </para> <para> To obtain the global error database (for example, to merge with an application- or widget-specific database), use -<function>XtGetErrorDatabase</function>. +<xref linkend='XtGetErrorDatabase' xrefstyle='select: title'/>. </para> <funcsynopsis id='XtGetErrorDatabase'> @@ -1468,19 +1468,19 @@ an application- or widget-specific database), use <para> The -<function>XtGetErrorDatabase</function> +<xref linkend='XtGetErrorDatabase' xrefstyle='select: title'/> function returns the address of the error database. The Intrinsics do a lazy binding of the error database and do not merge in the database file until the first call to <function>XtGetErrorDatbaseText</function>. This routine has been replaced by -<function>XtAppGetErrorDatabase</function>. +<xref linkend='XtAppGetErrorDatabase' xrefstyle='select: title'/>. </para> <para> An error message handler can obtain the error database text for an error or a warning by calling -<function>XtGetErrorDatabaseText</function>. +<xref linkend='XtGetErrorDatabaseText' xrefstyle='select: title'/>. </para> <funcsynopsis id='XtGetErrorDatabaseText'> @@ -1556,7 +1556,7 @@ Specifies the size of the buffer in bytes. </variablelist> <para> The -<function>XtGetErrorDatabaseText</function> +<xref linkend='XtGetErrorDatabaseText' xrefstyle='select: title'/> returns the appropriate message from the error database associated with the default application context or returns the specified default message if one is not found in the @@ -1566,12 +1566,12 @@ the <emphasis remap='I'>name</emphasis> and <emphasis remap='I'>type</emphasis> between them and the <emphasis remap='I'>class</emphasis> is concatenated with itself with a single "." if it does not already contain a ".". This routine has been superseded by -<function>XtAppGetErrorDatabaseText</function>. +<xref linkend='XtAppGetErrorDatabaseText' xrefstyle='select: title'/>. </para> <para> To register a procedure to be called on fatal error conditions, use -<function>XtSetErrorMsgHandler</function>. +<xref linkend='XtSetErrorMsgHandler' xrefstyle='select: title'/>. </para> <funcsynopsis id='XtSetErrorMsgHandler'> @@ -1596,17 +1596,17 @@ Specifies the new fatal error procedure, which should not return. <para> The default error handler provided by the Intrinsics constructs a string from the error resource database and calls -<function>XtError</function>. +<xref linkend='XtError' xrefstyle='select: title'/>. Fatal error message handlers should not return. If one does, subsequent Intrinsics behavior is undefined. This routine has been superseded by -<function>XtAppSetErrorMsgHandler</function>. +<xref linkend='XtAppSetErrorMsgHandler' xrefstyle='select: title'/>. </para> <para> To call the high-level error handler, use -<function>XtErrorMsg</function>. +<xref linkend='XtErrorMsg' xrefstyle='select: title'/>. </para> <funcsynopsis id='XtErrorMsg'> @@ -1685,12 +1685,12 @@ Specifies the number of entries in <emphasis remap='I'>params</emphasis>. </variablelist> <para> This routine has been superseded by -<function>XtAppErrorMsg</function>. +<xref linkend='XtAppErrorMsg' xrefstyle='select: title'/>. </para> <para> To register a procedure to be called on nonfatal error conditions, use -<function>XtSetWarningMsgHandler</function>. +<xref linkend='XtSetWarningMsgHandler' xrefstyle='select: title'/>. </para> <funcsynopsis id='XtSetWarningMsgHandler'> @@ -1715,14 +1715,14 @@ Specifies the new nonfatal error procedure, which usually returns. <para> The default warning handler provided by the Intrinsics constructs a string from the error resource database and calls -<function>XtWarning</function>. +<xref linkend='XtWarning' xrefstyle='select: title'/>. This routine has been superseded by -<function>XtAppSetWarningMsgHandler</function>. +<xref linkend='XtAppSetWarningMsgHandler' xrefstyle='select: title'/>. </para> <para> To call the installed high-level warning handler, use -<function>XtWarningMsg</function>. +<xref linkend='XtWarningMsg' xrefstyle='select: title'/>. </para> <funcsynopsis id='XtWarningMsg'> @@ -1801,12 +1801,12 @@ Specifies the number of entries in <emphasis remap='I'>params</emphasis>. </variablelist> <para> This routine has been superseded by -<function>XtAppWarningMsg</function>. +<xref linkend='XtAppWarningMsg' xrefstyle='select: title'/>. </para> <para> To register a procedure to be called on fatal error conditions, use -<function>XtSetErrorHandler</function>. +<xref linkend='XtSetErrorHandler' xrefstyle='select: title'/>. </para> <funcsynopsis id='XtSetErrorHandler'> @@ -1837,12 +1837,12 @@ Fatal error message handlers should not return. If one does, subsequent X Toolkit behavior is undefined. This routine has been superseded by -<function>XtAppSetErrorHandler</function>. +<xref linkend='XtAppSetErrorHandler' xrefstyle='select: title'/>. </para> <para> To call the installed fatal error procedure, use -<function>XtError</function>. +<xref linkend='XtError' xrefstyle='select: title'/>. </para> <funcsynopsis id='XtError'> @@ -1866,17 +1866,17 @@ Specifies the message to be reported. </variablelist> <para> Most programs should use -<function>XtAppErrorMsg</function>, +<xref linkend='XtAppErrorMsg' xrefstyle='select: title'/>, not -<function>XtError</function>, +<xref linkend='XtError' xrefstyle='select: title'/>, to provide for customization and internationalization of error messages. This routine has been superseded by -<function>XtAppError</function>. +<xref linkend='XtAppError' xrefstyle='select: title'/>. </para> <para> To register a procedure to be called on nonfatal error conditions, use -<function>XtSetWarningHandler</function>. +<xref linkend='XtSetWarningHandler' xrefstyle='select: title'/>. </para> <funcsynopsis id='XtSetWarningHandler'> @@ -1904,12 +1904,12 @@ The default warning handler provided by the Intrinsics is On POSIX-based systems, it prints the message to standard error and returns to the caller. This routine has been superseded by -<function>XtAppSetWarningHandler</function>. +<xref linkend='XtAppSetWarningHandler' xrefstyle='select: title'/>. </para> <para> To call the installed nonfatal error procedure, use -<function>XtWarning</function>. +<xref linkend='XtWarning' xrefstyle='select: title'/>. </para> <funcsynopsis id='XtWarning'> @@ -1933,11 +1933,11 @@ Specifies the nonfatal error message to be reported. </variablelist> <para> Most programs should use -<function>XtAppWarningMsg</function>, +<xref linkend='XtAppWarningMsg' xrefstyle='select: title'/>, not -<function>XtWarning</function>, +<xref linkend='XtWarning' xrefstyle='select: title'/>, to provide for customization and internationalization of warning messages. This routine has been superseded by -<function>XtAppWarning</function>. +<xref linkend='XtAppWarning' xrefstyle='select: title'/>. </para> </appendix> |
