adding preface.xmlInitial-Conversion

2 files changed, 253 insertions, 40 deletions

diff --git a/specs/intrinsics.xml b/specs/intrinsics.xml
index 885358c..b95e516 100644
--- a/specs/intrinsics.xml
+++ b/specs/intrinsics.xml
@@ -6,47 +6,100 @@
 
 
 <book id="intrinsics" lang="en">
-<!-- .\" $Xorg: CH01,v 1.3 2000/08/17 19:42:42 cpqbld Exp $ -->
-<!-- .\" Copyright \(co 1985, 1986, 1987, 1988, 1991, 1994 -->
-<!-- .\" X Consortium -->
-<!-- .\" -->
-<!-- .\" Permission is hereby granted, free of charge, to any person obtaining -->
-<!-- .\" a copy of this software and associated documentation files (the -->
-<!-- .\" "Software"), to deal in the Software without restriction, including -->
-<!-- .\" without limitation the rights to use, copy, modify, merge, publish, -->
-<!-- .\" distribute, sublicense, and/or sell copies of the Software, and to -->
-<!-- .\" permit persons to whom the Software is furnished to do so, subject to -->
-<!-- .\" the following conditions: -->
-<!-- .\" -->
-<!-- .\" The above copyright notice and this permission notice shall be included -->
-<!-- .\" in all copies or substantial portions of the Software. -->
-<!-- .\" -->
-<!-- .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS -->
-<!-- .\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF -->
-<!-- .\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. -->
-<!-- .\" IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR -->
-<!-- .\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, -->
-<!-- .\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -->
-<!-- .\" OTHER DEALINGS IN THE SOFTWARE. -->
-<!-- .\" -->
-<!-- .\" 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. -->
-<!-- .\" -->
-<!-- .\" Copyright \(co 1985, 1986, 1987, 1988, 1991, 1994 -->
-<!-- .\" Digital Equipment Corporation, Maynard, Massachusetts. -->
-<!-- .\" -->
-<!-- .\" Permission to use, copy, modify and distribute this documentation for any -->
-<!-- .\" purpose and without fee is hereby granted, provided that the above copyright -->
-<!-- .\" notice appears in all copies and that both that copyright notice and this -->
-<!-- .\" permission notice appear in supporting documentation, and that the name of -->
-<!-- .\" Digital not be used in in advertising or publicity pertaining -->
-<!-- .\" to distribution of the software without specific, written prior permission. -->
-<!-- .\" Digital makes no representations about the suitability of the -->
-<!-- .\" software described herein for any purpose. -->
-<!-- .\" It is provided ``as is'' without express or implied warranty. -->
+<bookinfo>
+   <title>X Toolkit Intrinsics - C Language Interface</title>
+   <subtitle>X Window System</subtitle>
+   <releaseinfo>X Version 11, Release &fullrelvers;</releaseinfo>
+   <printhistory><para>First Revision - April, 1994</para></printhistory>
+   <authorgroup>
+      <author>
+         <firstname>Joel</firstname><surname>McCormack</surname>
+         <affiliation>
+           <orgname>Digital Equipment Corporation</orgname>
+           <orgdiv>Western Software Laboratory</orgdiv>
+         </affiliation>
+      </author>
+      <author>
+         <firstname>Paul</firstname><surname>Asente</surname>
+         <affiliation>
+           <orgname>Digital Equipment Corporation</orgname>
+           <orgdiv>Western Software Laboratory</orgdiv>
+         </affiliation>
+      </author>
+      <author>
+         <firstname>Ralph</firstname><othername>R.</othername>
+         <surname>Swick</surname>
+         <affiliation>
+           <orgname>Digital Equipment Corporation</orgname>
+           <orgdiv>External Research Group</orgdiv>
+           <!-- <orgname>MIT X Consortium</orgname> -->
+         </affiliation>
+      </author>
+   </authorgroup>
+   <printhistory><para>version 6 edited by Donna Converse X Consortium, Inc.</para></printhistory>
 
