home *** CD-ROM | disk | FTP | other *** search
- .\" $XConsortium: Xtk.intr.front,v 1.6 91/08/26 20:34:33 swick Exp $
- .\" MIT header page and copyright notice
- .\" MIT page header and footers
- .\"
- .EH ''''
- .OH ''''
- .EF ''''
- .OF ''''
- .ps 11
- .nr PS 11
- \&
- .sp 8
- .ce 4
- \s+2\fB\*(xT\fP\s-2
-
- \s+1\fBX Window System\fP\s-1
-
- \s+1\fBX Version 11, Release \*(Rn\fP\s-1
-
-
- First Revision - August, 1991
- .sp 5
- .ce 4
- \s-1Joel McCormack
- .sp 6p
- Digital Equipment Corporation
- Western Software Laboratory
- .sp 2
- .ce 4
- Paul Asente
- .sp 6p
- Digital Equipment Corporation
- Western Software Laboratory
- .sp 2
- .ce 4
- Ralph R. Swick
- .sp 6p
- Digital Equipment Corporation
- External Research Group
- MIT X Consortium\s+1
- .bp
- \&
- .ps 9
- .nr PS 9
- .sp 8
- .LP
- The X Window System is a trademark of MIT.
- .LP
- Copyright \(co 1985, 1986, 1987, 1988, 1991
- Massachusetts Institute of Technology, Cambridge, Massachusetts,
- and Digital Equipment Corporation, Maynard, Massachusetts.
- .LP
- 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
- M.I.T. or Digital not be used in in advertising or publicity pertaining
- to distribution of the software without specific, written prior permission.
- M.I.T and Digital makes no representations about the suitability of the
- software described herein for any purpose.
- It is provided ``as is'' without express or implied warranty.
- .ps 11
- .nr PS 11
- .bp iii
- .XS iii
- Acknowledgments
- .XE
- \&
- .sp 1
- .ce 3
- \s+1\fBAcknowledgments\fP\s-1
- .sp 2
- .na
- .LP
- 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:
- .LP
- .Ds
- 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)
- Ralph Swick (Project Athena and Digital ERP)
- Leo Treggiari (Digital SDT)
- Ron Newman (Project Athena)
- Mark Ackerman (Project Athena)
- Bob Scheifler (MIT LCS)
- .De
- .LP
- 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.
- .LP
- The design and implementation of the X10 Intrinsics were done by:
- .LP
- .Ds
- Terry Weissman (Digital WSL)
- Smokey Wallace (Digital WSL)
- Phil Karlton (Digital WSL)
- Charles Haynes (Digital WSL)
- Frank Hall (HP)
- .De
- .LP
- The design and implementation of the X10 toolkit's sample widgets were
- by the above, as well as by:
- .LP
- .Ds
- Ram Rao (Digital UEG)
- Mary Larson (Digital UEG)
- Mike Gancarz (Digital UEG)
- Kathleen Langone (Digital UEG)
- .De
- These widgets provided a checklist of requirements that we
- had to address in the X11 intrinsics.
- .LP
- 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.
- .LP
- Finally, a special thanks to Mike Chow,
- whose extensive performance analysis of the X10 toolkit provided
- the justification to redesign it entirely for X11.
- .LP
- .sp
- .Ds 0
- Joel McCormack
- Western Software Laboratory
- Digital Equipment Corporation
-
- March, 1988
- .De
- .bp
- .LP
- The current design of the \*(xI 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 \*(xI:
- .LP
- .Ds
- .ta 3i
- Steve Pitschke (Stellar) C. Doug Blewett (AT&T)
- Bob Miller (HP) David Schiferl (Tektronix)
- Fred Taft (HP) Michael Squires (Sequent)
- Marcel Meth (AT&T) Jim Fulton (MIT)
- Mike Collins (Digital) Kerry Kimbrough (Texas Instruments)
- Scott McGregor (Digital) Phil Karlton (Digital)
- Julian Payne (ESS) Jacques Davy (Bull)
- Gabriel Beged-Dov (HP) Glenn Widener (Tektronix)
- .De
- .LP
- Thanks go to each of them for the countless hours spent
- reviewing drafts and code.
- .LP
- .sp
- .Ds 0
- Ralph R. Swick
- External Research Group
- Digital Equipment Corporation
- MIT Project Athena
-
- June, 1988
- .sp
- .LP
- 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:
- .LP
- .Ds
- .ta 3i
- Don Alecci (AT&T) Ellis Cohen (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)
- .De
- .sp
- .LP
- 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.
- .sp
- .Ds 0
- Ralph R. Swick
-
- December, 1989
- and
- July, 1991
- .De
- .bp iv
- .XS iv
- About This Manual
- .XE
- \&
- .sp 1
- .ce 3
- \s+1\fBAbout This Manual\fP\s-1
- .sp 2
- .na
- .LP
- \fI\*(xT\fP is intended to be read by both application programmers who will
- use one or more of the many widget sets built with the \*(xI
- and by widget programmers who will use the \*(xI 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 \*(xI functions in writing an application and because the widget programmer
- is is likely to use many more, if not all, of the \*(xI 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 \fBbold\fP
- indicate the information that should be of special interest to an
- application programmer.
- .LP
- 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, none the less, to use widgets without knowing how to build them.
- .SH
- Conventions Used in this Manual
- .LP
- This document uses the following conventions:
- .IP \(bu 5
- Global symbols are printed in
- .PN this
- .PN special
- .PN 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 \fIitalics\fP.
- .IP \(bu 5
- 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.
- .IP \(bu 5
- 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
- \fIspecifies\fP or, in the case of multiple arguments, the word \fIspecify\fP.
- The explanations for all arguments that are returned to you start with the
- word \fIreturns\fP or, in the case of multiple arguments, the word \fIreturn\^\fP.
- .bp 1
- .EH '\fBX Toolkit Intrinsics\fP''\fBX11 Release \*(Rn\fP'
- .OH '\fBX Toolkit Intrinsics\fP''\fBX11 Release \*(Rn\fP'
- .EF ''\fB % \fP''
- .OF ''\fB % \fP''
-