From 51500da421891cd7f67019677b24f848418a17e0 Mon Sep 17 00:00:00 2001 From: Matt Dew Date: Sat, 5 Nov 2011 19:56:29 -0600 Subject: Added acknowledgment file. cleaned up tables. --- specs/CH01.xml | 36 +++-- specs/CH03.xml | 2 +- specs/CH04.xml | 346 ++++++++++++++++++++++++++------------------ specs/CH05.xml | 2 +- specs/CH06.xml | 25 ++-- specs/CH09.xml | 53 ++++--- specs/CH10.xml | 6 +- specs/CH11.xml | 11 +- specs/CH12.xml | 18 ++- specs/acknowledgement.xml | 310 +++++++++++++++++++++++++++++++++++++++ specs/appA.xml | 5 +- specs/appB.xml | 56 +++++--- specs/appD.xml | 22 +-- specs/appE.xml | 132 ++++++++++------- specs/intrinsics.xml | 1 + specs/preface.xml | 359 +++++++--------------------------------------- 16 files changed, 799 insertions(+), 585 deletions(-) create mode 100755 specs/acknowledgement.xml diff --git a/specs/CH01.xml b/specs/CH01.xml index 7fcf376..60a19ab 100755 --- a/specs/CH01.xml +++ b/specs/CH01.xml @@ -376,13 +376,14 @@ The resource names, classes, and representation types specified in the coreClassRec resource list are - - + + + - + Name Class Representation @@ -454,15 +455,18 @@ resource lists; see Sections 12.2 and 12.3 for details. The default values for the Core fields, which are filled in by the Intrinsics, from the resource lists, and by the initialize procedures, are - - + + + - - + + Field Default Value + + self Address of the widget structure (may not be changed). @@ -749,17 +753,20 @@ the resource list are - - + + + - - + + Name Class Representation + + XtNchildren XtCReadOnly @@ -791,9 +798,10 @@ Composite initialize procedure, are - - - + + + + diff --git a/specs/CH03.xml b/specs/CH03.xml index 21d713f..6fa3c74 100755 --- a/specs/CH03.xml +++ b/specs/CH03.xml @@ -159,7 +159,7 @@ The insert_child procedure pointer in a composite widget is of type -void *XtWidgetProc +typedef void (*XtWidgetProc) Widget w diff --git a/specs/CH04.xml b/specs/CH04.xml index e7e3a20..00be033 100755 --- a/specs/CH04.xml +++ b/specs/CH04.xml @@ -19,43 +19,54 @@ Clients should never attempt to change the size of their shells directly. The five types of public shells are: - - - - - - - OverrideShell - Used for shell windows that completely bypass the window manager - (for example, pop-up menu shells). - - - TransientShell - Used for shell windows that have the + + + OverrideShell + + + Used for shell windows that completely bypass the window manager + (for example, pop-up menu shells). + + + + + TransientShell + + Used for shell windows that have the WM_TRANSIENT_FOR property set. The effect of this property is dependent upon the - window manager being used. - - - TopLevelShell - Used for normal top-level windows - (for example, any additional top-level widgets an application needs). - - - ApplicationShell - Formerly used for the single main top-level window that + window manager being used. + + + + + TopLevelShell + + Used for normal top-level windows + (for example, any additional top-level widgets an application needs). + + + + + ApplicationShell + + Formerly used for the single main top-level window that the window manager identifies as an application instance and - made obsolete by SessionShell. - - - SessionShell - Used for the single main top-level window that + made obsolete by SessionShell. + + + + + SessionShell + + + Used for the single main top-level window that the window manager identifies as an application instance and - that interacts with the session manager. - - - - + that interacts with the session manager. + + + + Shell Widget Definitions @@ -79,56 +90,69 @@ They also can provide a layer of communication with the window manager. The eight different types of shells are: - - - - - - - Shell - The base class for shell widgets; provides the + + + Shell + + The base class for shell widgets; provides the fields needed for all types of shells. Shell is a direct subclass of - compositeWidgetClass. - - - OverrideShell - A subclass of Shell; used for shell windows that completely - bypass the window manager. - - - WMShell - A subclass of Shell; contains fields needed by the - common window manager protocol. - - - VendorShell - A subclass of WMShell; contains fields used by - vendor-specific window managers. - - - TransientShell - A subclass of VendorShell; used for shell windows that + compositeWidgetClass. + + + + + OverrideShell + + A subclass of Shell; used for shell windows that completely + bypass the window manager. + + + + WMShell + + A subclass of Shell; contains fields needed by the + common window manager protocol. + + + + VendorShell + + A subclass of WMShell; contains fields used by + vendor-specific window managers. + + + + + TransientShell + + A subclass of VendorShell; used for shell windows that desire the WM_TRANSIENT_FOR - property. - - - TopLevelShell - A subclass of VendorShell; used for normal top-level windows. - - - ApplicationShell - A subclass of TopLevelShell; may be used for an application's additional - root windows. - - - SessionShell - A subclass of ApplicationShell; used for an application's - main root window. - - - - + property. + + + + TopLevelShell + + A subclass of VendorShell; used for normal top-level windows. + + + + + ApplicationShell + + A subclass of TopLevelShell; may be used for an application's additional + root windows. + + + + SessionShell + + A subclass of ApplicationShell; used for an application's + main root window. + + + Note that the classes @@ -289,15 +313,18 @@ for generic operations on widgets whose class is a subclass of Shell. - - + + + - - + + Types Variables + + ShellWidget shellWidgetClass @@ -643,17 +670,20 @@ the resource list are: - - + + + - - + + Name Class Representation + + XtNallowShellResize XtCAllowShellResize @@ -711,17 +741,20 @@ the resource list are: - - + + + - - + + Name Class Representation + + XtNbaseHeight XtCBaseHeight @@ -886,17 +919,20 @@ The resource names, classes, and representation types that are specified in the resource list are: - - + + + - - + + Name Class Representation + + XtNtransientFor XtCTransientFor @@ -912,17 +948,20 @@ The resource names, classes, and representation types that are specified in the resource list are: - - + + + - - + + Name Class Representation + + XtNiconName XtCIconName @@ -948,17 +987,20 @@ The resource names, classes, and representation types that are specified in the resource list are: - - + + + - - + + Name Class Representation + + XtNargc XtCArgc @@ -980,17 +1022,20 @@ in the resource list are: - - + + + - - + + Name Class Representation + + XtNcancelCallback XtCCallback @@ -1098,15 +1143,18 @@ Shell initialize procedures) are: - - + + + - + Field Default Value + + geometry NULL @@ -1195,7 +1243,7 @@ Shell classes; a client specifying the string in an arglist or varargs list must ensure that the value remains valid until the shell widget is realized. For further information on the geometry string, see Section 16.4 -in (xL. +in Xlib — C Language X Interface. @@ -1229,8 +1277,8 @@ determines whether the window manager can intercede when the shell window is mapped. For further information on override_redirect, -see Section 3.2 in (xL and Sections 4.1.10 and 4.2.2 in the -(xC. +see Section 3.2 in Xlib — C Language X Interface and Sections 4.1.10 and 4.2.2 in the +Inter-Client Communication Conventions Manual. The pop-up and pop-down callbacks are called during and @@ -1253,15 +1301,18 @@ WMShell and its subclasses are: - - + + + - - + + Field Default Value + + title Icon name, if specified, otherwise the application's name @@ -1420,7 +1471,7 @@ the property will be stored on the shell window with a value as specified below. The interpretation of this property is specific to the window manager -under which the application is run; see the (xC for more details. +under which the application is run; see the Inter-Client Communication Conventions Manual for more details. @@ -1460,15 +1511,18 @@ a flag bit is set that refers to a field with the value the value of the field is modified as follows: - - + + + - - + + Field Replacement + + base_width, base_height 0 @@ -1533,15 +1587,18 @@ Transient shells have the following additional resource: - - + + + - + Field Replacement + + transient_for NULL @@ -1569,15 +1626,18 @@ shells have the the following additional resources: - - + + + - - + + Field Default Value + + icon_name Shell widget's name @@ -1616,7 +1676,7 @@ that the window manager iconify or deiconify the shell; the TopLevelShell set_values procedure will send the appropriate WM_CHANGE_STATE -message (as specified by the (xC) +message (as specified by the Inter-Client Communication Conventions Manual) if this resource is changed from False to @@ -1644,15 +1704,18 @@ Application shells have the following additional resources: - - + + + - - + + Field Default Value + + argc 0 @@ -1669,7 +1732,7 @@ shells have the following additional resources: The argc and argv fields are used to initialize the standard property WM_COMMAND. -See the (xC for more information. +See the Inter-Client Communication Conventions Manual for more information. @@ -1678,15 +1741,18 @@ which are filled in from the resource lists and by the initialize procedure, are - - + + + - - + + Field Default Value + + cancel_callbacks NULL diff --git a/specs/CH05.xml b/specs/CH05.xml index 53f17be..90a8c7a 100755 --- a/specs/CH05.xml +++ b/specs/CH05.xml @@ -892,7 +892,7 @@ Unmaps popup_shell's window and, if False, sends a synthetic UnmapNotify -event as specified by the (xC. +event as specified by the Inter-Client Communication Conventions Manual. diff --git a/specs/CH06.xml b/specs/CH06.xml index 28a7118..d6aff3c 100755 --- a/specs/CH06.xml +++ b/specs/CH06.xml @@ -285,8 +285,9 @@ The request_mode definitions are from <X11/X.h>. - - + + + @@ -334,8 +335,9 @@ The request_mode definitions are from The Intrinsics also support the following value. - - + + + @@ -370,8 +372,9 @@ The stack_mode definitions are from <X11/X.h>: - - + + + @@ -409,8 +412,9 @@ The stack_mode definitions are from The Intrinsics also support the following value. - - + + + @@ -1248,6 +1252,9 @@ the query_geometry procedure should return If the preferred geometry is identical to the current geometry, the query_geometry procedure should return XtGeometryNo. + + + The query_geometry procedure may assume that no @@ -1257,7 +1264,7 @@ is in progress for the specified widget; that is, it is not required to construct a reply consistent with the requested geometry if such a request were actually outstanding. - + After calling the query_geometry procedure diff --git a/specs/CH09.xml b/specs/CH09.xml index 29950f7..811bafc 100755 --- a/specs/CH09.xml +++ b/specs/CH09.xml @@ -165,15 +165,18 @@ physical representation (see Section 9.6). The Intrinsics define the following resource types: - - + + + - - + + Resource Type Structure or Field Type + + XtRAcceleratorTable XtAccelerators @@ -1307,17 +1310,20 @@ input values of representation type XtRString. - - + + + - - + + Target Representation Converter Name Additional Args + + XtRAcceleratorTable XtCvtStringToAcceleratorTable @@ -1590,7 +1596,7 @@ matching Visual on the list. The widget resource list must be certain to specify any resource of type XtRVisual after the depth resource. -The allowed string values are the visual class names defined in (xP, +The allowed string values are the visual class names defined in X Window System Protocol, Section 8; StaticGray, StaticColor, @@ -1607,17 +1613,20 @@ an input value of representation type XtRColor. - - + + + - + Target Representation Converter Name Additional Args + + XtRPixel XtCvtColorToPixel @@ -1632,17 +1641,20 @@ input values of representation type XtRInt. - - + + + - + Target Representation Converter Name Additional Args + + XtRBoolean XtCvtIntToBoolean @@ -1698,18 +1710,21 @@ an input value of representation type XtRPixel. - - + + + - + Target Representation Converter Name Additional Args - + + + XtRColor XtCvtPixelToColor diff --git a/specs/CH10.xml b/specs/CH10.xml index bdd44fa..71e9003 100755 --- a/specs/CH10.xml +++ b/specs/CH10.xml @@ -1428,7 +1428,7 @@ The default translator is an that uses the Shift, Lock, numlock, and group modifiers -with the interpretations defined in (xP, Section 5. +with the interpretations defined in X Window System Protocol, Section 5. It is provided so that new translators can call it to get default KeyCode-to-KeySym translations and so that the default translator can be reinstalled. @@ -1648,7 +1648,7 @@ you need to register an identity converter. When a new converter is registered, the Intrinsics refresh the keyboard state if necessary. The default converter understands case conversion for all -Latin KeySyms defined in (xP, Appendix A. +Latin KeySyms defined in X Window System Protocol, Appendix A. @@ -1876,7 +1876,7 @@ procedure returns all the KeyCodes that have keysymdisplay. For each entry in the table, the first four KeySyms (groups 1 and 2) are interpreted as -specified by (xP, Section 5. If no KeyCodes map to the +specified by X Window System Protocol, Section 5. If no KeyCodes map to the specified KeySym, keycount_return is zero and *keycodes_return is NULL. diff --git a/specs/CH11.xml b/specs/CH11.xml index 958bf80..5f0c537 100755 --- a/specs/CH11.xml +++ b/specs/CH11.xml @@ -4834,17 +4834,20 @@ as an argument: The resource names, classes, and representation types that are specified in the hook object resource list are: - - + + + - - + + Name Class Representation + + XtNcreateHook XtCCallback diff --git a/specs/CH12.xml b/specs/CH12.xml index a5d75df..51e8213 100755 --- a/specs/CH12.xml +++ b/specs/CH12.xml @@ -229,17 +229,20 @@ The resource names, classes, and representation types specified in the resource list are: - - + + + - + Name Class Representation + + XtNdestroyCallback XtCCallback @@ -645,17 +648,20 @@ typedef struct _RectObjRec* RectObj; The resource names, classes, and representation types that are specified in the rectObjClassRec resource list are: - - + + + - + Name Class Representation + + XtNancestorSensitive XtCSensitive diff --git a/specs/acknowledgement.xml b/specs/acknowledgement.xml new file mode 100755 index 0000000..4458d9f --- /dev/null +++ b/specs/acknowledgement.xml @@ -0,0 +1,310 @@ + +Acknowledgments + + +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: + + + + + + + + + + + Loretta Guarino-Reid (Digital WSL) + Rich Hyde (Digital WSL) + + + Susan Angebranndt (Digital WSL) + Terry Weissman (Digital WSL) + + + Mary Larson (Digital UEG) + Mark Manasse (Digital SRC) + + + Jim Gettys (Digital SRC) + Leo Treggiari (Digital SDT) + + + Ralph Swick (Project Athena and Digital ERP) + Mark Ackerman (Project Athena) + + + Ron Newman (Project Athena) + Bob Scheifler (MIT LCS) + + + + + + + +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. + + + +The design and implementation of the X10 Intrinsics were done by: + + + + + + + + + + Terry Weissman (Digital WSL) + + + Smokey Wallace (Digital WSL) + + + Phil Karlton (Digital WSL) + + + Charles Haynes (Digital WSL) + + + Frank Hall (HP) + + + + + + + +The design and implementation of the X10 toolkit’s sample widgets were by +the above, as well as by: + + + + + + + + + + Ram Rao (Digital UEG) + + + Mary Larson (Digital UEG) + + + Mike Gancarz (Digital UEG) + + + Kathleen Langone (Digital UEG) + + + + + + + +These widgets provided a checklist of requirements that we had to address in the X11 Intrinsics. + + +Thanks go to Al Mento of Digital’s UEG Documentation Group for formatting and generally +improving this document and to John Ousterhout of Berkeley for extensively reviewing early +drafts of it. + + +Finally, a special thanks to Mike Chow, whose extensive performance analysis of the X10 toolkit +provided the justification to redesign it entirely for X11. + + + +Joel McCormack +Western Software Laboratory +Digital Equipment Corporation +March 1988 + + + + +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: + + + + + + + + + + + Steve Pitschke (Stellar) + C.Doug Blewett (AT&T) + + + Bob Miller (HP) + David Schiferl (Tektronix) + + + Fred Taft (HP) + Michael Squires (Sequent) + + + Marcel Meth (AT&T) + JimFulton (MIT) + + + Mike Collins (Digital) + Kerry Kimbrough (Texas Instruments) + + + Scott McGregor (Digital) + Phil Karlton (Digital) + + + Julian Payne (ESS) + Jacques Davy (Bull) + + + Gabriel Beged-Dov (HP) + GlennWidener (Tektronix) + + + + + + + +Thanks go to each of them for the countless hours spent reviewing drafts and code. + + + +Ralph R. Swick +External Research Group +Digital Equipment Corporation +MIT Project Athena +June 1988 + + + + +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: + + + + + + + + + + + Don Alecci (AT&T) + EllisCohen (OSF) + + + Donna Converse (MIT) + Clive Feather (IXI) + + + Nayeem Islam (Sun) + Dana Laursen (HP) + + + Keith Packard (MIT) + Chris Peterson (MIT) + + + Richard Probst (Sun) + Larry Cable (Sun) + + + + + + + +In Release 5, the effort to define the internationalization additions was headed by Bill McMahon +of Hewlett Packard and Frank Rojas of IBM. This has been an educational process for many of +us, and Bill and Frank’s tutelage has carried us through. Vania Joloboff of the OSF also contributed +to the internationalization additions. The implementation efforts of Bill, Gabe Beged-Dov, +and especially Donna Converse for this release are also gratefully acknowledged. + + + +Ralph R. Swick +December 1989 +and +July 1991 + + + + +The Release 6 Intrinsics is a result of the collaborative efforts of participants in the X Consortium’s +intrinsics working group. A few individuals contributed substantial design proposals, participated +in lengthy discussions, reviewed final specifications, and in most cases, were also +responsible for sections of the implementation. They deserve recognition and thanks for their +major contributions: + + + + + + + + + + + Paul Asente (Adobe) + Larry Cable (SunSoft) + + + Ellis Cohen (OSF) + Daniel Dardailler (OSF) + + + Vania Joloboff (OSF) + KalebKeithley (X Consortium) + + + Courtney Loomis (HP) + Douglas Rand (OSF) + + + Bob Scheifler (X Consortium) + Ajay Vohra (SunSoft) + + + + + + + +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. + + + +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. + + + +Donna Converse +X Consortium +April 1994 + + diff --git a/specs/appA.xml b/specs/appA.xml index 9d657a4..647bb94 100755 --- a/specs/appA.xml +++ b/specs/appA.xml @@ -12,8 +12,9 @@ for convenience only. The format of a resource specification is - - + + + diff --git a/specs/appB.xml b/specs/appB.xml index b5ca625..2ace627 100755 --- a/specs/appB.xml +++ b/specs/appB.xml @@ -6,8 +6,9 @@ Syntax is specified in EBNF notation with the following conventions: - - + + + @@ -38,8 +39,9 @@ Syntax The syntax of a translation table is - - + + + @@ -247,17 +249,20 @@ The use of "None" for a modifier list is identical to the use of an exclamation point with no modifers. - - + + + - - + + Modifier Abbreviation Meaning + + Ctrl c @@ -415,15 +420,18 @@ Xlib symbolic event type names, the following event type synonyms are defined: - - + + + - - + + Type Meaning + + Key KeyPress @@ -582,17 +590,20 @@ are defined: The supported abbreviations are: - - + + + - + Abbreviation Event Type Including + + Ctrl KeyPress @@ -699,8 +710,9 @@ by X Window System Protocol, Section 11. The detail field is supported for the following event types: - - + + + @@ -830,8 +842,9 @@ The canonical representation of a translation table is (see also "Syntax") - - + + + @@ -936,8 +949,9 @@ The canonical representation of a translation table is (see also The canonical event types are - - + + + diff --git a/specs/appD.xml b/specs/appD.xml index 28a4e64..88be1c0 100755 --- a/specs/appD.xml +++ b/specs/appD.xml @@ -10,17 +10,20 @@ Additional implementation-dependent messages are permitted. Error Messages - - + + + - - + + Name Type Default Message + + allocError calloc @@ -262,17 +265,20 @@ Error Messages Warning Messages - - + + + - - + + Name Type Default Message + + ambiguousParent xtChangeManagedSet diff --git a/specs/appE.xml b/specs/appE.xml index a361a37..64bf97e 100755 --- a/specs/appE.xml +++ b/specs/appE.xml @@ -8,15 +8,18 @@ class, and representation type symbolic constants. Resource names: - - + + + - - + + Symbol Definition + + XtNaccelerators "accelerators" @@ -402,15 +405,18 @@ class, and representation type symbolic constants. Resource classes: - - + + + - - + + Symbol Definition + + XtCAccelerators "Accelerators" @@ -689,15 +695,18 @@ class, and representation type symbolic constants. Resource representation types: - - + + + - - + + Symbol Definition + + XtRAcceleratorTable "AcceleratorTable" @@ -907,15 +916,18 @@ class, and representation type symbolic constants. Boolean enumeration constants: - - + + + - - + + Symbol Definition + + XtEoff "off" @@ -945,15 +957,18 @@ class, and representation type symbolic constants. Orientation enumeration constants: - - + + + - - + + Symbol Definition + + XtEvertical "vertical" @@ -968,15 +983,18 @@ class, and representation type symbolic constants. Text edit enumeration constants: - - + + + - - + + Symbol Definition + + XtEtextRead "read" @@ -994,15 +1012,18 @@ class, and representation type symbolic constants. Color enumeration constants: - - + + + - - + + Symbol Definition + + XtExtdefaultbackground "xtdefaultbackground" @@ -1016,15 +1037,18 @@ class, and representation type symbolic constants. Font constant: - - + + + - - + + Symbol Definition + + XtExtdefaultfont "xtdefaultfont" @@ -1034,15 +1058,18 @@ class, and representation type symbolic constants. Hooks for External Agents constants: - - + + + - - + + Symbol Definition + + XtHcreate "Xtcreate" @@ -1163,15 +1190,18 @@ class, and representation type symbolic constants. Resource names: - - + + + - - + + Symbol Definition + + XtNallowShellResize "allowShellResize" @@ -1417,15 +1447,18 @@ class, and representation type symbolic constants. Resource classes: - - + + + - - + + Symbol Definition + + XtCAllowShellResize "allowShellResize" @@ -1648,15 +1681,18 @@ class, and representation type symbolic constants. Resource representation types: - - + + + - - + + Symbol Definition + + XtRAtom "Atom" diff --git a/specs/intrinsics.xml b/specs/intrinsics.xml index 256d0be..c6f23a8 100755 --- a/specs/intrinsics.xml +++ b/specs/intrinsics.xml @@ -96,6 +96,7 @@ It is provided "as is" without express or implied warranty. + diff --git a/specs/preface.xml b/specs/preface.xml index efb5897..8d6c134 100755 --- a/specs/preface.xml +++ b/specs/preface.xml @@ -1,310 +1,51 @@ - -Acknowledgments - - -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: - - - - - - - - - - - Loretta Guarino-Reid (Digital WSL) - Rich Hyde (Digital WSL) - - - Susan Angebranndt (Digital WSL) - Terry Weissman (Digital WSL) - - - Mary Larson (Digital UEG) - Mark Manasse (Digital SRC) - - - Jim Gettys (Digital SRC) - Leo Treggiari (Digital SDT) - - - Ralph Swick (Project Athena and Digital ERP) - Mark Ackerman (Project Athena) - - - Ron Newman (Project Athena) - Bob Scheifler (MIT LCS) - - - - - - - -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. - - - -The design and implementation of the X10 Intrinsics were done by: - - - - - - - - - - Terry Weissman (Digital WSL) - - - Smokey Wallace (Digital WSL) - - - Phil Karlton (Digital WSL) - - - Charles Haynes (Digital WSL) - - - Frank Hall (HP) - - - - - - - -The design and implementation of the X10 toolkit’s sample widgets were by -the above, as well as by: - - - - - - - - - - Ram Rao (Digital UEG) - - - Mary Larson (Digital UEG) - - - Mike Gancarz (Digital UEG) - - - Kathleen Langone (Digital UEG) - - - - - - - -These widgets provided a checklist of requirements that we had to address in the X11 Intrinsics. - - -Thanks go to Al Mento of Digital’s UEG Documentation Group for formatting and generally -improving this document and to John Ousterhout of Berkeley for extensively reviewing early -drafts of it. - - -Finally, a special thanks to Mike Chow, whose extensive performance analysis of the X10 toolkit -provided the justification to redesign it entirely for X11. - - - -Joel McCormack -Western Software Laboratory -Digital Equipment Corporation -March 1988 - - - - -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: - - - - - - - - - - - Steve Pitschke (Stellar) - C.Doug Blewett (AT&T) - - - Bob Miller (HP) - David Schiferl (Tektronix) - - - Fred Taft (HP) - Michael Squires (Sequent) - - - Marcel Meth (AT&T) - JimFulton (MIT) - - - Mike Collins (Digital) - Kerry Kimbrough (Texas Instruments) - - - Scott McGregor (Digital) - Phil Karlton (Digital) - - - Julian Payne (ESS) - Jacques Davy (Bull) - - - Gabriel Beged-Dov (HP) - GlennWidener (Tektronix) - - - - - - - -Thanks go to each of them for the countless hours spent reviewing drafts and code. - - - -Ralph R. Swick -External Research Group -Digital Equipment Corporation -MIT Project Athena -June 1988 - - - - -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: - - - - - - - - - - - Don Alecci (AT&T) - EllisCohen (OSF) - - - Donna Converse (MIT) - Clive Feather (IXI) - - - Nayeem Islam (Sun) - Dana Laursen (HP) - - - Keith Packard (MIT) - Chris Peterson (MIT) - - - Richard Probst (Sun) - Larry Cable (Sun) - - - - - - - -In Release 5, the effort to define the internationalization additions was headed by Bill McMahon -of Hewlett Packard and Frank Rojas of IBM. This has been an educational process for many of -us, and Bill and Frank’s tutelage has carried us through. Vania Joloboff of the OSF also contributed -to the internationalization additions. The implementation efforts of Bill, Gabe Beged-Dov, -and especially Donna Converse for this release are also gratefully acknowledged. - - - -Ralph R. Swick -December 1989 -and -July 1991 - - - - -The Release 6 Intrinsics is a result of the collaborative efforts of participants in the X Consortium’s -intrinsics working group. A few individuals contributed substantial design proposals, participated -in lengthy discussions, reviewed final specifications, and in most cases, were also -responsible for sections of the implementation. They deserve recognition and thanks for their -major contributions: - - - - - - - - - - - Paul Asente (Adobe) - Larry Cable (SunSoft) - - - Ellis Cohen (OSF) - Daniel Dardailler (OSF) - - - Vania Joloboff (OSF) - KalebKeithley (X Consortium) - - - Courtney Loomis (HP) - Douglas Rand (OSF) - - - Bob Scheifler (X Consortium) - Ajay Vohra (SunSoft) - - - - - - - -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. - - - -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. - - - -Donna Converse -X Consortium -April 1994 - + +About This Manual + + +X Toolkit Intrinsics — C Language Interface is intended to be read by both application programmers +who will use one or more of the many widget sets built with the Intrinsics and by widget +programmers who will use the Intrinsics to build widgets for one of the widget sets. Not all the +information in this manual, however, applies to both audiences. That is, because the application +programmer is likely to use only a number of the Intrinsics functions in writing an application and +because the widget programmer is likely to use many more, if not all, of the Intrinsics functions +in building a widget, an attempt has been made to highlight those areas of information that are +deemed to be of special interest for the application programmer. (It is assumed the widget programmer +will have to be familiar with all the information.) Therefore, all entries in the table of +contents that are printed in bold indicate the information that +should be of special interest to an application programmer. + + +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. + + +Conventions Used in this Manual +This document uses the following conventions: + + + +Global symbols are printed in this special font. 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. + + + + +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. + + + + +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 returns or, in +the case of multiple arguments, the word return. + + + -- cgit v1.2.3