sync code with last improvements from OpenBSD
This commit is contained in:
commit
88965415ff
26235 changed files with 29195616 additions and 0 deletions
2810
lib/libXt/specs/CH01.xml
Normal file
2810
lib/libXt/specs/CH01.xml
Normal file
File diff suppressed because it is too large
Load diff
4540
lib/libXt/specs/CH02.xml
Normal file
4540
lib/libXt/specs/CH02.xml
Normal file
File diff suppressed because it is too large
Load diff
1402
lib/libXt/specs/CH03.xml
Normal file
1402
lib/libXt/specs/CH03.xml
Normal file
File diff suppressed because it is too large
Load diff
2498
lib/libXt/specs/CH04.xml
Normal file
2498
lib/libXt/specs/CH04.xml
Normal file
File diff suppressed because it is too large
Load diff
1066
lib/libXt/specs/CH05.xml
Normal file
1066
lib/libXt/specs/CH05.xml
Normal file
File diff suppressed because it is too large
Load diff
1372
lib/libXt/specs/CH06.xml
Normal file
1372
lib/libXt/specs/CH06.xml
Normal file
File diff suppressed because it is too large
Load diff
5001
lib/libXt/specs/CH07.xml
Normal file
5001
lib/libXt/specs/CH07.xml
Normal file
File diff suppressed because it is too large
Load diff
616
lib/libXt/specs/CH08.xml
Normal file
616
lib/libXt/specs/CH08.xml
Normal file
|
@ -0,0 +1,616 @@
|
|||
<?xml version="1.0" encoding="UTF-8" ?>
|
||||
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
|
||||
|
||||
<chapter id='Callbacks'>
|
||||
<title>Callbacks</title>
|
||||
<para>
|
||||
Applications and other widgets often need to register a procedure
|
||||
with a widget that gets called under certain prespecified conditions.
|
||||
For example,
|
||||
when a widget is destroyed,
|
||||
every procedure on the widget's <emphasis remap='I'>destroy_callbacks</emphasis>
|
||||
list is called to notify clients of the widget's impending doom.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Every widget has an XtNdestroyCallbacks callback list resource.
|
||||
Widgets can define additional callback lists as they see fit.
|
||||
For example, the Pushbutton widget has a callback
|
||||
list to notify clients when the button has been activated.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Except where otherwise noted, it is the intent that all Intrinsics
|
||||
functions may be called at any time, including from within callback
|
||||
procedures, action routines, and event handlers.
|
||||
</para>
|
||||
<sect1 id="Using_Callback_Procedure_and_Callback_List_Definitions">
|
||||
<title>Using Callback Procedure and Callback List Definitions</title>
|
||||
<para>
|
||||
Callback procedure pointers for use in callback lists are of type
|
||||
<xref linkend='XtCallbackProc' xrefstyle='select: title'/>.
|
||||
</para>
|
||||
|
||||
<funcsynopsis id='XtCallbackProc'>
|
||||
<funcprototype>
|
||||
<funcdef>typedef void <function>(*XtCallbackProc)</function></funcdef>
|
||||
<paramdef>Widget <parameter>w</parameter></paramdef>
|
||||
<paramdef>XtPointer <parameter>client_data</parameter></paramdef>
|
||||
<paramdef>XtPointer <parameter>call_data</parameter></paramdef>
|
||||
</funcprototype>
|
||||
</funcsynopsis>
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term>
|
||||
<emphasis remap='I'>w</emphasis>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Specifies the widget owning the list in which the callback is registered.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term>
|
||||
<emphasis remap='I'>client_data</emphasis>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Specifies additional data supplied by the client when the procedure
|
||||
was registered.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term>
|
||||
<emphasis remap='I'>call_data</emphasis>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Specifies any callback-specific data the widget wants to pass to the client.
|
||||
For example, when Scrollbar executes its XtNthumbChanged callback list,
|
||||
it passes the new position of the thumb.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
<para>
|
||||
The <emphasis remap='I'>client_data</emphasis> argument provides a way for the
|
||||
client registering the callback procedure also to register client-specific data,
|
||||
for example, a pointer to additional information about the widget,
|
||||
a reason for invoking the callback, and so on.
|
||||
The <emphasis remap='I'>client_data</emphasis> value may be NULL
|
||||
if all necessary information is in the widget.
|
||||
The <emphasis remap='I'>call_data</emphasis> argument is a convenience to avoid having simple
|
||||
cases where the client could otherwise always call
|
||||
<xref linkend='XtGetValues' xrefstyle='select: title'/>
|
||||
or a widget-specific function to retrieve data from the widget.
|
||||
Widgets should generally avoid putting complex state information
|
||||
in <emphasis remap='I'>call_data</emphasis>.
|
||||
The client can use the more general data retrieval methods, if necessary.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Whenever a client wants to pass a callback list as an argument in an
|
||||
<xref linkend='XtCreateWidget' xrefstyle='select: title'/>,
|
||||
<xref linkend='XtSetValues' xrefstyle='select: title'/>,
|
||||
or
|
||||
<xref linkend='XtGetValues' xrefstyle='select: title'/>
|
||||
call, it should specify the address
|
||||
of a NULL-terminated array of type
|
||||
<function>XtCallbackList</function>.
|
||||
</para>
|
||||
<programlisting>
|
||||
typedef struct {
|
||||
XtCallbackProc callback;
|
||||
XtPointer closure;
|
||||
} XtCallbackRec, *XtCallbackList;
|
||||
</programlisting>
|
||||
<para>
|
||||
For example, the callback list for procedures A and B with client data
|
||||
clientDataA and clientDataB, respectively, is
|
||||
</para>
|
||||
<programlisting>
|
||||
static XtCallbackRec callbacks[] = {
|
||||
{A, (XtPointer) clientDataA},
|
||||
{B, (XtPointer) clientDataB},
|
||||
{(XtCallbackProc) NULL, (XtPointer) NULL}
|
||||
};
|
||||
</programlisting>
|
||||
<para>
|
||||
Although callback lists are passed by address in arglists
|
||||
and varargs lists,
|
||||
the Intrinsics recognize callback lists
|
||||
through the widget resource list and will copy the contents
|
||||
when necessary.
|
||||
Widget initialize and set_values procedures
|
||||
should not allocate memory for the callback list contents.
|
||||
The Intrinsics automatically do this,
|
||||
potentially using a different structure for their
|
||||
internal representation.
|
||||
</para>
|
||||
</sect1>
|
||||
|
||||
<sect1 id="Identifying_Callback_Lists">
|
||||
<title>Identifying Callback Lists</title>
|
||||
<para>
|
||||
Whenever a widget contains a callback list for use by clients,
|
||||
it also exports in its public .h file the resource name of the callback list.
|
||||
Applications and client widgets never access callback list fields directly.
|
||||
Instead, they always identify the desired callback list by using the exported
|
||||
resource name.
|
||||
All the callback manipulation functions described in this chapter
|
||||
except
|
||||
<xref linkend='XtCallCallbackList' xrefstyle='select: title'/>
|
||||
check
|
||||
to see that the requested callback list is indeed implemented by the widget.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
For the Intrinsics to find and correctly handle callback lists,
|
||||
they must be declared with a resource type of
|
||||
<function>XtRCallback</function>.
|
||||
The internal representation of a callback list is
|
||||
implementation-dependent; widgets may make no assumptions about the
|
||||
value stored in this resource if it is non-NULL. Except to compare
|
||||
the value to NULL (which is equivalent to
|
||||
<function>XtCallbackStatus</function>
|
||||
<function>XtCallbackHasNone</function>),
|
||||
access to callback list resources must be made
|
||||
through other Intrinsics procedures.
|
||||
</para>
|
||||
</sect1>
|
||||
|
||||
<sect1 id="Adding_Callback_Procedures">
|
||||
<title>Adding Callback Procedures</title>
|
||||
<para>
|
||||
To add a callback procedure to a widget's callback list, use
|
||||
<xref linkend='XtAddCallback' xrefstyle='select: title'/>.
|
||||
</para>
|
||||
|
||||
<funcsynopsis id='XtAddCallback'>
|
||||
<funcprototype>
|
||||
<funcdef>void <function>XtAddCallback</function></funcdef>
|
||||
<paramdef>Widget <parameter>w</parameter></paramdef>
|
||||
<paramdef>const char * <parameter>callback_name</parameter></paramdef>
|
||||
<paramdef>XtCallbackProc <parameter>callback</parameter></paramdef>
|
||||
<paramdef>XtPointer <parameter>client_data</parameter></paramdef>
|
||||
</funcprototype>
|
||||
</funcsynopsis>
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term>
|
||||
<emphasis remap='I'>w</emphasis>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Specifies the widget. Must be of class Object or any subclass thereof.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term>
|
||||
<emphasis remap='I'>callback_name</emphasis>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Specifies the callback list to which the procedure is to be appended.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term>
|
||||
<emphasis remap='I'>callback</emphasis>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Specifies the callback procedure.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term>
|
||||
<emphasis remap='I'>client_data</emphasis>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Specifies additional data to be passed to the specified procedure
|
||||
when it is invoked,
|
||||
or NULL.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
<para>
|
||||
A callback will be invoked as many times as it occurs in the callback list.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
To add a list of callback procedures to a given widget's callback list, use
|
||||
<xref linkend='XtAddCallbacks' xrefstyle='select: title'/>.
|
||||
</para>
|
||||
|
||||
<funcsynopsis id='XtAddCallbacks'>
|
||||
<funcprototype>
|
||||
<funcdef>void <function>XtAddCallbacks</function></funcdef>
|
||||
<paramdef>Widget <parameter>w</parameter></paramdef>
|
||||
<paramdef>const char * <parameter>callback_name</parameter></paramdef>
|
||||
<paramdef>XtCallbackList <parameter>callbacks</parameter></paramdef>
|
||||
</funcprototype>
|
||||
</funcsynopsis>
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term>
|
||||
<emphasis remap='I'>w</emphasis>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Specifies the widget. Must be of class Object or any subclass thereof.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term>
|
||||
<emphasis remap='I'>callback_name</emphasis>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Specifies the callback list to which the procedures are to be appended.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term>
|
||||
<emphasis remap='I'>callbacks</emphasis>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Specifies the null-terminated list of callback procedures and corresponding
|
||||
client data.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
|
||||
</sect1>
|
||||
|
||||
<sect1 id="Removing_Callback_Procedures">
|
||||
<title>Removing Callback Procedures</title>
|
||||
<para>
|
||||
To delete a callback procedure from a widget's callback list, use
|
||||
<xref linkend='XtRemoveCallback' xrefstyle='select: title'/>.
|
||||
</para>
|
||||
|
||||
<funcsynopsis id='XtRemoveCallback'>
|
||||
<funcprototype>
|
||||
<funcdef>void <function>XtRemoveCallback</function></funcdef>
|
||||
<paramdef>Widget <parameter>w</parameter></paramdef>
|
||||
<paramdef>const char * <parameter>callback_name</parameter></paramdef>
|
||||
<paramdef>XtCallbackProc <parameter>callback</parameter></paramdef>
|
||||
<paramdef>XtPointer <parameter>client_data</parameter></paramdef>
|
||||
</funcprototype>
|
||||
</funcsynopsis>
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term>
|
||||
<emphasis remap='I'>w</emphasis>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Specifies the widget. Must be of class Object or any subclass thereof.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term>
|
||||
<emphasis remap='I'>callback_name</emphasis>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Specifies the callback list from which the procedure is to be deleted.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term>
|
||||
<emphasis remap='I'>callback</emphasis>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Specifies the callback procedure.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term>
|
||||
<emphasis remap='I'>client_data</emphasis>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Specifies the client data to match with the registered callback entry.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
<para>
|
||||
The
|
||||
<xref linkend='XtRemoveCallback' xrefstyle='select: title'/>
|
||||
function removes a callback only if both the procedure and the client
|
||||
data match.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
To delete a list of callback procedures from a given widget's callback list, use
|
||||
<xref linkend='XtRemoveCallbacks' xrefstyle='select: title'/>.
|
||||
</para>
|
||||
|
||||
<funcsynopsis id='XtRemoveCallbacks'>
|
||||
<funcprototype>
|
||||
<funcdef>void <function>XtRemoveCallbacks</function></funcdef>
|
||||
<paramdef>Widget <parameter>w</parameter></paramdef>
|
||||
<paramdef>const char * <parameter>callback_name</parameter></paramdef>
|
||||
<paramdef>XtCallbackList <parameter>callbacks</parameter></paramdef>
|
||||
</funcprototype>
|
||||
</funcsynopsis>
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term>
|
||||
<emphasis remap='I'>w</emphasis>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Specifies the widget. Must be of class Object or any subclass thereof.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term>
|
||||
<emphasis remap='I'>callback_name</emphasis>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Specifies the callback list from which the procedures are to be deleted.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term>
|
||||
<emphasis remap='I'>callbacks</emphasis>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Specifies the null-terminated list of callback procedures and corresponding
|
||||
client data.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
<para>
|
||||
To delete all callback procedures from a given widget's callback list
|
||||
and free all storage associated with the callback list, use
|
||||
<xref linkend='XtRemoveAllCallbacks' xrefstyle='select: title'/>.
|
||||
</para>
|
||||
|
||||
<funcsynopsis id='XtRemoveAllCallbacks'>
|
||||
<funcprototype>
|
||||
<funcdef>void <function>XtRemoveAllCallbacks</function></funcdef>
|
||||
<paramdef>Widget <parameter>w</parameter></paramdef>
|
||||
<paramdef>const char * <parameter>callback_name</parameter></paramdef>
|
||||
</funcprototype>
|
||||
</funcsynopsis>
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term>
|
||||
<emphasis remap='I'>w</emphasis>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Specifies the widget. Must be of class Object or any subclass thereof.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term>
|
||||
<emphasis remap='I'>callback_name</emphasis>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Specifies the callback list to be cleared.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
|
||||
</sect1>
|
||||
|
||||
<sect1 id="Executing_Callback_Procedures">
|
||||
<title>Executing Callback Procedures</title>
|
||||
<para>
|
||||
To execute the procedures in a given widget's callback list,
|
||||
specifying the callback list by resource name, use
|
||||
<xref linkend='XtCallCallbacks' xrefstyle='select: title'/>.
|
||||
</para>
|
||||
|
||||
<funcsynopsis id='XtCallCallbacks'>
|
||||
<funcprototype>
|
||||
<funcdef>void <function>XtCallCallbacks</function></funcdef>
|
||||
<paramdef>Widget <parameter>w</parameter></paramdef>
|
||||
<paramdef>const char * <parameter>callback_name</parameter></paramdef>
|
||||
<paramdef>XtPointer <parameter>call_data</parameter></paramdef>
|
||||
</funcprototype>
|
||||
</funcsynopsis>
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term>
|
||||
<emphasis remap='I'>w</emphasis>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Specifies the widget. Must be of class Object or any subclass thereof.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term>
|
||||
<emphasis remap='I'>callback_name</emphasis>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Specifies the callback list to be executed.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term>
|
||||
<emphasis remap='I'>call_data</emphasis>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Specifies a callback-list-specific data value to pass to each of the callback
|
||||
procedure in the list, or NULL.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
|
||||
<para>
|
||||
<xref linkend='XtCallCallbacks' xrefstyle='select: title'/>
|
||||
calls each of the callback procedures in the list
|
||||
named by <emphasis remap='I'>callback_name</emphasis> in the specified widget, passing the client
|
||||
data registered with the procedure and <emphasis remap='I'>call-data</emphasis>.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
To execute the procedures in a callback list, specifying the callback
|
||||
list by address, use
|
||||
<xref linkend='XtCallCallbackList' xrefstyle='select: title'/>.
|
||||
</para>
|
||||
|
||||
<funcsynopsis id='XtCallCallbackList'>
|
||||
<funcprototype>
|
||||
<funcdef>void <function>XtCallCallbackList</function></funcdef>
|
||||
<paramdef>Widget <parameter>widget</parameter></paramdef>
|
||||
<paramdef>XtCallbackList <parameter>callbacks</parameter></paramdef>
|
||||
<paramdef>XtPointer <parameter>call_data</parameter></paramdef>
|
||||
</funcprototype>
|
||||
</funcsynopsis>
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term>
|
||||
<emphasis remap='I'>widget</emphasis>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Specifies the widget instance that contains the callback list. Must be of class Object or any subclass thereof.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term>
|
||||
<emphasis remap='I'>callbacks</emphasis>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Specifies the callback list to be executed.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term>
|
||||
<emphasis remap='I'>call_data</emphasis>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Specifies a callback-list-specific data value to pass
|
||||
to each of the callback procedures in the list, or NULL.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
<para>
|
||||
The <emphasis remap='I'>callbacks</emphasis> parameter must specify the contents of a widget or
|
||||
object resource declared with representation type
|
||||
<function>XtRCallback</function>.
|
||||
If <emphasis remap='I'>callbacks</emphasis> is NULL,
|
||||
<xref linkend='XtCallCallbackList' xrefstyle='select: title'/>
|
||||
returns immediately; otherwise it calls each of the callback
|
||||
procedures in the list, passing the client data and <emphasis remap='I'>call_data</emphasis>.
|
||||
</para>
|
||||
</sect1>
|
||||
|
||||
<sect1 id="Checking_the_Status_of_a_Callback_List">
|
||||
<title>Checking the Status of a Callback List</title>
|
||||
<para>
|
||||
To find out the status of a given widget's callback list, use
|
||||
<xref linkend='XtHasCallbacks' xrefstyle='select: title'/>.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
typedef enum {XtCallbackNoList, XtCallbackHasNone, XtCallbackHasSome} XtCallbackStatus;
|
||||
</para>
|
||||
|
||||
<funcsynopsis id='XtHasCallbacks'>
|
||||
<funcprototype>
|
||||
<funcdef>XtCallbackStatus <function>XtHasCallbacks</function></funcdef>
|
||||
<paramdef>Widget <parameter>w</parameter></paramdef>
|
||||
<paramdef>const char * <parameter>callback_name</parameter></paramdef>
|
||||
</funcprototype>
|
||||
</funcsynopsis>
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term>
|
||||
<emphasis remap='I'>w</emphasis>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Specifies the widget. Must be of class Object or any subclass thereof.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term>
|
||||
<emphasis remap='I'>callback_name</emphasis>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Specifies the callback list to be checked.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
<para>
|
||||
The
|
||||
<xref linkend='XtHasCallbacks' xrefstyle='select: title'/>
|
||||
function first checks to see if the widget has a callback list identified
|
||||
by <emphasis remap='I'>callback_name</emphasis>.
|
||||
If the callback list does not exist,
|
||||
<xref linkend='XtHasCallbacks' xrefstyle='select: title'/>
|
||||
returns
|
||||
<function>XtCallbackNoList</function>.
|
||||
If the callback list exists but is empty,
|
||||
it returns
|
||||
<function>XtCallbackHasNone</function>.
|
||||
If the callback list exists and has at least one callback registered,
|
||||
it returns
|
||||
<function>XtCallbackHasSome</function>.
|
||||
</para>
|
||||
</sect1>
|
||||
</chapter>
|
4391
lib/libXt/specs/CH09.xml
Normal file
4391
lib/libXt/specs/CH09.xml
Normal file
File diff suppressed because it is too large
Load diff
2215
lib/libXt/specs/CH10.xml
Normal file
2215
lib/libXt/specs/CH10.xml
Normal file
File diff suppressed because it is too large
Load diff
5548
lib/libXt/specs/CH11.xml
Normal file
5548
lib/libXt/specs/CH11.xml
Normal file
File diff suppressed because it is too large
Load diff
1181
lib/libXt/specs/CH12.xml
Normal file
1181
lib/libXt/specs/CH12.xml
Normal file
File diff suppressed because it is too large
Load diff
1182
lib/libXt/specs/CH13.xml
Normal file
1182
lib/libXt/specs/CH13.xml
Normal file
File diff suppressed because it is too large
Load diff
37
lib/libXt/specs/Makefile.am
Normal file
37
lib/libXt/specs/Makefile.am
Normal file
|
@ -0,0 +1,37 @@
|
|||
|
||||
if ENABLE_SPECS
|
||||
|
||||
# Main DocBook/XML files (DOCTYPE book)
|
||||
docbook = intrinsics.xml
|
||||
|
||||
# Included chapters, appendix, images
|
||||
chapters = \
|
||||
acknowledgement.xml \
|
||||
preface.xml \
|
||||
CH01.xml \
|
||||
CH02.xml \
|
||||
CH03.xml \
|
||||
CH04.xml \
|
||||
CH05.xml \
|
||||
CH06.xml \
|
||||
CH07.xml \
|
||||
CH08.xml \
|
||||
CH09.xml \
|
||||
CH10.xml \
|
||||
CH11.xml \
|
||||
CH12.xml \
|
||||
CH13.xml \
|
||||
appA.xml \
|
||||
appB.xml \
|
||||
appC.xml \
|
||||
appD.xml \
|
||||
appE.xml \
|
||||
appF.xml
|
||||
|
||||
# The location where the DocBook/XML files and their generated formats are installed
|
||||
shelfdir = $(docdir)
|
||||
|
||||
# Generate DocBook/XML output formats with or without stylesheets
|
||||
include $(top_srcdir)/docbook.am
|
||||
|
||||
endif ENABLE_SPECS
|
654
lib/libXt/specs/Makefile.in
Normal file
654
lib/libXt/specs/Makefile.in
Normal file
|
@ -0,0 +1,654 @@
|
|||
# Makefile.in generated by automake 1.12.6 from Makefile.am.
|
||||
# @configure_input@
|
||||
|
||||
# Copyright (C) 1994-2012 Free Software Foundation, Inc.
|
||||
|
||||
# This Makefile.in is free software; the Free Software Foundation
|
||||
# gives unlimited permission to copy and/or distribute it,
|
||||
# with or without modifications, as long as this notice is preserved.
|
||||
|
||||
# This program is distributed in the hope that it will be useful,
|
||||
# but WITHOUT ANY WARRANTY, to the extent permitted by law; without
|
||||
# even the implied warranty of MERCHANTABILITY or FITNESS FOR A
|
||||
# PARTICULAR PURPOSE.
|
||||
|
||||
@SET_MAKE@
|
||||
|
||||
#
|
||||
# Generate output formats for a single DocBook/XML with/without chapters
|
||||
#
|
||||
# Variables set by the calling Makefile:
|
||||
# shelfdir: the location where the docs/specs are installed. Typically $(docdir)
|
||||
# docbook: the main DocBook/XML file, no chapters, appendix or image files
|
||||
# chapters: all files pulled in by an XInclude statement and images.
|
||||
#
|
||||
|
||||
#
|
||||
# This makefile is intended for Users Documentation and Functional Specifications.
|
||||
# Do not use for Developer Documentation which is not installed and does not require olink.
|
||||
# Refer to http://www.x.org/releases/X11R7.6/doc/xorg-docs/ReleaseNotes.html#id2584393
|
||||
# for an explanation on documents classification.
|
||||
#
|
||||
|
||||
VPATH = @srcdir@
|
||||
am__make_dryrun = \
|
||||
{ \
|
||||
am__dry=no; \
|
||||
case $$MAKEFLAGS in \
|
||||
*\\[\ \ ]*) \
|
||||
echo 'am--echo: ; @echo "AM" OK' | $(MAKE) -f - 2>/dev/null \
|
||||
| grep '^AM OK$$' >/dev/null || am__dry=yes;; \
|
||||
*) \
|
||||
for am__flg in $$MAKEFLAGS; do \
|
||||
case $$am__flg in \
|
||||
*=*|--*) ;; \
|
||||
*n*) am__dry=yes; break;; \
|
||||
esac; \
|
||||
done;; \
|
||||
esac; \
|
||||
test $$am__dry = yes; \
|
||||
}
|
||||
pkgdatadir = $(datadir)/@PACKAGE@
|
||||
pkgincludedir = $(includedir)/@PACKAGE@
|
||||
pkglibdir = $(libdir)/@PACKAGE@
|
||||
pkglibexecdir = $(libexecdir)/@PACKAGE@
|
||||
am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd
|
||||
install_sh_DATA = $(install_sh) -c -m 644
|
||||
install_sh_PROGRAM = $(install_sh) -c
|
||||
install_sh_SCRIPT = $(install_sh) -c
|
||||
INSTALL_HEADER = $(INSTALL_DATA)
|
||||
transform = $(program_transform_name)
|
||||
NORMAL_INSTALL = :
|
||||
PRE_INSTALL = :
|
||||
POST_INSTALL = :
|
||||
NORMAL_UNINSTALL = :
|
||||
PRE_UNINSTALL = :
|
||||
POST_UNINSTALL = :
|
||||
build_triplet = @build@
|
||||
host_triplet = @host@
|
||||
DIST_COMMON = $(am__dist_shelf_DATA_DIST) $(srcdir)/Makefile.am \
|
||||
$(srcdir)/Makefile.in $(srcdir)/libXt.ent.in \
|
||||
$(top_srcdir)/docbook.am
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@am__append_1 = $(docbook:.xml=.html)
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TEXT_TRUE@@HAVE_XMLTO_TRUE@am__append_2 = $(docbook:.xml=.txt)
|
||||
@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@am__append_3 = $(docbook:.xml=.pdf) \
|
||||
@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(docbook:.xml=.ps)
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@am__append_4 = $(docbook:.xml=.html.db) \
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(docbook:.xml=.pdf.db)
|
||||
subdir = specs
|
||||
ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
|
||||
am__aclocal_m4_deps = $(top_srcdir)/m4/ax_define_dir.m4 \
|
||||
$(top_srcdir)/m4/libtool.m4 $(top_srcdir)/m4/ltoptions.m4 \
|
||||
$(top_srcdir)/m4/ltsugar.m4 $(top_srcdir)/m4/ltversion.m4 \
|
||||
$(top_srcdir)/m4/lt~obsolete.m4 $(top_srcdir)/configure.ac
|
||||
am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
|
||||
$(ACLOCAL_M4)
|
||||
mkinstalldirs = $(install_sh) -d
|
||||
CONFIG_HEADER = $(top_builddir)/config.h
|
||||
CONFIG_CLEAN_FILES = libXt.ent
|
||||
CONFIG_CLEAN_VPATH_FILES =
|
||||
AM_V_P = $(am__v_P_@AM_V@)
|
||||
am__v_P_ = $(am__v_P_@AM_DEFAULT_V@)
|
||||
am__v_P_0 = false
|
||||
am__v_P_1 = :
|
||||
AM_V_GEN = $(am__v_GEN_@AM_V@)
|
||||
am__v_GEN_ = $(am__v_GEN_@AM_DEFAULT_V@)
|
||||
am__v_GEN_0 = @echo " GEN " $@;
|
||||
am__v_GEN_1 =
|
||||
AM_V_at = $(am__v_at_@AM_V@)
|
||||
am__v_at_ = $(am__v_at_@AM_DEFAULT_V@)
|
||||
am__v_at_0 = @
|
||||
am__v_at_1 =
|
||||
SOURCES =
|
||||
DIST_SOURCES =
|
||||
am__can_run_installinfo = \
|
||||
case $$AM_UPDATE_INFO_DIR in \
|
||||
n|no|NO) false;; \
|
||||
*) (install-info --version) >/dev/null 2>&1;; \
|
||||
esac
|
||||
am__dist_shelf_DATA_DIST = intrinsics.xml acknowledgement.xml \
|
||||
preface.xml CH01.xml CH02.xml CH03.xml CH04.xml CH05.xml \
|
||||
CH06.xml CH07.xml CH08.xml CH09.xml CH10.xml CH11.xml CH12.xml \
|
||||
CH13.xml appA.xml appB.xml appC.xml appD.xml appE.xml appF.xml
|
||||
am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`;
|
||||
am__vpath_adj = case $$p in \
|
||||
$(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \
|
||||
*) f=$$p;; \
|
||||
esac;
|
||||
am__strip_dir = f=`echo $$p | sed -e 's|^.*/||'`;
|
||||
am__install_max = 40
|
||||
am__nobase_strip_setup = \
|
||||
srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*|]/\\\\&/g'`
|
||||
am__nobase_strip = \
|
||||
for p in $$list; do echo "$$p"; done | sed -e "s|$$srcdirstrip/||"
|
||||
am__nobase_list = $(am__nobase_strip_setup); \
|
||||
for p in $$list; do echo "$$p $$p"; done | \
|
||||
sed "s| $$srcdirstrip/| |;"' / .*\//!s/ .*/ ./; s,\( .*\)/[^/]*$$,\1,' | \
|
||||
$(AWK) 'BEGIN { files["."] = "" } { files[$$2] = files[$$2] " " $$1; \
|
||||
if (++n[$$2] == $(am__install_max)) \
|
||||
{ print $$2, files[$$2]; n[$$2] = 0; files[$$2] = "" } } \
|
||||
END { for (dir in files) print dir, files[dir] }'
|
||||
am__base_list = \
|
||||
sed '$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;s/\n/ /g' | \
|
||||
sed '$$!N;$$!N;$$!N;$$!N;s/\n/ /g'
|
||||
am__uninstall_files_from_dir = { \
|
||||
test -z "$$files" \
|
||||
|| { test ! -d "$$dir" && test ! -f "$$dir" && test ! -r "$$dir"; } \
|
||||
|| { echo " ( cd '$$dir' && rm -f" $$files ")"; \
|
||||
$(am__cd) "$$dir" && rm -f $$files; }; \
|
||||
}
|
||||
am__installdirs = "$(DESTDIR)$(shelfdir)" "$(DESTDIR)$(shelfdir)"
|
||||
DATA = $(dist_shelf_DATA) $(shelf_DATA)
|
||||
DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
|
||||
ACLOCAL = @ACLOCAL@
|
||||
ADMIN_MAN_DIR = @ADMIN_MAN_DIR@
|
||||
ADMIN_MAN_SUFFIX = @ADMIN_MAN_SUFFIX@
|
||||
AMTAR = @AMTAR@
|
||||
AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@
|
||||
APP_MAN_DIR = @APP_MAN_DIR@
|
||||
APP_MAN_SUFFIX = @APP_MAN_SUFFIX@
|
||||
AR = @AR@
|
||||
AUTOCONF = @AUTOCONF@
|
||||
AUTOHEADER = @AUTOHEADER@
|
||||
AUTOMAKE = @AUTOMAKE@
|
||||
AWK = @AWK@
|
||||
BASE_CFLAGS = @BASE_CFLAGS@
|
||||
CC = @CC@
|
||||
CCDEPMODE = @CCDEPMODE@
|
||||
CC_FOR_BUILD = @CC_FOR_BUILD@
|
||||
CFLAGS = @CFLAGS@
|
||||
CFLAGS_FOR_BUILD = @CFLAGS_FOR_BUILD@
|
||||
CHANGELOG_CMD = @CHANGELOG_CMD@
|
||||
CPP = @CPP@
|
||||
CPPFLAGS = @CPPFLAGS@
|
||||
CPPFLAGS_FOR_BUILD = @CPPFLAGS_FOR_BUILD@
|
||||
CWARNFLAGS = @CWARNFLAGS@
|
||||
CYGPATH_W = @CYGPATH_W@
|
||||
DEFS = @DEFS@
|
||||
DEPDIR = @DEPDIR@
|
||||
DLLTOOL = @DLLTOOL@
|
||||
DRIVER_MAN_DIR = @DRIVER_MAN_DIR@
|
||||
DRIVER_MAN_SUFFIX = @DRIVER_MAN_SUFFIX@
|
||||
DSYMUTIL = @DSYMUTIL@
|
||||
DUMPBIN = @DUMPBIN@
|
||||
ECHO_C = @ECHO_C@
|
||||
ECHO_N = @ECHO_N@
|
||||
ECHO_T = @ECHO_T@
|
||||
EGREP = @EGREP@
|
||||
ERRORDBDIR = @ERRORDBDIR@
|
||||
EXEEXT = @EXEEXT@
|
||||
FGREP = @FGREP@
|
||||
FILE_MAN_DIR = @FILE_MAN_DIR@
|
||||
FILE_MAN_SUFFIX = @FILE_MAN_SUFFIX@
|
||||
FOP = @FOP@
|
||||
GLIB_CFLAGS = @GLIB_CFLAGS@
|
||||
GLIB_LIBS = @GLIB_LIBS@
|
||||
GREP = @GREP@
|
||||
INSTALL = @INSTALL@
|
||||
INSTALL_CMD = @INSTALL_CMD@
|
||||
INSTALL_DATA = @INSTALL_DATA@
|
||||
INSTALL_PROGRAM = @INSTALL_PROGRAM@
|
||||
INSTALL_SCRIPT = @INSTALL_SCRIPT@
|
||||
INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@
|
||||
LD = @LD@
|
||||
LDFLAGS = @LDFLAGS@
|
||||
LDFLAGS_FOR_BUILD = @LDFLAGS_FOR_BUILD@
|
||||
LIBOBJS = @LIBOBJS@
|
||||
LIBS = @LIBS@
|
||||
LIBTOOL = @LIBTOOL@
|
||||
LIB_MAN_DIR = @LIB_MAN_DIR@
|
||||
LIB_MAN_SUFFIX = @LIB_MAN_SUFFIX@
|
||||
LIPO = @LIPO@
|
||||
LN_S = @LN_S@
|
||||
LTLIBOBJS = @LTLIBOBJS@
|
||||
MAINT = @MAINT@
|
||||
MAKEINFO = @MAKEINFO@
|
||||
MALLOC_ZERO_CFLAGS = @MALLOC_ZERO_CFLAGS@
|
||||
MANIFEST_TOOL = @MANIFEST_TOOL@
|
||||
MAN_SUBSTS = @MAN_SUBSTS@
|
||||
MISC_MAN_DIR = @MISC_MAN_DIR@
|
||||
MISC_MAN_SUFFIX = @MISC_MAN_SUFFIX@
|
||||
MKDIR_P = @MKDIR_P@
|
||||
NM = @NM@
|
||||
NMEDIT = @NMEDIT@
|
||||
OBJDUMP = @OBJDUMP@
|
||||
OBJEXT = @OBJEXT@
|
||||
OTOOL = @OTOOL@
|
||||
OTOOL64 = @OTOOL64@
|
||||
PACKAGE = @PACKAGE@
|
||||
PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@
|
||||
PACKAGE_NAME = @PACKAGE_NAME@
|
||||
PACKAGE_STRING = @PACKAGE_STRING@
|
||||
PACKAGE_TARNAME = @PACKAGE_TARNAME@
|
||||
PACKAGE_URL = @PACKAGE_URL@
|
||||
PACKAGE_VERSION = @PACKAGE_VERSION@
|
||||
PATH_SEPARATOR = @PATH_SEPARATOR@
|
||||
PERL = @PERL@
|
||||
PKG_CONFIG = @PKG_CONFIG@
|
||||
PKG_CONFIG_LIBDIR = @PKG_CONFIG_LIBDIR@
|
||||
PKG_CONFIG_PATH = @PKG_CONFIG_PATH@
|
||||
RANLIB = @RANLIB@
|
||||
RAWCPP = @RAWCPP@
|
||||
RAWCPPFLAGS = @RAWCPPFLAGS@
|
||||
SED = @SED@
|
||||
SET_MAKE = @SET_MAKE@
|
||||
SHELL = @SHELL@
|
||||
STRICT_CFLAGS = @STRICT_CFLAGS@
|
||||
STRINGSABIOPTIONS = @STRINGSABIOPTIONS@
|
||||
STRIP = @STRIP@
|
||||
STYLESHEET_SRCDIR = @STYLESHEET_SRCDIR@
|
||||
TRADITIONALCPPFLAGS = @TRADITIONALCPPFLAGS@
|
||||
VERSION = @VERSION@
|
||||
XFILESEARCHPATHDEFAULT = @XFILESEARCHPATHDEFAULT@
|
||||
XMALLOC_ZERO_CFLAGS = @XMALLOC_ZERO_CFLAGS@
|
||||
XMLTO = @XMLTO@
|
||||
XORG_MALLOC_DEBUG_ENV = @XORG_MALLOC_DEBUG_ENV@
|
||||
XORG_MAN_PAGE = @XORG_MAN_PAGE@
|
||||
XORG_SGML_PATH = @XORG_SGML_PATH@
|
||||
XSLTPROC = @XSLTPROC@
|
||||
XSL_STYLESHEET = @XSL_STYLESHEET@
|
||||
XTMALLOC_ZERO_CFLAGS = @XTMALLOC_ZERO_CFLAGS@
|
||||
XT_CFLAGS = @XT_CFLAGS@
|
||||
XT_LIBS = @XT_LIBS@
|
||||
abs_builddir = @abs_builddir@
|
||||
abs_srcdir = @abs_srcdir@
|
||||
abs_top_builddir = @abs_top_builddir@
|
||||
abs_top_srcdir = @abs_top_srcdir@
|
||||
ac_ct_AR = @ac_ct_AR@
|
||||
ac_ct_CC = @ac_ct_CC@
|
||||
ac_ct_DUMPBIN = @ac_ct_DUMPBIN@
|
||||
am__include = @am__include@
|
||||
am__leading_dot = @am__leading_dot@
|
||||
am__quote = @am__quote@
|
||||
am__tar = @am__tar@
|
||||
am__untar = @am__untar@
|
||||
appdefaultdir = @appdefaultdir@
|
||||
bindir = @bindir@
|
||||
build = @build@
|
||||
build_alias = @build_alias@
|
||||
build_cpu = @build_cpu@
|
||||
build_os = @build_os@
|
||||
build_vendor = @build_vendor@
|
||||
builddir = @builddir@
|
||||
datadir = @datadir@
|
||||
datarootdir = @datarootdir@
|
||||
docdir = @docdir@
|
||||
dvidir = @dvidir@
|
||||
exec_prefix = @exec_prefix@
|
||||
host = @host@
|
||||
host_alias = @host_alias@
|
||||
host_cpu = @host_cpu@
|
||||
host_os = @host_os@
|
||||
host_vendor = @host_vendor@
|
||||
htmldir = @htmldir@
|
||||
includedir = @includedir@
|
||||
infodir = @infodir@
|
||||
install_sh = @install_sh@
|
||||
libdir = @libdir@
|
||||
libexecdir = @libexecdir@
|
||||
localedir = @localedir@
|
||||
localstatedir = @localstatedir@
|
||||
mandir = @mandir@
|
||||
mkdir_p = @mkdir_p@
|
||||
oldincludedir = @oldincludedir@
|
||||
pdfdir = @pdfdir@
|
||||
prefix = @prefix@
|
||||
program_transform_name = @program_transform_name@
|
||||
psdir = @psdir@
|
||||
runstatedir = @runstatedir@
|
||||
sbindir = @sbindir@
|
||||
sharedstatedir = @sharedstatedir@
|
||||
srcdir = @srcdir@
|
||||
sysconfdir = @sysconfdir@
|
||||
target_alias = @target_alias@
|
||||
top_build_prefix = @top_build_prefix@
|
||||
top_builddir = @top_builddir@
|
||||
top_srcdir = @top_srcdir@
|
||||
|
||||
# Main DocBook/XML files (DOCTYPE book)
|
||||
@ENABLE_SPECS_TRUE@docbook = intrinsics.xml
|
||||
|
||||
# Included chapters, appendix, images
|
||||
@ENABLE_SPECS_TRUE@chapters = \
|
||||
@ENABLE_SPECS_TRUE@ acknowledgement.xml \
|
||||
@ENABLE_SPECS_TRUE@ preface.xml \
|
||||
@ENABLE_SPECS_TRUE@ CH01.xml \
|
||||
@ENABLE_SPECS_TRUE@ CH02.xml \
|
||||
@ENABLE_SPECS_TRUE@ CH03.xml \
|
||||
@ENABLE_SPECS_TRUE@ CH04.xml \
|
||||
@ENABLE_SPECS_TRUE@ CH05.xml \
|
||||
@ENABLE_SPECS_TRUE@ CH06.xml \
|
||||
@ENABLE_SPECS_TRUE@ CH07.xml \
|
||||
@ENABLE_SPECS_TRUE@ CH08.xml \
|
||||
@ENABLE_SPECS_TRUE@ CH09.xml \
|
||||
@ENABLE_SPECS_TRUE@ CH10.xml \
|
||||
@ENABLE_SPECS_TRUE@ CH11.xml \
|
||||
@ENABLE_SPECS_TRUE@ CH12.xml \
|
||||
@ENABLE_SPECS_TRUE@ CH13.xml \
|
||||
@ENABLE_SPECS_TRUE@ appA.xml \
|
||||
@ENABLE_SPECS_TRUE@ appB.xml \
|
||||
@ENABLE_SPECS_TRUE@ appC.xml \
|
||||
@ENABLE_SPECS_TRUE@ appD.xml \
|
||||
@ENABLE_SPECS_TRUE@ appE.xml \
|
||||
@ENABLE_SPECS_TRUE@ appF.xml
|
||||
|
||||
|
||||
# The location where the DocBook/XML files and their generated formats are installed
|
||||
@ENABLE_SPECS_TRUE@shelfdir = $(docdir)
|
||||
|
||||
# DocBook/XML generated output formats to be installed
|
||||
@ENABLE_SPECS_TRUE@shelf_DATA = $(am__append_1) $(am__append_2) \
|
||||
@ENABLE_SPECS_TRUE@ $(am__append_3) $(am__append_4)
|
||||
|
||||
# DocBook/XML file with chapters, appendix and images it includes
|
||||
@ENABLE_SPECS_TRUE@dist_shelf_DATA = $(docbook) $(chapters)
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_SEARCHPATH_FLAGS = \
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --searchpath "$(XORG_SGML_PATH)/X11" \
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --searchpath "$(abs_top_builddir)"
|
||||
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_HTML_OLINK_FLAGS = \
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam target.database.document=$(XORG_SGML_PATH)/X11/dbs/masterdb.html.xml \
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam current.docid="$(<:.xml=)"
|
||||
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_HTML_STYLESHEET_FLAGS = -x $(STYLESHEET_SRCDIR)/xorg-xhtml.xsl
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_HTML_FLAGS = \
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_SEARCHPATH_FLAGS) \
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_HTML_STYLESHEET_FLAGS) \
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_HTML_OLINK_FLAGS)
|
||||
|
||||
@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_FO_IMAGEPATH_FLAGS = --stringparam img.src.path=$(abs_builddir)/
|
||||
@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_PDF_OLINK_FLAGS = \
|
||||
@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam target.database.document=$(XORG_SGML_PATH)/X11/dbs/masterdb.pdf.xml \
|
||||
@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam current.docid="$(<:.xml=)"
|
||||
|
||||
@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_FO_STYLESHEET_FLAGS = -x $(STYLESHEET_SRCDIR)/xorg-fo.xsl
|
||||
@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_FO_FLAGS = \
|
||||
@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_SEARCHPATH_FLAGS) \
|
||||
@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_FO_STYLESHEET_FLAGS) \
|
||||
@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_FO_IMAGEPATH_FLAGS) \
|
||||
@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_PDF_OLINK_FLAGS)
|
||||
|
||||
|
||||
# Generate documents cross-reference target databases
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@XSLT_SEARCHPATH_FLAGS = \
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --path "$(XORG_SGML_PATH)/X11" \
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --path "$(abs_top_builddir)"
|
||||
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@XSLT_OLINK_FLAGS = \
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --stringparam targets.filename "$@" \
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --stringparam collect.xref.targets "only" \
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --stringparam olink.base.uri "$(@:.db=)"
|
||||
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@XSLT_HTML_FLAGS = \
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(XSLT_SEARCHPATH_FLAGS) \
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(XSLT_OLINK_FLAGS) \
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --nonet --xinclude \
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(STYLESHEET_SRCDIR)/xorg-xhtml.xsl
|
||||
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@XSLT_PDF_FLAGS = \
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(XSLT_SEARCHPATH_FLAGS) \
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(XSLT_OLINK_FLAGS) \
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --nonet --xinclude \
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(STYLESHEET_SRCDIR)/xorg-fo.xsl
|
||||
|
||||
@ENABLE_SPECS_TRUE@CLEANFILES = $(shelf_DATA)
|
||||
all: all-am
|
||||
|
||||
.SUFFIXES:
|
||||
$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(top_srcdir)/docbook.am $(am__configure_deps)
|
||||
@for dep in $?; do \
|
||||
case '$(am__configure_deps)' in \
|
||||
*$$dep*) \
|
||||
( cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh ) \
|
||||
&& { if test -f $@; then exit 0; else break; fi; }; \
|
||||
exit 1;; \
|
||||
esac; \
|
||||
done; \
|
||||
echo ' cd $(top_srcdir) && $(AUTOMAKE) --foreign specs/Makefile'; \
|
||||
$(am__cd) $(top_srcdir) && \
|
||||
$(AUTOMAKE) --foreign specs/Makefile
|
||||
.PRECIOUS: Makefile
|
||||
Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status
|
||||
@case '$?' in \
|
||||
*config.status*) \
|
||||
cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \
|
||||
*) \
|
||||
echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \
|
||||
cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \
|
||||
esac;
|
||||
$(top_srcdir)/docbook.am:
|
||||
|
||||
$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES)
|
||||
cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
|
||||
|
||||
$(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps)
|
||||
cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
|
||||
$(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps)
|
||||
cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
|
||||
$(am__aclocal_m4_deps):
|
||||
libXt.ent: $(top_builddir)/config.status $(srcdir)/libXt.ent.in
|
||||
cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@
|
||||
|
||||
mostlyclean-libtool:
|
||||
-rm -f *.lo
|
||||
|
||||
clean-libtool:
|
||||
-rm -rf .libs _libs
|
||||
install-dist_shelfDATA: $(dist_shelf_DATA)
|
||||
@$(NORMAL_INSTALL)
|
||||
@list='$(dist_shelf_DATA)'; test -n "$(shelfdir)" || list=; \
|
||||
if test -n "$$list"; then \
|
||||
echo " $(MKDIR_P) '$(DESTDIR)$(shelfdir)'"; \
|
||||
$(MKDIR_P) "$(DESTDIR)$(shelfdir)" || exit 1; \
|
||||
fi; \
|
||||
for p in $$list; do \
|
||||
if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
|
||||
echo "$$d$$p"; \
|
||||
done | $(am__base_list) | \
|
||||
while read files; do \
|
||||
echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(shelfdir)'"; \
|
||||
$(INSTALL_DATA) $$files "$(DESTDIR)$(shelfdir)" || exit $$?; \
|
||||
done
|
||||
|
||||
uninstall-dist_shelfDATA:
|
||||
@$(NORMAL_UNINSTALL)
|
||||
@list='$(dist_shelf_DATA)'; test -n "$(shelfdir)" || list=; \
|
||||
files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \
|
||||
dir='$(DESTDIR)$(shelfdir)'; $(am__uninstall_files_from_dir)
|
||||
install-shelfDATA: $(shelf_DATA)
|
||||
@$(NORMAL_INSTALL)
|
||||
@list='$(shelf_DATA)'; test -n "$(shelfdir)" || list=; \
|
||||
if test -n "$$list"; then \
|
||||
echo " $(MKDIR_P) '$(DESTDIR)$(shelfdir)'"; \
|
||||
$(MKDIR_P) "$(DESTDIR)$(shelfdir)" || exit 1; \
|
||||
fi; \
|
||||
for p in $$list; do \
|
||||
if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
|
||||
echo "$$d$$p"; \
|
||||
done | $(am__base_list) | \
|
||||
while read files; do \
|
||||
echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(shelfdir)'"; \
|
||||
$(INSTALL_DATA) $$files "$(DESTDIR)$(shelfdir)" || exit $$?; \
|
||||
done
|
||||
|
||||
uninstall-shelfDATA:
|
||||
@$(NORMAL_UNINSTALL)
|
||||
@list='$(shelf_DATA)'; test -n "$(shelfdir)" || list=; \
|
||||
files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \
|
||||
dir='$(DESTDIR)$(shelfdir)'; $(am__uninstall_files_from_dir)
|
||||
tags: TAGS
|
||||
TAGS:
|
||||
|
||||
ctags: CTAGS
|
||||
CTAGS:
|
||||
|
||||
cscope cscopelist:
|
||||
|
||||
|
||||
distdir: $(DISTFILES)
|
||||
@srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \
|
||||
topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \
|
||||
list='$(DISTFILES)'; \
|
||||
dist_files=`for file in $$list; do echo $$file; done | \
|
||||
sed -e "s|^$$srcdirstrip/||;t" \
|
||||
-e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \
|
||||
case $$dist_files in \
|
||||
*/*) $(MKDIR_P) `echo "$$dist_files" | \
|
||||
sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \
|
||||
sort -u` ;; \
|
||||
esac; \
|
||||
for file in $$dist_files; do \
|
||||
if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \
|
||||
if test -d $$d/$$file; then \
|
||||
dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \
|
||||
if test -d "$(distdir)/$$file"; then \
|
||||
find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \
|
||||
fi; \
|
||||
if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \
|
||||
cp -fpR $(srcdir)/$$file "$(distdir)$$dir" || exit 1; \
|
||||
find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \
|
||||
fi; \
|
||||
cp -fpR $$d/$$file "$(distdir)$$dir" || exit 1; \
|
||||
else \
|
||||
test -f "$(distdir)/$$file" \
|
||||
|| cp -p $$d/$$file "$(distdir)/$$file" \
|
||||
|| exit 1; \
|
||||
fi; \
|
||||
done
|
||||
check-am: all-am
|
||||
check: check-am
|
||||
all-am: Makefile $(DATA)
|
||||
installdirs:
|
||||
for dir in "$(DESTDIR)$(shelfdir)" "$(DESTDIR)$(shelfdir)"; do \
|
||||
test -z "$$dir" || $(MKDIR_P) "$$dir"; \
|
||||
done
|
||||
install: install-am
|
||||
install-exec: install-exec-am
|
||||
install-data: install-data-am
|
||||
uninstall: uninstall-am
|
||||
|
||||
install-am: all-am
|
||||
@$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am
|
||||
|
||||
installcheck: installcheck-am
|
||||
install-strip:
|
||||
if test -z '$(STRIP)'; then \
|
||||
$(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
|
||||
install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
|
||||
install; \
|
||||
else \
|
||||
$(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
|
||||
install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
|
||||
"INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'" install; \
|
||||
fi
|
||||
mostlyclean-generic:
|
||||
|
||||
clean-generic:
|
||||
-test -z "$(CLEANFILES)" || rm -f $(CLEANFILES)
|
||||
|
||||
distclean-generic:
|
||||
-test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES)
|
||||
-test . = "$(srcdir)" || test -z "$(CONFIG_CLEAN_VPATH_FILES)" || rm -f $(CONFIG_CLEAN_VPATH_FILES)
|
||||
|
||||
maintainer-clean-generic:
|
||||
@echo "This command is intended for maintainers to use"
|
||||
@echo "it deletes files that may require special tools to rebuild."
|
||||
clean: clean-am
|
||||
|
||||
clean-am: clean-generic clean-libtool mostlyclean-am
|
||||
|
||||
distclean: distclean-am
|
||||
-rm -f Makefile
|
||||
distclean-am: clean-am distclean-generic
|
||||
|
||||
dvi: dvi-am
|
||||
|
||||
dvi-am:
|
||||
|
||||
html: html-am
|
||||
|
||||
html-am:
|
||||
|
||||
info: info-am
|
||||
|
||||
info-am:
|
||||
|
||||
install-data-am: install-dist_shelfDATA install-shelfDATA
|
||||
|
||||
install-dvi: install-dvi-am
|
||||
|
||||
install-dvi-am:
|
||||
|
||||
install-exec-am:
|
||||
|
||||
install-html: install-html-am
|
||||
|
||||
install-html-am:
|
||||
|
||||
install-info: install-info-am
|
||||
|
||||
install-info-am:
|
||||
|
||||
install-man:
|
||||
|
||||
install-pdf: install-pdf-am
|
||||
|
||||
install-pdf-am:
|
||||
|
||||
install-ps: install-ps-am
|
||||
|
||||
install-ps-am:
|
||||
|
||||
installcheck-am:
|
||||
|
||||
maintainer-clean: maintainer-clean-am
|
||||
-rm -f Makefile
|
||||
maintainer-clean-am: distclean-am maintainer-clean-generic
|
||||
|
||||
mostlyclean: mostlyclean-am
|
||||
|
||||
mostlyclean-am: mostlyclean-generic mostlyclean-libtool
|
||||
|
||||
pdf: pdf-am
|
||||
|
||||
pdf-am:
|
||||
|
||||
ps: ps-am
|
||||
|
||||
ps-am:
|
||||
|
||||
uninstall-am: uninstall-dist_shelfDATA uninstall-shelfDATA
|
||||
|
||||
.MAKE: install-am install-strip
|
||||
|
||||
.PHONY: all all-am check check-am clean clean-generic clean-libtool \
|
||||
distclean distclean-generic distclean-libtool distdir dvi \
|
||||
dvi-am html html-am info info-am install install-am \
|
||||
install-data install-data-am install-dist_shelfDATA \
|
||||
install-dvi install-dvi-am install-exec install-exec-am \
|
||||
install-html install-html-am install-info install-info-am \
|
||||
install-man install-pdf install-pdf-am install-ps \
|
||||
install-ps-am install-shelfDATA install-strip installcheck \
|
||||
installcheck-am installdirs maintainer-clean \
|
||||
maintainer-clean-generic mostlyclean mostlyclean-generic \
|
||||
mostlyclean-libtool pdf pdf-am ps ps-am uninstall uninstall-am \
|
||||
uninstall-dist_shelfDATA uninstall-shelfDATA
|
||||
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@%.html: %.xml $(chapters)
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_HTML_FLAGS) xhtml-nochunks $<
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TEXT_TRUE@@HAVE_XMLTO_TRUE@%.txt: %.xml $(chapters)
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TEXT_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_HTML_FLAGS) txt $<
|
||||
@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@%.pdf: %.xml $(chapters)
|
||||
@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FO_FLAGS) --with-fop pdf $<
|
||||
@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@%.ps: %.xml $(chapters)
|
||||
@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FO_FLAGS) --with-fop ps $<
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@%.html.db: %.xml $(chapters)
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(AM_V_GEN)$(XSLTPROC) $(XSLT_HTML_FLAGS) $<
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@%.pdf.db: %.xml $(chapters)
|
||||
@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(AM_V_GEN)$(XSLTPROC) $(XSLT_PDF_FLAGS) $<
|
||||
|
||||
# Generate DocBook/XML output formats with or without stylesheets
|
||||
|
||||
# Tell versions [3.59,3.63) of GNU make to not export all variables.
|
||||
# Otherwise a system limit (for SysV at least) may be exceeded.
|
||||
.NOEXPORT:
|
378
lib/libXt/specs/acknowledgement.xml
Normal file
378
lib/libXt/specs/acknowledgement.xml
Normal file
|
@ -0,0 +1,378 @@
|
|||
<?xml version="1.0" encoding="UTF-8" ?>
|
||||
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
|
||||
|
||||
<!-- <acknowledgements> -->
|
||||
<dedication>
|
||||
<title>Acknowledgments</title>
|
||||
|
||||
|
||||
<note>
|
||||
<title>Acknowledgments for X11R7</title>
|
||||
<para>
|
||||
This update to the X11 Intrinsics drops support for K&R C,
|
||||
as well as improving its use of Standard C features,
|
||||
notably <type>const</type>.
|
||||
</para>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>
|
||||
Matt Dew did the initial conversion of this specification from nroff to DocBook.
|
||||
</para>
|
||||
<para>
|
||||
Later, I expanded on that, improving the formatting, as
|
||||
well as updating the function prototypes in the specification
|
||||
as well as the related manual pages.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Matthieu Herrb modified the Intrinsics header files to drop support
|
||||
for K&R C, leaving the Standard C prototypes.
|
||||
</para>
|
||||
<para>
|
||||
Later, he applied my changes to complete the conversion of the
|
||||
library source from a mixture of K&R C and Standard C to
|
||||
just use the standard language features.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Others (including
|
||||
Alan Coopersmith,
|
||||
Gaetan Nadon,
|
||||
Walter Harms,
|
||||
and Kevin E. Martin) have worked to
|
||||
maintain the library's build-scripts and documentation.
|
||||
</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
<literallayout>
|
||||
Thomas E. Dickey
|
||||
invisible-island.net
|
||||
April 2019
|
||||
</literallayout>
|
||||
</note>
|
||||
|
||||
<note>
|
||||
<title>Acknowledgments for X11R6</title>
|
||||
|
||||
<para>
|
||||
The design of the X11 Intrinsics was done primarily by Joel McCormack
|
||||
of Digital WSL. Major contributions to the design and implementation
|
||||
also were done by Charles Haynes, Mike Chow, and Paul Asente of Digital
|
||||
WSL. Additional contributors to the design and/or implementation were:
|
||||
</para>
|
||||
|
||||
<!-- <sidebar> -->
|
||||
<para>
|
||||
<informaltable frame='none'>
|
||||
<?dbfo keep-together="always" ?>
|
||||
<tgroup cols='2' rowsep='0' colsep='0'>
|
||||
<colspec colwidth='1.0*' />
|
||||
<colspec colwidth='1.0*' />
|
||||
<tbody>
|
||||
<row><?dbfo row-height="0.2cm"?>
|
||||
<entry>Loretta Guarino-Reid (Digital WSL)</entry>
|
||||
<entry>Rich Hyde (Digital WSL)</entry>
|
||||
</row>
|
||||
<row><?dbfo row-height="0.2cm"?>
|
||||
<entry>Susan Angebranndt (Digital WSL)</entry>
|
||||
<entry>Terry Weissman (Digital WSL)</entry>
|
||||
</row>
|
||||
<row><?dbfo row-height="0.2cm"?>
|
||||
<entry>Mary Larson (Digital UEG)</entry>
|
||||
<entry>Mark Manasse (Digital SRC)</entry>
|
||||
</row>
|
||||
<row><?dbfo row-height="0.5cm"?>
|
||||
<entry>Jim Gettys (Digital SRC)</entry>
|
||||
<entry>Leo Treggiari (Digital SDT)</entry>
|
||||
</row>
|
||||
<row><?dbfo row-height="0.5cm"?>
|
||||
<entry>Ralph Swick (Project Athena and Digital ERP)</entry>
|
||||
<entry>Mark Ackerman (Project Athena)</entry>
|
||||
</row>
|
||||
<row><?dbfo row-height="0.5cm"?>
|
||||
<entry>Ron Newman (Project Athena)</entry>
|
||||
<entry>Bob Scheifler (MIT LCS)</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</informaltable>
|
||||
</para>
|
||||
<!-- </sidebar> -->
|
||||
|
||||
<para>
|
||||
The contributors to the X10 toolkit also deserve mention. Although the X11 Intrinsics present an
|
||||
entirely different programming style, they borrow heavily from the implicit and
|
||||
explicit concepts in the X10 toolkit.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
The design and implementation of the X10 Intrinsics were done by:
|
||||
</para>
|
||||
|
||||
<!-- <sidebar> -->
|
||||
<para>
|
||||
<informaltable frame='none'>
|
||||
<?dbfo keep-together="always" ?>
|
||||
<tgroup cols='1' rowsep='0' colsep='0'>
|
||||
<colspec colwidth='1.0*' />
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>Terry Weissman (Digital WSL)</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Smokey Wallace (Digital WSL)</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Phil Karlton (Digital WSL)</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Charles Haynes (Digital WSL)</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Frank Hall (HP)</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</informaltable>
|
||||
</para>
|
||||
<!-- </sidebar> -->
|
||||
|
||||
<para>
|
||||
The design and implementation of the X10 toolkit’s sample widgets were by
|
||||
the above, as well as by:
|
||||
</para>
|
||||
|
||||
<!-- <sidebar> -->
|
||||
<para>
|
||||
<informaltable frame='none'>
|
||||
<?dbfo keep-together="always" ?>
|
||||
<tgroup cols='1' rowsep='0' colsep='0'>
|
||||
<colspec colwidth='1.0*' />
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>Ram Rao (Digital UEG)</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Mary Larson (Digital UEG)</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Mike Gancarz (Digital UEG)</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Kathleen Langone (Digital UEG)</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</informaltable>
|
||||
</para>
|
||||
<!-- </sidebar> -->
|
||||
|
||||
<para>
|
||||
These widgets provided a checklist of requirements that we had to address in the X11 Intrinsics.
|
||||
</para>
|
||||
<para>
|
||||
Thanks go to Al Mento of Digital’s UEG Documentation Group for formatting and generally
|
||||
improving this document and to John Ousterhout of Berkeley for extensively reviewing early
|
||||
drafts of it.
|
||||
</para>
|
||||
<para>
|
||||
Finally, a special thanks to Mike Chow, whose extensive performance analysis of the X10 toolkit
|
||||
provided the justification to redesign it entirely for X11.
|
||||
</para>
|
||||
|
||||
<literallayout>
|
||||
Joel McCormack
|
||||
Western Software Laboratory
|
||||
Digital Equipment Corporation
|
||||
March 1988
|
||||
</literallayout>
|
||||
|
||||
|
||||
<para>
|
||||
The current design of the Intrinsics has benefited greatly from the
|
||||
input of several dedicated reviewers in the membership of the X
|
||||
Consortium. In addition to those already mentioned, the following
|
||||
individuals have dedicated significant time to suggesting improvements
|
||||
to the Intrinsics:
|
||||
</para>
|
||||
|
||||
<!-- <sidebar> -->
|
||||
<para>
|
||||
<informaltable frame='none'>
|
||||
<?dbfo keep-together="always" ?>
|
||||
<tgroup cols='2' rowsep='0' colsep='0'>
|
||||
<colspec colwidth='1.0*' />
|
||||
<colspec colwidth='1.0*' />
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>Steve Pitschke (Stellar)</entry>
|
||||
<entry>C. Doug Blewett (AT&T)</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Bob Miller (HP)</entry>
|
||||
<entry>David Schiferl (Tektronix)</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Fred Taft (HP)</entry>
|
||||
<entry>Michael Squires (Sequent)</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Marcel Meth (AT&T)</entry>
|
||||
<entry>Jim Fulton (MIT)</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Mike Collins (Digital)</entry>
|
||||
<entry>Kerry Kimbrough (Texas Instruments)</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Scott McGregor (Digital)</entry>
|
||||
<entry>Phil Karlton (Digital)</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Julian Payne (ESS)</entry>
|
||||
<entry>Jacques Davy (Bull)</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Gabriel Beged-Dov (HP)</entry>
|
||||
<entry>Glenn Widener (Tektronix)</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</informaltable>
|
||||
</para>
|
||||
<!-- </sidebar> -->
|
||||
|
||||
<para>
|
||||
Thanks go to each of them for the countless hours spent reviewing drafts and code.
|
||||
</para>
|
||||
|
||||
<literallayout>
|
||||
Ralph R. Swick
|
||||
External Research Group
|
||||
Digital Equipment Corporation
|
||||
MIT Project Athena
|
||||
June 1988
|
||||
</literallayout>
|
||||
|
||||
|
||||
<para>
|
||||
From Release 3 to Release 4, several new members joined the design team. We greatly appreciate
|
||||
the thoughtful comments, suggestions, lengthy discussions, and in some cases implementation
|
||||
code contributed by each of the following:
|
||||
</para>
|
||||
|
||||
<!-- <sidebar> -->
|
||||
<para>
|
||||
<informaltable frame='none'>
|
||||
<?dbfo keep-together="always" ?>
|
||||
<tgroup cols='2' rowsep='0' colsep='0'>
|
||||
<colspec colwidth='1.0*' />
|
||||
<colspec colwidth='1.0*' />
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>Don Alecci (AT&T)</entry>
|
||||
<entry>Ellis Cohen (OSF)</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Donna Converse (MIT)</entry>
|
||||
<entry>Clive Feather (IXI)</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Nayeem Islam (Sun)</entry>
|
||||
<entry>Dana Laursen (HP)</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Keith Packard (MIT)</entry>
|
||||
<entry>Chris Peterson (MIT)</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Richard Probst (Sun)</entry>
|
||||
<entry>Larry Cable (Sun)</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</informaltable>
|
||||
</para>
|
||||
<!-- </sidebar> -->
|
||||
|
||||
<para>
|
||||
In Release 5, the effort to define the internationalization additions was headed by Bill McMahon
|
||||
of Hewlett Packard and Frank Rojas of IBM. This has been an educational process for many of
|
||||
us, and Bill and Frank’s tutelage has carried us through. Vania Joloboff of the OSF also contributed
|
||||
to the internationalization additions. The implementation efforts of Bill, Gabe Beged-Dov,
|
||||
and especially Donna Converse for this release are also gratefully acknowledged.
|
||||
</para>
|
||||
|
||||
<literallayout>
|
||||
Ralph R. Swick
|
||||
December 1989
|
||||
and
|
||||
July 1991
|
||||
</literallayout>
|
||||
|
||||
<para>
|
||||
The Release 6 Intrinsics is a result of the collaborative efforts of participants in the X Consortium’s
|
||||
intrinsics working group. A few individuals contributed substantial design proposals, participated
|
||||
in lengthy discussions, reviewed final specifications, and in most cases, were also
|
||||
responsible for sections of the implementation. They deserve recognition and thanks for their
|
||||
major contributions:
|
||||
</para>
|
||||
|
||||
<!-- <sidebar> -->
|
||||
<para>
|
||||
<informaltable frame='none'>
|
||||
<?dbfo keep-together="always" ?>
|
||||
<tgroup cols='2' rowsep='0' colsep='0'>
|
||||
<colspec colwidth='1.0*' />
|
||||
<colspec colwidth='1.0*' />
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>Paul Asente (Adobe)</entry>
|
||||
<entry>Larry Cable (SunSoft)</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Ellis Cohen (OSF)</entry>
|
||||
<entry>Daniel Dardailler (OSF)</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Vania Joloboff (OSF)</entry>
|
||||
<entry>Kaleb Keithley (X Consortium)</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Courtney Loomis (HP)</entry>
|
||||
<entry>Douglas Rand (OSF)</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Bob Scheifler (X Consortium)</entry>
|
||||
<entry>Ajay Vohra (SunSoft)</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</informaltable>
|
||||
</para>
|
||||
<!-- </sidebar> -->
|
||||
|
||||
<para>
|
||||
Many others analyzed designs, offered useful comments and suggestions, and participated in a
|
||||
significant subset of the process. The following people deserve thanks for their contributions:
|
||||
Andy Bovingdon, Sam Chang, Chris Craig, George Erwin-Grotsky, Keith Edwards, Clive
|
||||
Feather, Stephen Gildea, Dan Heller, Steve Humphrey, David Kaelbling, Jaime Lau, Rob Lembree,
|
||||
Stuart Marks, Beth Mynatt, Tom Paquin, Chris Peterson, Kamesh Ramakrishna, Tom
|
||||
Rodriguez, Jim VanGilder, Will Walker, and Mike Wexler.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
I am especially grateful to two of my colleagues: Ralph Swick for expert editorial guidance, and
|
||||
Kaleb Keithley for leadership in the implementation and the specification work.
|
||||
</para>
|
||||
|
||||
<literallayout>
|
||||
Donna Converse
|
||||
X Consortium
|
||||
April 1994
|
||||
</literallayout>
|
||||
</note>
|
||||
</dedication>
|
||||
<!-- </acknowledgements> -->
|
115
lib/libXt/specs/appA.xml
Normal file
115
lib/libXt/specs/appA.xml
Normal file
|
@ -0,0 +1,115 @@
|
|||
<?xml version="1.0" encoding="UTF-8" ?>
|
||||
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
|
||||
|
||||
<appendix id='Resource_File_Format'>
|
||||
<title>Resource File Format</title>
|
||||
<para>
|
||||
A resource file contains text representing the default resource values for an
|
||||
application or set of applications.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
The format of resource files is defined by
|
||||
<emphasis remap='I'>Xlib — C Language X Interface.</emphasis> and is reproduced here
|
||||
for convenience only.
|
||||
</para>
|
||||
|
||||
<para>The format of a resource specification is</para>
|
||||
<informaltable frame='none'>
|
||||
<?dbfo keep-together="always" ?>
|
||||
<tgroup cols='2' align='left' colsep='0' rowsep='0'>
|
||||
<colspec colwidth='0.3*' colname='c1'/>
|
||||
<colspec colwidth='1.0*' colname='c2'/>
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>ResourceLine</entry>
|
||||
<entry>= Comment | IncludeFile | ResourceSpec | <empty line></entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Comment</entry>
|
||||
<entry>=“!” {<any character except null or newline>}</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>IncludeFile</entry>
|
||||
<entry>= “#” WhiteSpace “include” WhiteSpace FileName WhiteSpace</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>FileName</entry>
|
||||
<entry>= <valid filename for operating system></entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>ResourceSpec</entry>
|
||||
<entry>= WhiteSpace ResourceName WhiteSpace “:” WhiteSpace Value</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>ResourceName</entry>
|
||||
<entry>= [Binding] {Component Binding} ComponentName</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Binding</entry>
|
||||
<entry>=“.” | “*”</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>WhiteSpace</entry>
|
||||
<entry>= {<space> | <horizontal tab>}</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Component</entry>
|
||||
<entry>= “?” | ComponentName</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>ComponentName</entry>
|
||||
<entry>= NameChar {NameChar}</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>NameChar</entry>
|
||||
<entry>= “a”–“z” | “A”–“Z” | “0”–“9” | “_” | “-”</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Value</entry>
|
||||
<entry>={<any character except null or unescaped newline>}</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</informaltable>
|
||||
|
||||
<para>
|
||||
Elements separated by vertical bar (|) are alternatives.
|
||||
Curly braces ({...}) indicate zero or more repetitions
|
||||
of the enclosed elements.
|
||||
Square brackets ([...]) indicate that the enclosed element is optional.
|
||||
Quotes (“...”) are used around literal characters.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
If the last character on a line is a backslash (\),
|
||||
that line is assumed to continue on the next line.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
To allow a Value to begin with whitespace,
|
||||
the two-character sequence “\<emphasis remap='I'>space</emphasis>” (backslash followed by space)
|
||||
is recognized and replaced by a space character,
|
||||
and the two-character sequence “\<emphasis remap='I'>tab</emphasis>”
|
||||
(backslash followed by horizontal tab)
|
||||
is recognized and replaced by a horizontal tab character.
|
||||
</para>
|
||||
<para>
|
||||
To allow a Value to contain embedded newline characters,
|
||||
the two-character sequence “\n” is recognized and replaced by a
|
||||
newline character.
|
||||
To allow a Value to be broken across multiple lines in a text file,
|
||||
the two-character sequence “\<emphasis remap='I'>newline</emphasis>”
|
||||
(backslash followed by newline) is
|
||||
recognized and removed from the value.
|
||||
</para>
|
||||
<para>
|
||||
To allow a Value to contain arbitrary character codes,
|
||||
the four-character sequence “\<emphasis remap='I'>nnn</emphasis>”,
|
||||
where each <emphasis remap='I'>n</emphasis> is a digit character in the range of “0”–“7”,
|
||||
is recognized and replaced with a single byte that contains
|
||||
the octal value specified by the sequence.
|
||||
Finally, the two-character sequence “\\” is recognized
|
||||
and replaced with a single backslash.
|
||||
</para>
|
||||
</appendix>
|
1184
lib/libXt/specs/appB.xml
Normal file
1184
lib/libXt/specs/appB.xml
Normal file
File diff suppressed because it is too large
Load diff
1977
lib/libXt/specs/appC.xml
Normal file
1977
lib/libXt/specs/appC.xml
Normal file
File diff suppressed because it is too large
Load diff
883
lib/libXt/specs/appD.xml
Normal file
883
lib/libXt/specs/appD.xml
Normal file
|
@ -0,0 +1,883 @@
|
|||
<?xml version="1.0" encoding="UTF-8" ?>
|
||||
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
|
||||
|
||||
<appendix id='Intrinsics_Error_Messages'>
|
||||
<title>Intrinsics Error Messages</title>
|
||||
|
||||
<para>
|
||||
All Intrinsics errors and warnings have class
|
||||
“XtToolkitError”.
|
||||
The following two tables summarize the common errors and warnings that can be
|
||||
generated by the Intrinsics.
|
||||
Additional implementation-dependent messages are permitted.
|
||||
Error Messages
|
||||
</para>
|
||||
|
||||
<informaltable frame='topbot'>
|
||||
<?dbfo keep-together="auto" ?>
|
||||
<tgroup cols='3' align='left' rowsep='0' colsep='0'>
|
||||
<colspec colwidth='1.0*' colname='c1'/>
|
||||
<colspec colwidth='1.0*' colname='c2'/>
|
||||
<colspec colwidth='1.0*' colname='c3'/>
|
||||
<thead>
|
||||
<row rowsep='1'>
|
||||
<entry>Name</entry>
|
||||
<entry>Type</entry>
|
||||
<entry>Default Message</entry>
|
||||
</row>
|
||||
</thead>
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>allocError</entry>
|
||||
<entry>calloc</entry>
|
||||
<entry>Cannot perform calloc</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>allocError</entry>
|
||||
<entry>malloc</entry>
|
||||
<entry>Cannot perform malloc</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>allocError</entry>
|
||||
<entry>realloc</entry>
|
||||
<entry>Cannot perform realloc</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>internalError</entry>
|
||||
<entry>xtMakeGeometryRequest</entry>
|
||||
<entry>internal error; ShellClassExtension is NULL</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidArgCount</entry>
|
||||
<entry>xtGetValues</entry>
|
||||
<entry>Argument count > 0 on NULL argument list in XtGetValues</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidArgCount</entry>
|
||||
<entry>xtSetValues</entry>
|
||||
<entry>Argument count > 0 on NULL argument list in XtSetValues</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidClass</entry>
|
||||
<entry>applicationShellInsertChild</entry>
|
||||
<entry>ApplicationShell does not accept RectObj children; ignored</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidClass</entry>
|
||||
<entry>constraintSetValue</entry>
|
||||
<entry>Subclass of Constraint required in CallConstraintSetValues</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidClass</entry>
|
||||
<entry>xtAppCreateShell</entry>
|
||||
<entry>XtAppCreateShell requires non-NULL widget class</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidClass</entry>
|
||||
<entry>xtCreatePopupShell</entry>
|
||||
<entry>XtCreatePopupShell requires non-NULL widget class</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidClass</entry>
|
||||
<entry>xtCreateWidget</entry>
|
||||
<entry>XtCreateWidget requires non-NULL widget class</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidClass</entry>
|
||||
<entry>xtPopdown</entry>
|
||||
<entry>XtPopdown requires a subclass of shellWidgetClass</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidClass</entry>
|
||||
<entry>xtPopup</entry>
|
||||
<entry>XtPopup requires a subclass of shellWidgetClass</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidDimension</entry>
|
||||
<entry>xtCreateWindow</entry>
|
||||
<entry>Widget %s has zero width and/or height</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidDimension</entry>
|
||||
<entry>shellRealize</entry>
|
||||
<entry>Shell widget %s has zero width and/or height</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidDisplay</entry>
|
||||
<entry>xtInitialize</entry>
|
||||
<entry>Can't open display: %s</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidGetValues</entry>
|
||||
<entry>xtGetValues</entry>
|
||||
<entry>NULL ArgVal in XtGetValues</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidExtension</entry>
|
||||
<entry>shellClassPartInitialize</entry>
|
||||
<entry>widget class %s has invalid ShellClassExtension record</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidExtension</entry>
|
||||
<entry>xtMakeGeometryRequest</entry>
|
||||
<entry>widget class %s has invalid ShellClassExtension record</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidGeometryManager</entry>
|
||||
<entry>xtMakeGeometryRequest</entry>
|
||||
<entry>XtMakeGeometryRequest - parent has no geometry manager</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidParameter</entry>
|
||||
<entry>xtAddInput</entry>
|
||||
<entry>invalid condition passed to XtAddInput</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidParameter</entry>
|
||||
<entry>xtAddInput</entry>
|
||||
<entry>invalid condition passed to XtAppAddInput</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidParent</entry>
|
||||
<entry>xtChangeManagedSet</entry>
|
||||
<entry>Attempt to manage a child when parent is not Composite</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidParent</entry>
|
||||
<entry>xtChangeManagedSet</entry>
|
||||
<entry>Attempt to unmanage a child when parent is not Composite</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidParent</entry>
|
||||
<entry>xtCreatePopupShell</entry>
|
||||
<entry>XtCreatePopupShell requires non-NULL parent</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidParent</entry>
|
||||
<entry>xtCreateWidget</entry>
|
||||
<entry>XtCreateWidget requires non-NULL parent</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidParent</entry>
|
||||
<entry>xtMakeGeometryRequest</entry>
|
||||
<entry>non-shell has no parent in XtMakeGeometryRequest</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidParent</entry>
|
||||
<entry>xtMakeGeometryRequest</entry>
|
||||
<entry>XtMakeGeometryRequest - parent not composite</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidParent</entry>
|
||||
<entry>xtManageChildren</entry>
|
||||
<entry>Attempt to manage a child when parent is not Composite</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidParent</entry>
|
||||
<entry>xtUnmanageChildren</entry>
|
||||
<entry>Attempt to unmanage a child when parent is not Composite</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidProcedure</entry>
|
||||
<entry>inheritanceProc</entry>
|
||||
<entry>Unresolved inheritance operation</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidProcedure</entry>
|
||||
<entry>realizeProc</entry>
|
||||
<entry>No realize class procedure defined</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidWindow</entry>
|
||||
<entry>eventHandler</entry>
|
||||
<entry>Event with wrong window</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>missingWidget</entry>
|
||||
<entry>fetchDisplayArg</entry>
|
||||
<entry>FetchDisplayArg called without a widget to reference</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>nonWidget</entry>
|
||||
<entry>xtCreateWidget</entry>
|
||||
<entry>attempt to add non-widget child "%s" to parent "%s" which supports only widgets</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>noPerDisplay</entry>
|
||||
<entry>closeDisplay</entry>
|
||||
<entry>Couldn't find per display information</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>noPerDisplay</entry>
|
||||
<entry>getPerDisplay</entry>
|
||||
<entry>Couldn't find per display information</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>noSelectionProperties</entry>
|
||||
<entry>freeSelectionProperty</entry>
|
||||
<entry>internal error: no selection property context for display</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>noWidgetAncestor</entry>
|
||||
<entry>windowedAncestor</entry>
|
||||
<entry>Object "%s" does not have windowed ancestor</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>nullDisplay</entry>
|
||||
<entry>xtRegisterExtensionSelector</entry>
|
||||
<entry>XtRegisterExtensionSelector requires a non-NULL display</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>nullProc</entry>
|
||||
<entry>insertChild</entry>
|
||||
<entry>"%s" parent has NULL insert_child method</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>r2versionMismatch</entry>
|
||||
<entry>widget</entry>
|
||||
<entry>Widget class %s must be re-compiled.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>R3versionMismatch</entry>
|
||||
<entry>widget</entry>
|
||||
<entry>Widget class %s must be re-compiled.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>R4orR5versionMismatch</entry>
|
||||
<entry>widget</entry>
|
||||
<entry>Widget class %s must be re-compiled.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>rangeError</entry>
|
||||
<entry>xtRegisterExtensionSelector</entry>
|
||||
<entry>Attempt to register multiple selectors for one extension event type</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>sessionManagement</entry>
|
||||
<entry>SmcOpenConnection</entry>
|
||||
<entry>Tried to connect to session manager, %s</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>subclassMismatch</entry>
|
||||
<entry>xtCheckSubclass</entry>
|
||||
<entry>Widget class %s found when subclass of %s expected: %s</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</informaltable>
|
||||
|
||||
<para><emphasis role='strong'>Warning Messages</emphasis></para>
|
||||
|
||||
<informaltable frame='topbot'>
|
||||
<?dbfo keep-together="auto" ?>
|
||||
<tgroup cols='3' align='left' colsep='0' rowsep='0'>
|
||||
<colspec colwidth='1.0*' colname='c1'/>
|
||||
<colspec colwidth='1.0*' colname='c2'/>
|
||||
<colspec colwidth='1.0*' colname='c3'/>
|
||||
<thead>
|
||||
<row rowsep='1'>
|
||||
<entry>Name</entry>
|
||||
<entry>Type</entry>
|
||||
<entry>Default Message</entry>
|
||||
</row>
|
||||
</thead>
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>ambiguousParent</entry>
|
||||
<entry>xtChangeManagedSet</entry>
|
||||
<entry>Not all children have same parent</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>ambiguousParent</entry>
|
||||
<entry>xtManageChildren</entry>
|
||||
<entry>Not all children have same parent in XtManageChildren</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>ambiguousParent</entry>
|
||||
<entry>xtUnmanageChildren</entry>
|
||||
<entry>Not all children have same parent in XtUnmanageChildren</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>badFormat</entry>
|
||||
<entry>xtGetSelectionValue</entry>
|
||||
<entry>Selection owner returned type INCR property with format != 32</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>badGeometry</entry>
|
||||
<entry>shellRealize</entry>
|
||||
<entry>Shell widget "%s" has an invalid geometry specification: "%s"</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>badValue</entry>
|
||||
<entry>cvtStringToPixel</entry>
|
||||
<entry>Color name "%s" is not defined</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>communicationError</entry>
|
||||
<entry>select</entry>
|
||||
<entry>Select failed; error code %s</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>conversionError</entry>
|
||||
<entry>string</entry>
|
||||
<entry>Cannot convert string "%s" to type %s</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>conversionError</entry>
|
||||
<entry>stringToVisual</entry>
|
||||
<entry>Cannot find Visual of class %s for display %s</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>conversionFailed</entry>
|
||||
<entry>xtConvertVarToArgList</entry>
|
||||
<entry>Type conversion failed</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>conversionFailed</entry>
|
||||
<entry>xtGetTypedArg</entry>
|
||||
<entry>Type conversion (%s to %s) failed for widget '%s'</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>displayError</entry>
|
||||
<entry>invalidDisplay</entry>
|
||||
<entry>Can't find display structure</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>grabError</entry>
|
||||
<entry>xtAddGrab</entry>
|
||||
<entry>XtAddGrab requires exclusive grab if spring_loaded is TRUE</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>grabError</entry>
|
||||
<entry>xtRemoveGrab</entry>
|
||||
<entry>XtRemoveGrab asked to remove a widget not on the list</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>initializationError</entry>
|
||||
<entry>xtInitialize</entry>
|
||||
<entry>Initializing Resource Lists twice</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>insufficientSpace</entry>
|
||||
<entry>xtGetTypedArg</entry>
|
||||
<entry>Insufficient space for converted type '%s' in widget '%s'</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>internalError</entry>
|
||||
<entry>shell</entry>
|
||||
<entry>Shell's window manager interaction is broken</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidAddressMode</entry>
|
||||
<entry>computeArgs</entry>
|
||||
<entry>Conversion arguments for widget '%s' contain an unsupported address mode</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidArgCount</entry>
|
||||
<entry>getResources</entry>
|
||||
<entry>argument count > 0 on NULL argument list</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidCallbackList</entry>
|
||||
<entry>xtAddCallback</entry>
|
||||
<entry>Cannot find callback list in XtAddCallback</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidCallbackList</entry>
|
||||
<entry>xtAddCallback</entry>
|
||||
<entry>Cannot find callback list in XtAddCallbacks</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidCallbackList</entry>
|
||||
<entry>xtCallCallback</entry>
|
||||
<entry>Cannot find callback list in XtCallCallbacks</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidCallbackList</entry>
|
||||
<entry>xtRemoveAllCallback</entry>
|
||||
<entry>Cannot find callback list in XtRemoveAllCallbacks</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidCallbackList</entry>
|
||||
<entry>xtRemoveCallback</entry>
|
||||
<entry>Cannot find callback list in XtRemoveCallbacks</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidChild</entry>
|
||||
<entry>xtChangeManagedSet</entry>
|
||||
<entry>Null child passed to UnmanageChildren</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidChild</entry>
|
||||
<entry>xtManageChildren</entry>
|
||||
<entry>null child passed to ManageChildren</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidChild</entry>
|
||||
<entry>xtManageChildren</entry>
|
||||
<entry>null child passed to XtManageChildren</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidChild</entry>
|
||||
<entry>xtUnmanageChildren</entry>
|
||||
<entry>Null child passed to XtUnmanageChildren</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidChild</entry>
|
||||
<entry>xtUnmanageChildren</entry>
|
||||
<entry>Null child found in argument list to unmanage</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidDepth</entry>
|
||||
<entry>setValues</entry>
|
||||
<entry>Can't change widget depth</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidExtension</entry>
|
||||
<entry>xtCreateWidget</entry>
|
||||
<entry>widget "%s" class %s has invalid CompositeClassExtension record</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidExtension</entry>
|
||||
<entry>xtCreateWidget</entry>
|
||||
<entry>widget class %s has invalid ConstraintClassExtension record</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidGrab</entry>
|
||||
<entry>ungrabKeyOrButton</entry>
|
||||
<entry>Attempt to remove nonexistent passive grab</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidGrabKind</entry>
|
||||
<entry>xtPopup</entry>
|
||||
<entry>grab kind argument has invalid value; XtGrabNone assumed</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidParameters</entry>
|
||||
<entry>freeTranslations</entry>
|
||||
<entry>Freeing XtTranslations requires no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidParameters</entry>
|
||||
<entry>mergeTranslations</entry>
|
||||
<entry>MergeTM to TranslationTable needs no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidParameters</entry>
|
||||
<entry>xtMenuPopdown</entry>
|
||||
<entry>XtMenuPopdown called with num_params != 0 or 1</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidParameters</entry>
|
||||
<entry>xtMenuPopupAction</entry>
|
||||
<entry>MenuPopup wants exactly one argument</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidParent</entry>
|
||||
<entry>xtCopyFromParent</entry>
|
||||
<entry>CopyFromParent must have non-NULL parent</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidPopup</entry>
|
||||
<entry>xtMenuPopup</entry>
|
||||
<entry>Can't find popup widget "%s" in XtMenuPopup</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidPopup</entry>
|
||||
<entry>xtMenuPopdown</entry>
|
||||
<entry>Can't find popup in widget "%s" in XtMenuPopdown</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidPopup</entry>
|
||||
<entry>unsupportedOperation</entry>
|
||||
<entry>Pop-up menu creation is only supported on ButtonPress, KeyPress or EnterNotify events.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidPopup</entry>
|
||||
<entry>unsupportedOperation</entry>
|
||||
<entry>Pop-up menu creation is only supported on Button, Key or EnterNotify events.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidProcedure</entry>
|
||||
<entry>deleteChild</entry>
|
||||
<entry>null delete_child procedure for class %s in XtDestroy</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidProcedure</entry>
|
||||
<entry>inputHandler</entry>
|
||||
<entry>XtRemoveInput: Input handler not found</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidProcedure</entry>
|
||||
<entry>set_values_almost</entry>
|
||||
<entry>set_values_almost procedure shouldn't be NULL</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidResourceCount</entry>
|
||||
<entry>getResources</entry>
|
||||
<entry>resource count > 0 on NULL resource list</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidResourceName</entry>
|
||||
<entry>computeArgs</entry>
|
||||
<entry>Cannot find resource name %s as argument to conversion</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidShell</entry>
|
||||
<entry>xtTranslateCoords</entry>
|
||||
<entry>Widget has no shell ancestor</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>invalidSizeOverride</entry>
|
||||
<entry>xtDependencies</entry>
|
||||
<entry>Representation size %d must match superclass's to override %s</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>missingCharsetList</entry>
|
||||
<entry>cvtStringToFontSet</entry>
|
||||
<entry>Missing charsets in String to FontSet conversion</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>noActionProc</entry>
|
||||
<entry>xtCallActionProc</entry>
|
||||
<entry>No action proc named "%s" is registered for widget "%s"</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>noColormap</entry>
|
||||
<entry>cvtStringToPixel</entry>
|
||||
<entry>Cannot allocate colormap entry for "%s"</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>noFont</entry>
|
||||
<entry>cvtStringToFont</entry>
|
||||
<entry>Unable to load any usable ISO8859-1 font</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>noFont</entry>
|
||||
<entry>cvtStringToFontSet</entry>
|
||||
<entry>Unable to load any usable fontset</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>noFont</entry>
|
||||
<entry>cvtStringToFontStruct</entry>
|
||||
<entry>Unable to load any usable ISO8859-1 font</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>notInConvertSelection</entry>
|
||||
<entry>xtGetSelectionRequest</entry>
|
||||
<entry>XtGetSelectionRequest or XtGetSelectionParameters called for widget "%s" outside of ConvertSelection proc</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>notRectObj</entry>
|
||||
<entry>xtChangeManagedSet</entry>
|
||||
<entry>child "%s", class %s is not a RectObj</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>notRectObj</entry>
|
||||
<entry>xtManageChildren</entry>
|
||||
<entry>child "%s", class %s is not a RectObj</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>nullWidget</entry>
|
||||
<entry>xtConvertVarToArgList</entry>
|
||||
<entry>XtVaTypedArg conversion needs non-NULL widget handle</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>r3versionMismatch</entry>
|
||||
<entry>widget</entry>
|
||||
<entry>Shell Widget class %s binary compiled for R3</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>translationError</entry>
|
||||
<entry>nullTable</entry>
|
||||
<entry>Can't remove accelerators from NULL table</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>translationError</entry>
|
||||
<entry>nullTable</entry>
|
||||
<entry>Tried to remove nonexistent accelerators</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>translationError</entry>
|
||||
<entry>ambiguousActions</entry>
|
||||
<entry>Overriding earlier translation manager actions.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>translationError</entry>
|
||||
<entry>newActions</entry>
|
||||
<entry>New actions are:%s</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>translationError</entry>
|
||||
<entry>nullTable</entry>
|
||||
<entry>table to (un)merge must not be null</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>translationError</entry>
|
||||
<entry>nullTable</entry>
|
||||
<entry>Can't translate event through NULL table</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>translationError</entry>
|
||||
<entry>oldActions</entry>
|
||||
<entry>Previous entry was: %s %s</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>translationError</entry>
|
||||
<entry>unboundActions</entry>
|
||||
<entry>Actions not found: %s</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>translationError</entry>
|
||||
<entry>xtTranslateInitialize</entry>
|
||||
<entry>Initializing Translation manager twice.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>translationParseError</entry>
|
||||
<entry>missingComma</entry>
|
||||
<entry> ... possibly due to missing ',' in event sequence.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>translationParseError</entry>
|
||||
<entry>nonLatin1</entry>
|
||||
<entry> ... probably due to non-Latin1 character in quoted string</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>translationParseError</entry>
|
||||
<entry>parseError</entry>
|
||||
<entry>translation table syntax error: %s</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>translationParseError</entry>
|
||||
<entry>parseString</entry>
|
||||
<entry>Missing '"'.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>translationParseError</entry>
|
||||
<entry>showLine</entry>
|
||||
<entry> ... found while parsing '%s'</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>typeConversionError</entry>
|
||||
<entry>noConverter</entry>
|
||||
<entry>No type converter registered for '%s' to '%s' conversion.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>unknownType</entry>
|
||||
<entry>xtConvertVarToArgList</entry>
|
||||
<entry>Unable to find type of resource for conversion</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>unknownType</entry>
|
||||
<entry>xtGetTypedArg</entry>
|
||||
<entry>Unable to find type of resource for conversion</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>versionMismatch</entry>
|
||||
<entry>widget</entry>
|
||||
<entry>Widget class %s version mismatch (recompilation needed):\\n widget %d vs. intrinsics %d.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtIntOrPixelToXColor</entry>
|
||||
<entry>Pixel to color conversion needs screen and colormap arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtIntToBool</entry>
|
||||
<entry>Integer to Bool conversion needs no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtIntToBoolean</entry>
|
||||
<entry>Integer to Boolean conversion needs no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtIntToFloat</entry>
|
||||
<entry>Integer to Float conversion needs no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtIntToFont</entry>
|
||||
<entry>Integer to Font conversion needs no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtIntToPixel</entry>
|
||||
<entry>Integer to Pixel conversion needs no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtIntToPixmap</entry>
|
||||
<entry>Integer to Pixmap conversion needs no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtIntToShort</entry>
|
||||
<entry>Integer to Short conversion needs no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtIntToUnsignedChar</entry>
|
||||
<entry>Integer to UnsignedChar conversion needs no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtStringToAcceleratorTable</entry>
|
||||
<entry>String to AcceleratorTable conversion needs no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtStringToAtom</entry>
|
||||
<entry>String to Atom conversion needs Display argument</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtStringToBool</entry>
|
||||
<entry>String to Bool conversion needs no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtStringToBoolean</entry>
|
||||
<entry>String to Boolean conversion needs no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtStringToCommandArgArray</entry>
|
||||
<entry>String to CommandArgArray conversion needs no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtStringToCursor</entry>
|
||||
<entry>String to cursor conversion needs display argument</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtStringToDimension</entry>
|
||||
<entry>String to Dimension conversion needs no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtStringToDirectoryString</entry>
|
||||
<entry>String to DirectoryString conversion needs no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtStringToDisplay</entry>
|
||||
<entry>String to Display conversion needs no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtStringToFile</entry>
|
||||
<entry>String to File conversion needs no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtStringToFloat</entry>
|
||||
<entry>String to Float conversion needs no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtStringToFont</entry>
|
||||
<entry>String to font conversion needs display argument</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtStringToFontSet</entry>
|
||||
<entry>String to FontSet conversion needs display and locale arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtStringToFontStruct</entry>
|
||||
<entry>String to font conversion needs display argument</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtStringToGravity</entry>
|
||||
<entry>String to Gravity conversion needs no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtStringToInitialState</entry>
|
||||
<entry>String to InitialState conversion needs no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtStringToInt</entry>
|
||||
<entry>String to Integer conversion needs no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtStringToPixel</entry>
|
||||
<entry>String to pixel conversion needs screen and colormap arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtStringToRestartStyle</entry>
|
||||
<entry>String to RestartStyle conversion needs no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtStringToShort</entry>
|
||||
<entry>String to Integer conversion needs no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtStringToTranslationTable</entry>
|
||||
<entry>String to TranslationTable conversion needs no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtStringToUnsignedChar</entry>
|
||||
<entry>String to Integer conversion needs no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtStringToVisual</entry>
|
||||
<entry>String to Visual conversion needs screen and depth arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>cvtXColorToPixel</entry>
|
||||
<entry>Color to Pixel conversion needs no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>freeCursor</entry>
|
||||
<entry>Free Cursor requires display argument</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>freeDirectoryString</entry>
|
||||
<entry>Free Directory String requires no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>freeFile</entry>
|
||||
<entry>Free File requires no extra arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>freeFont</entry>
|
||||
<entry>Free Font needs display argument</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>freeFontSet</entry>
|
||||
<entry>FreeFontSet needs display and locale arguments</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>freeFontStruct</entry>
|
||||
<entry>Free FontStruct requires display argument</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wrongParameters</entry>
|
||||
<entry>freePixel</entry>
|
||||
<entry>Freeing a pixel requires screen and colormap arguments</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</informaltable>
|
||||
</appendix>
|
1698
lib/libXt/specs/appE.xml
Normal file
1698
lib/libXt/specs/appE.xml
Normal file
File diff suppressed because it is too large
Load diff
106
lib/libXt/specs/appF.xml
Normal file
106
lib/libXt/specs/appF.xml
Normal file
|
@ -0,0 +1,106 @@
|
|||
<?xml version="1.0" encoding="UTF-8" ?>
|
||||
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
|
||||
|
||||
<appendix id='Resource_Configuration_Management'>
|
||||
<title>Resource Configuration Management</title>
|
||||
<para>
|
||||
Setting and changing resources in X applications can be difficult for
|
||||
both the application programmer and the end user. <emphasis role='strong'>Resource
|
||||
Configuration Management (RCM)</emphasis> addresses this problem by changing
|
||||
the <function>X Intrinsics</function> to immediately modify a resource for a
|
||||
specified widget and each child widget in the hierarchy.
|
||||
In this context, immediate means: no sourcing of a resource
|
||||
file is required; the application does not need to be restarted for the
|
||||
new resource values to take effect; and the change
|
||||
occurs immediately.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
The main difference between <function>RCM</function> and the <function>Editres</function>
|
||||
protocol is that the <function>RCM</function>
|
||||
customizing hooks reside in the <function>Intrinsics</function> and thus are linked with
|
||||
other toolkits such as Motif and the Athena widgets. However, the
|
||||
<function>EditRes</function> protocol requires the application to link with the
|
||||
<function>EditRes</function>
|
||||
routines in the Xmu library and Xmu is not used by all applications that
|
||||
use Motif. Also, the <function>EditRes</function> protocol uses ClientMessage,
|
||||
whereas the
|
||||
<function>RCM</function> <function>Intrinsics</function> hooks use <function>PropertyNotify</function> events.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
X Properties and the <function>PropertyNotify</function> events are used
|
||||
to implement <function>RCM</function> and
|
||||
allow on-the-fly resource customization. When the X Toolkit is
|
||||
initialized, two atoms are interned with the strings
|
||||
<emphasis remap='I'>Custom Init</emphasis> and
|
||||
<emphasis remap='I'>Custom Data</emphasis>. Both
|
||||
<function>_XtCreatePopupShell</function>
|
||||
and
|
||||
<function>_XtAppCreateShell</function>
|
||||
register a <function>PropertyNotify</function> event handler to handle these properties.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
A customization tool uses the <emphasis remap='I'>Custom Init</emphasis> property to <emphasis remap='I'>ping</emphasis> an
|
||||
application to get the application's toplevel window. When the
|
||||
application's property notify event handler is invoked, the handler
|
||||
deletes the property. No data is transferred in this property.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
A customization tool uses the <emphasis remap='I'>Custom Data</emphasis> property to tell an
|
||||
application that it should change a resource's value. The data in
|
||||
the property contains the length of the resource name (the number
|
||||
of bytes in the resource name), the resource name and the new
|
||||
value for the resource. This property's type is <function>XA_STRING</function> and
|
||||
the format of the string is:
|
||||
</para>
|
||||
<orderedlist>
|
||||
<listitem>
|
||||
<para>
|
||||
The length of the resource name (the number of bytes in
|
||||
the resource name)
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
One space character
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
The resource name
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
One space character
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
The resource value
|
||||
</para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
<para>
|
||||
When setting the application's resource, the event handler calls
|
||||
functions to walk the application's widget tree, determining which
|
||||
widgets are affected by the resource string, and then applying the value
|
||||
with
|
||||
<xref linkend='XtSetValues' xrefstyle='select: title'/>.
|
||||
As the widget tree is recursively descended, at
|
||||
each level in the widget tree a resource part is tested for a match.
|
||||
When the entire resource string has been matched, the value is applied
|
||||
to the widget or widgets.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Before a value is set on a widget, it is first determined if the last
|
||||
part of the resource is a valid resource for that widget. It must also
|
||||
add the resource to the application's resource database and then query
|
||||
it using specific resource strings that is builds from the widget
|
||||
information.
|
||||
</para>
|
||||
</appendix>
|
132
lib/libXt/specs/intrinsics.xml
Normal file
132
lib/libXt/specs/intrinsics.xml
Normal file
|
@ -0,0 +1,132 @@
|
|||
<?xml version="1.0" encoding="UTF-8" ?>
|
||||
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
|
||||
[
|
||||
<!ENTITY % defs SYSTEM "defs.ent"> %defs;
|
||||
<!ENTITY % xt_defs SYSTEM "libXt.ent"> %xt_defs;
|
||||
]>
|
||||
|
||||
<book id="intrinsics" lang="en">
|
||||
|
||||
<bookinfo>
|
||||
<title>X Toolkit Intrinsics – C Language Interface</title>
|
||||
<subtitle>X Window System</subtitle>
|
||||
<releaseinfo>X Version 11, Release &fullrelvers;</releaseinfo>
|
||||
<releaseinfo>X Toolkit Intrinsics Version &package_version;</releaseinfo>
|
||||
<printhistory><para>First Revision – April, 1994</para></printhistory>
|
||||
<authorgroup>
|
||||
<author>
|
||||
<firstname>Joel</firstname><surname>McCormack</surname>
|
||||
<affiliation>
|
||||
<orgname>Digital Equipment Corporation</orgname>
|
||||
<orgdiv>Western Software Laboratory</orgdiv>
|
||||
</affiliation>
|
||||
</author>
|
||||
<author>
|
||||
<firstname>Paul</firstname><surname>Asente</surname>
|
||||
<affiliation>
|
||||
<orgname>Digital Equipment Corporation</orgname>
|
||||
<orgdiv>Western Software Laboratory</orgdiv>
|
||||
</affiliation>
|
||||
</author>
|
||||
<author>
|
||||
<firstname>Ralph</firstname><othername>R.</othername>
|
||||
<surname>Swick</surname>
|
||||
<affiliation>
|
||||
<orgname>Digital Equipment Corporation</orgname>
|
||||
<orgdiv>External Research Group</orgdiv>
|
||||
</affiliation>
|
||||
</author>
|
||||
</authorgroup>
|
||||
<printhistory><para>version 6 edited by Donna Converse X Consortium, Inc.</para></printhistory>
|
||||
<printhistory><para>version 7 edited by Thomas E. Dickey <ulink url="https://invisible-island.net"/></para></printhistory>
|
||||
|
||||
<legalnotice>
|
||||
<para>XWindow System is a trademark of X Consortium, Inc.</para>
|
||||
|
||||
<para role="multiLicensing">
|
||||
Copyright © 1985, 1986, 1987, 1988, 1991, 1994 X Consortium
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Permission is hereby granted, free of charge, to any person obtaining
|
||||
a copy of this software and associated documentation files (the
|
||||
“Software”), to deal in the Software without restriction, including
|
||||
without limitation the rights to use, copy, modify, merge, publish,
|
||||
distribute, sublicense, and/or sell copies of the Software, and to
|
||||
permit persons to whom the Software is furnished to do so, subject to
|
||||
the following conditions:
|
||||
</para>
|
||||
|
||||
<para>
|
||||
The above copyright notice and this permission notice shall be included
|
||||
in all copies or substantial portions of the Software.
|
||||
</para>
|
||||
|
||||
<para> THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS
|
||||
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
||||
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
||||
IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR
|
||||
OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
|
||||
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
|
||||
OTHER DEALINGS IN THE SOFTWARE.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Except as contained in this notice, the name of the X Consortium shall
|
||||
not be used in advertising or otherwise to promote the sale, use or
|
||||
other dealings in this Software without prior written authorization
|
||||
from the X Consortium.
|
||||
</para>
|
||||
</legalnotice>
|
||||
|
||||
<legalnotice>
|
||||
<para role="multiLicensing">
|
||||
Copyright © 1985, 1986, 1987, 1988, 1991, 1994
|
||||
Digital Equipment Corporation, Maynard, Massachusetts.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Permission to use, copy, modify and distribute this documentation for any
|
||||
purpose and without fee is hereby granted, provided that the above copyright
|
||||
notice appears in all copies and that both that copyright notice and this
|
||||
permission notice appear in supporting documentation, and that the name of
|
||||
Digital not be used in in advertising or publicity pertaining
|
||||
to distribution of the software without specific, written prior permission.
|
||||
Digital makes no representations about the suitability of the
|
||||
software described herein for any purpose.
|
||||
It is provided “as is” without express or implied warranty.
|
||||
</para>
|
||||
|
||||
</legalnotice>
|
||||
</bookinfo>
|
||||
|
||||
|
||||
|
||||
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="acknowledgement.xml"/>
|
||||
|
||||
|
||||
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="preface.xml"/>
|
||||
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="CH01.xml"/>
|
||||
|
||||
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="CH02.xml"/>
|
||||
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="CH03.xml"/>
|
||||
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="CH04.xml"/>
|
||||
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="CH05.xml"/>
|
||||
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="CH06.xml"/>
|
||||
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="CH07.xml"/>
|
||||
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="CH08.xml"/>
|
||||
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="CH09.xml"/>
|
||||
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="CH10.xml"/>
|
||||
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="CH11.xml"/>
|
||||
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="CH12.xml"/>
|
||||
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="CH13.xml"/>
|
||||
|
||||
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="appA.xml"/>
|
||||
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="appB.xml"/>
|
||||
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="appC.xml"/>
|
||||
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="appD.xml"/>
|
||||
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="appE.xml"/>
|
||||
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="appF.xml"/>
|
||||
|
||||
</book>
|
||||
|
2
lib/libXt/specs/libXt.ent.in
Normal file
2
lib/libXt/specs/libXt.ent.in
Normal file
|
@ -0,0 +1,2 @@
|
|||
<!-- define version entity for libXt documentation via configure.ac -->
|
||||
<!ENTITY package_version "@PACKAGE_VERSION@">
|
54
lib/libXt/specs/preface.xml
Normal file
54
lib/libXt/specs/preface.xml
Normal file
|
@ -0,0 +1,54 @@
|
|||
<?xml version="1.0" encoding="UTF-8" ?>
|
||||
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
|
||||
|
||||
<preface id='About_This_Manual'>
|
||||
<title>About This Manual</title>
|
||||
|
||||
<para>
|
||||
X Toolkit Intrinsics — C Language Interface is intended to be read by both application programmers
|
||||
who will use one or more of the many widget sets built with the Intrinsics and by widget
|
||||
programmers who will use the Intrinsics to build widgets for one of the widget sets. Not all the
|
||||
information in this manual, however, applies to both audiences. That is, because the application
|
||||
programmer is likely to use only a number of the Intrinsics functions in writing an application and
|
||||
because the widget programmer is likely to use many more, if not all, of the Intrinsics functions
|
||||
in building a widget, an attempt has been made to highlight those areas of information that are
|
||||
deemed to be of special interest for the application programmer. (It is assumed the widget programmer
|
||||
will have to be familiar with all the information.) Therefore, all entries in the table of
|
||||
contents that are printed in <emphasis role='strong'>bold</emphasis> indicate the information that
|
||||
should be of special interest to an application programmer.
|
||||
</para>
|
||||
<para>
|
||||
It is also assumed that, as application programmers become more familiar with the concepts discussed
|
||||
in this manual, they will find it more convenient to implement portions of their applications
|
||||
as special-purpose or custom widgets. It is possible, nonetheless, to use widgets without
|
||||
knowing how to build them.
|
||||
</para>
|
||||
|
||||
<bridgehead><emphasis role='strong'>Conventions Used in this Manual</emphasis></bridgehead>
|
||||
<para>This document uses the following conventions:</para>
|
||||
<itemizedlist spacing='compact'>
|
||||
<listitem>
|
||||
<para>
|
||||
Global symbols are printed in <function>this special font</function>. These can be either
|
||||
function names, symbols defined in include files, data types, or structure names. Arguments to
|
||||
functions, procedures, or macros are printed in italics.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Each function is introduced by a general discussion that distinguishes it from other functions.
|
||||
The function declaration itself follows, and each argument is specifically explained.
|
||||
General discussion of the function, if any is required, follows the arguments.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
To eliminate any ambiguity between those arguments that you pass and those that a function
|
||||
returns to you, the explanations for all arguments that you pass start with the word
|
||||
specifies or, in the case of multiple arguments, the word specify. The explanations for all
|
||||
arguments that are returned to you start with the word <emphasis>returns</emphasis> or, in
|
||||
the case of multiple arguments, the word <emphasis>return</emphasis>.
|
||||
</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</preface>
|
Loading…
Add table
Add a link
Reference in a new issue