sync code with last improvements from OpenBSD

This commit is contained in:
purplerain 2023-08-28 05:57:34 +00:00
commit 88965415ff
Signed by: purplerain
GPG key ID: F42C07F07E2E35B7
26235 changed files with 29195616 additions and 0 deletions

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

File diff suppressed because it is too large Load diff

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

File diff suppressed because it is too large Load diff

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

File diff suppressed because it is too large Load diff

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
View 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

File diff suppressed because it is too large Load diff

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

File diff suppressed because it is too large Load diff

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

File diff suppressed because it is too large Load diff

View 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
View 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:

View 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&amp;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&amp;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&amp;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&rsquo;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&rsquo;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&amp;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&amp;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&amp;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&rsquo;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&rsquo;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
View 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 &mdash; 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 | &lt;empty line&gt;</entry>
</row>
<row>
<entry>Comment</entry>
<entry>=&ldquo;!&rdquo; {&lt;any character except null or newline&gt;}</entry>
</row>
<row>
<entry>IncludeFile</entry>
<entry>= &ldquo;#&rdquo; WhiteSpace &ldquo;include&rdquo; WhiteSpace FileName WhiteSpace</entry>
</row>
<row>
<entry>FileName</entry>
<entry>= &lt;valid filename for operating system&gt;</entry>
</row>
<row>
<entry>ResourceSpec</entry>
<entry>= WhiteSpace ResourceName WhiteSpace &ldquo;:&rdquo; WhiteSpace Value</entry>
</row>
<row>
<entry>ResourceName</entry>
<entry>= [Binding] {Component Binding} ComponentName</entry>
</row>
<row>
<entry>Binding</entry>
<entry>=&ldquo;.&rdquo; | &ldquo;*&rdquo;</entry>
</row>
<row>
<entry>WhiteSpace</entry>
<entry>= {&lt;space> | &lt;horizontal tab&gt;}</entry>
</row>
<row>
<entry>Component</entry>
<entry>= &ldquo;?&rdquo; | ComponentName</entry>
</row>
<row>
<entry>ComponentName</entry>
<entry>= NameChar {NameChar}</entry>
</row>
<row>
<entry>NameChar</entry>
<entry>= &ldquo;a&rdquo;&ndash;&ldquo;z&rdquo; | &ldquo;A&rdquo;&ndash;&ldquo;Z&rdquo; | &ldquo;0&rdquo;&ndash;&ldquo;9&rdquo; | &ldquo;_&rdquo; | &ldquo;-&rdquo;</entry>
</row>
<row>
<entry>Value</entry>
<entry>={&lt;any character except null or unescaped newline&gt;}</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 (&ldquo;...&rdquo;) 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 &ldquo;\<emphasis remap='I'>space</emphasis>&rdquo; (backslash followed by space)
is recognized and replaced by a space character,
and the two-character sequence &ldquo;\<emphasis remap='I'>tab</emphasis>&rdquo;
(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 &ldquo;\n&rdquo; 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 &ldquo;\<emphasis remap='I'>newline</emphasis>&rdquo;
(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 &ldquo;\<emphasis remap='I'>nnn</emphasis>&rdquo;,
where each <emphasis remap='I'>n</emphasis> is a digit character in the range of &ldquo;0&rdquo;&ndash;&ldquo;7&rdquo;,
is recognized and replaced with a single byte that contains
the octal value specified by the sequence.
Finally, the two-character sequence &ldquo;\\&rdquo; is recognized
and replaced with a single backslash.
</para>
</appendix>

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

File diff suppressed because it is too large Load diff

883
lib/libXt/specs/appD.xml Normal file
View 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
&ldquo;XtToolkitError&rdquo;.
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 &gt; 0 on NULL argument list in XtGetValues</entry>
</row>
<row>
<entry>invalidArgCount</entry>
<entry>xtSetValues</entry>
<entry>Argument count &gt; 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 &gt; 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 &gt; 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

File diff suppressed because it is too large Load diff

106
lib/libXt/specs/appF.xml Normal file
View 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>

View 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 &ndash; 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 &ndash; 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 &copy; 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
&ldquo;Software&rdquo;), 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 &ldquo;AS IS&rdquo;, 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 &copy; 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 &ldquo;as is&rdquo; 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>

View file

@ -0,0 +1,2 @@
<!-- define version entity for libXt documentation via configure.ac -->
<!ENTITY package_version "@PACKAGE_VERSION@">

View 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 &mdash; 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>