+<legalnotice>
+<para>XWindow System is a trademark of X Consortium, Inc.</para>
+
+<para role="multiLicensing">
+Copyright © 1985, 1986, 1987, 1988, 1991, 1994 X Consortium
+</para>
+
+<para>
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+</para>
+
+<para>
+The above copyright notice and this permission notice shall be included
+in all copies or substantial portions of the Software.
+</para>
+
+<para> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+</para>
+
+<para>
+Except as contained in this notice, the name of the X Consortium shall
+not be used in advertising or otherwise to promote the sale, use or
+other dealings in this Software without prior written authorization
+from the X Consortium.
+</para>
+</legalnotice>
+
+<legalnotice>
+<para role="multiLicensing">
+Copyright © 1985, 1986, 1987, 1988, 1991, 1994
+Digital Equipment Corporation, Maynard, Massachusetts.
+</para>
+
+<para>
+Permission to use, copy, modify and distribute this documentation for any
+purpose and without fee is hereby granted, provided that the above copyright
+notice appears in all copies and that both that copyright notice and this
+permission notice appear in supporting documentation, and that the name of
+Digital not be used in in advertising or publicity pertaining
+to distribution of the software without specific, written prior permission.
+Digital makes no representations about the suitability of the
+software described herein for any purpose.
+It is provided "as is" without express or implied warranty.
+</para>
+
+</legalnotice>
+</bookinfo>
+
+
+<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"  href="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"/>
diff --git a/specs/preface.xml b/specs/preface.xml
new file mode 100644
index 0000000..0753174
--- /dev/null
+++ b/specs/preface.xml
@@ -0,0 +1,160 @@
+<preface>
+<title>Acknowledgments</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>
+
+<literallayout>
+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)
+</literallayout>
+
+<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>
+
+<literallayout>
+Terry Weissman (Digital WSL)
+Smokey Wallace (Digital WSL)
+Phil Karlton (Digital WSL)
+Charles Haynes (Digital WSL)
+Frank Hall (HP)
+</literallayout>
+
+<para>
+The design and implementation of the X10 toolkit’s sample widgets were by the above, as well as
+by:
+</para>
+
+<literallayout>
+Ram Rao (Digital UEG)
+Mary Larson (Digital UEG)
+Mike Gancarz (Digital UEG)
+Kathleen Langone (Digital UEG)
+</literallayout>
+
+<para>
+These widgets provided a checklist of requirements that we had to address in the X11 Intrinsics.
+</para>
+<para>
+Thanks go to Al Mento of Digital’s UEG Documentation Group for formatting and generally
+improving this document and to John Ousterhout of Berkeley for extensively reviewing early
+drafts of it.
+</para>
+<para>
+Finally, a special thanks to Mike Chow, whose extensive performance analysis of the X10 toolkit
+provided the justification to redesign it entirely for X11.
+</para>
+
+<para>Joel McCormack</para>
+<para>Western Software Laboratory</para>
+<para>Digital Equipment Corporation</para>
+<para>March 1988</para>
+
+
+
+<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>
+
+<literallayout>
+Steve Pitschke (Stellar)       C.Doug Blewett (AT&amp;T)
+Bob Miller (HP)                David Schiferl (Tektronix
+Fred Taft (HP)                 Michael Squires (Sequent)
+Marcel Meth (AT&amp;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)
+</literallayout>
+
+<para>
+Thanks go to each of them for the countless hours spent reviewing drafts and code.
+</para>
+
+<para>Ralph R. Swick</para>
+<para>External Research Group</para>
+<para>Digital Equipment Corporation</para>
+<para>MIT Project Athena</para>
+<para>June 1988</para>
+
+<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>
+
+<literallayout>
+Don Alecci (AT&amp;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)
+</literallayout>
+
+<para>
+In Release 5, the effort to define the internationalization additions was headed by Bill McMahon
+of Hewlett Packard and Frank Rojas of IBM. This has been an educational process for many of
+us, and Bill and Frank’s tutelage has carried us through. Vania Joloboff of the OSF also contributed
+to the internationalization additions. The implementation efforts of Bill, Gabe Beged-Dov,
+and especially Donna Converse for this release are also gratefully acknowledged.
+</para>
+
+<literallayout>
+Ralph R. Swick
+December 1989
+and
+July 1991
+</literallayout>
+
+<para>
+The Release 6 Intrinsics is a result of the collaborative efforts of participants in the X Consortium’s
+intrinsics working group. A few individuals contributed substantial design proposals, participated
+in lengthy discussions, reviewed final specifications, and in most cases, were also
+responsible for sections of the implementation. They deserve recognition and thanks for their
+major contributions:
+</para>
+
+<literallayout>
+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)
+</literallayout>
+
+<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>
+</preface>