home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Source Code 1993 July / THE_SOURCE_CODE_CD_ROM.iso / X / mit / doc / Xt / Xtk.intr.front < prev    next >
Encoding:
Text File  |  1991-08-27  |  7.7 KB  |  267 lines

  1. .\" $XConsortium: Xtk.intr.front,v 1.6 91/08/26 20:34:33 swick Exp $
  2. .\" MIT header page and copyright notice
  3. .\" MIT page header and footers
  4. .\"
  5. .EH ''''
  6. .OH ''''
  7. .EF ''''
  8. .OF ''''
  9. .ps 11
  10. .nr PS 11
  11. \&
  12. .sp 8
  13. .ce 4
  14. \s+2\fB\*(xT\fP\s-2
  15.  
  16. \s+1\fBX Window System\fP\s-1
  17.  
  18. \s+1\fBX Version 11, Release \*(Rn\fP\s-1
  19.  
  20.  
  21. First Revision - August, 1991
  22. .sp 5
  23. .ce 4
  24. \s-1Joel McCormack
  25. .sp 6p
  26. Digital Equipment Corporation
  27. Western Software Laboratory
  28. .sp 2
  29. .ce 4
  30. Paul Asente
  31. .sp 6p
  32. Digital Equipment Corporation
  33. Western Software Laboratory
  34. .sp 2
  35. .ce 4
  36. Ralph R. Swick
  37. .sp 6p
  38. Digital Equipment Corporation
  39. External Research Group
  40. MIT X Consortium\s+1
  41. .bp
  42. \&
  43. .ps 9
  44. .nr PS 9
  45. .sp 8
  46. .LP
  47. The X Window System is a trademark of MIT.
  48. .LP
  49. Copyright \(co 1985, 1986, 1987, 1988, 1991
  50. Massachusetts Institute of Technology, Cambridge, Massachusetts,
  51. and Digital Equipment Corporation, Maynard, Massachusetts.
  52. .LP
  53. Permission to use, copy, modify and distribute this documentation for any
  54. purpose and without fee is hereby granted, provided that the above copyright
  55. notice appears in all copies and that both that copyright notice and this
  56. permission notice appear in supporting documentation, and that the name of
  57. M.I.T. or Digital not be used in in advertising or publicity pertaining
  58. to distribution of the software without specific, written prior permission.
  59. M.I.T and Digital makes no representations about the suitability of the
  60. software described herein for any purpose.
  61. It is provided ``as is'' without express or implied warranty.
  62. .ps 11
  63. .nr PS 11
  64. .bp iii
  65. .XS iii
  66. Acknowledgments
  67. .XE
  68. \&
  69. .sp 1
  70. .ce 3
  71. \s+1\fBAcknowledgments\fP\s-1
  72. .sp 2
  73. .na
  74. .LP
  75. The design of the X11 Intrinsics was done primarily 
  76. by Joel McCormack of Digital WSL. 
  77. Major contributions to the design and implementation also
  78. were done by Charles Haynes, Mike Chow, and Paul Asente of Digital WSL.
  79. Additional contributors to the design and/or implementation were:
  80. .LP
  81. .Ds
  82. Loretta Guarino-Reid (Digital WSL)
  83. Rich Hyde (Digital WSL)
  84. Susan Angebranndt (Digital WSL)
  85. Terry Weissman (Digital WSL)
  86. Mary Larson (Digital UEG)
  87. Mark Manasse (Digital SRC)
  88. Jim Gettys  (Digital SRC)
  89. Ralph Swick (Project Athena and Digital ERP) 
  90. Leo Treggiari  (Digital SDT)
  91. Ron Newman (Project Athena)
  92. Mark Ackerman (Project Athena)
  93. Bob Scheifler (MIT LCS)
  94. .De
  95. .LP
  96. The contributors to the X10 toolkit also deserve mention.
  97. Although the X11 Intrinsics present an entirely different programming style, 
  98. they borrow heavily from the implicit and explicit concepts in the X10 
  99. toolkit.
  100. .LP
  101. The design and implementation of the X10 Intrinsics were done by:
  102. .LP
  103. .Ds
  104. Terry Weissman (Digital WSL)
  105. Smokey Wallace (Digital WSL)
  106. Phil Karlton (Digital WSL)
  107. Charles Haynes (Digital WSL)
  108. Frank Hall (HP)
  109. .De
  110. .LP
  111. The design and implementation of the X10 toolkit's sample widgets were 
  112. by the above, as well as by:
  113. .LP
  114. .Ds
  115. Ram Rao (Digital UEG)
  116. Mary Larson (Digital UEG)
  117. Mike Gancarz (Digital UEG)
  118. Kathleen Langone  (Digital UEG)
  119. .De
  120. These widgets provided a checklist of requirements that we
  121. had to address in the X11 intrinsics.
  122. .LP
  123. Thanks go to Al Mento of Digital's UEG Documentation Group for 
  124. formatting and generally improving this document
  125. and to John Ousterhout of Berkeley for extensively reviewing 
  126. early drafts of it.
  127. .LP
  128. Finally, a special thanks to Mike Chow,
  129. whose extensive performance analysis of the X10 toolkit provided
  130. the justification to redesign it entirely for X11.
  131. .LP
  132. .sp
  133. .Ds 0
  134. Joel McCormack
  135. Western Software Laboratory
  136. Digital Equipment Corporation
  137.  
  138. March, 1988
  139. .De
  140. .bp
  141. .LP
  142. The current design of the \*(xI has benefited greatly from the
  143. input of several dedicated reviewers in the membership of the
  144. X Consortium.
  145. In addition to those already mentioned,
  146. the following individuals have dedicated significant time
  147. to suggesting improvements to the \*(xI:
  148. .LP
  149. .Ds
  150. .ta 3i
  151. Steve Pitschke (Stellar)    C. Doug Blewett (AT&T)
  152. Bob Miller (HP)    David Schiferl (Tektronix)
  153. Fred Taft (HP)    Michael Squires (Sequent)
  154. Marcel Meth (AT&T)    Jim Fulton (MIT)
  155. Mike Collins (Digital)    Kerry Kimbrough (Texas Instruments)
  156. Scott McGregor (Digital)    Phil Karlton (Digital)
  157. Julian Payne (ESS)    Jacques Davy (Bull)
  158. Gabriel Beged-Dov (HP)    Glenn Widener (Tektronix)
  159. .De
  160. .LP
  161. Thanks go to each of them for the countless hours spent
  162. reviewing drafts and code.
  163. .LP
  164. .sp
  165. .Ds 0
  166. Ralph R. Swick
  167. External Research Group
  168. Digital Equipment Corporation
  169. MIT Project Athena
  170.  
  171. June, 1988
  172. .sp
  173. .LP
  174. From Release 3 to Release 4, several new members joined the design
  175. team.  We greatly appreciate the thoughtful comments, suggestions,
  176. lengthy discussions, and in some cases implementation code contributed by each
  177. of the following:
  178. .LP
  179. .Ds
  180. .ta 3i
  181. Don Alecci (AT&T)    Ellis Cohen (OSF)
  182. Donna Converse (MIT)    Clive Feather (IXI)
  183. Nayeem Islam (Sun)    Dana Laursen (HP)
  184. Keith Packard (MIT)    Chris Peterson (MIT)
  185. Richard Probst (Sun)    Larry Cable (Sun)
  186. .De
  187. .sp
  188. .LP
  189. In Release 5, the effort to define the internationalization additions was
  190. headed by Bill McMahon of Hewlett Packard and Frank Rojas of IBM.  This
  191. has been an educational process for many of us and Bill and Frank's
  192. tutelage has carried us through.  Vania Joloboff of the OSF also contributed
  193. to the internationalization additions.  The implementation efforts of
  194. Bill, Gabe Beged-Dov, and especially Donna Converse for this release
  195. are also gratefully acknowledged.
  196. .sp
  197. .Ds 0
  198. Ralph R. Swick
  199.  
  200. December, 1989
  201. and
  202. July, 1991
  203. .De
  204. .bp iv
  205. .XS iv
  206. About This Manual
  207. .XE
  208. \&
  209. .sp 1
  210. .ce 3
  211. \s+1\fBAbout This Manual\fP\s-1
  212. .sp 2
  213. .na
  214. .LP
  215. \fI\*(xT\fP is intended to be read by both application programmers who will
  216. use one or more of the many widget sets built with the \*(xI 
  217. and by widget programmers who will use the \*(xI to build widgets 
  218. for one of the widget sets.
  219. Not all the information in this manual, however, applies to both audiences.
  220. That is, because the application programmer is likely to use only a number of
  221. the \*(xI functions in writing an application and because the widget programmer
  222. is is likely to use many more, if not all, of the \*(xI functions in building 
  223. a widget,
  224. an attempt has been made to highlight those areas of information that are
  225. deemed to be of special interest for the application programmer.
  226. (It is assumed the widget programmer will have to be familiar with all 
  227. the information.)
  228. Therefore, all entries in the table of contents that are printed in \fBbold\fP 
  229. indicate the information that should be of special interest to an 
  230. application programmer.
  231. .LP
  232. It is also assumed that as application programmers become more familiar with the
  233. concepts discussed in this manual they will find it more convenient to implement
  234. portions of their applications as special-purpose or custom widgets.
  235. It is possible, none the less, to use widgets without knowing how to build them.
  236. .SH
  237. Conventions Used in this Manual
  238. .LP
  239. This document uses the following conventions:
  240. .IP \(bu 5
  241. Global symbols are printed in
  242. .PN this
  243. .PN special
  244. .PN font .
  245. These can be either function names,
  246. symbols defined in include files, data types, or structure names.
  247. Arguments to functions, procedures, or macros are printed in \fIitalics\fP.
  248. .IP \(bu 5
  249. Each function is introduced by a general discussion that
  250. distinguishes it from other functions.
  251. The function declaration itself follows,
  252. and each argument is specifically explained.
  253. General discussion of the function, if any is required,
  254. follows the arguments.
  255. .IP \(bu 5
  256. To eliminate any ambiguity between those arguments that you pass and those that
  257. a function returns to you,
  258. the explanations for all arguments that you pass start with the word
  259. \fIspecifies\fP or, in the case of multiple arguments, the word \fIspecify\fP.
  260. The explanations for all arguments that are returned to you start with the
  261. word \fIreturns\fP or, in the case of multiple arguments, the word \fIreturn\^\fP.
  262. .bp 1
  263. .EH '\fBX Toolkit Intrinsics\fP''\fBX11 Release \*(Rn\fP'
  264. .OH '\fBX Toolkit Intrinsics\fP''\fBX11 Release \*(Rn\fP'
  265. .EF ''\fB % \fP''
  266. .OF ''\fB % \fP''
  267.