REF XT_R2COMPAT                                     Adrian Howard Jun 91

       COPYRIGHT University of Sussex 1990. All Rights Reserved.

>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
<<<<<<<<<<<<<<<<<<<<<                             >>>>>>>>>>>>>>>>>>>>>>
<<<<<<<<<<<<<<<<<<<<<   COMPATIBILITY FUNCTIONS   >>>>>>>>>>>>>>>>>>>>>>
<<<<<<<<<<<<<<<<<<<<< WITH OLD X-TOOLKIT VERSIONS >>>>>>>>>>>>>>>>>>>>>>
<<<<<<<<<<<<<<<<<<<<<                             >>>>>>>>>>>>>>>>>>>>>>
<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

This REF file  details the procedures  that are suplied  by the  library
packages LIB * FAST_XT_R2COMPAT and  LIB * XT_R2COMPAT. These  libraries
provide a Pop-11 interface to several convenience functions provided  by
X11R4 to  help people  converting programs  from older  versions of  the
X-Toolkit.

         CONTENTS - (Use <ENTER> g to access required sections)

  1   Introduction

  2   LIB XT_R2COMPAT

  3   LIB FAST_XT_R2COMPAT



---------------
1  Introduction
---------------

The  exact  structure  of  arguments  and  results  for  the   following
procedures is as discussed in REF * XTOOLKIT.

For more details see section Appendix C of:

               X Toolkit Intrinsics - C Language Interface
                             X Window System
                         X Version 11, Release 4

        Copyright (C)  1985,  1986,  1987,  1988,  Massachusetts
        Institute of Technology,  Cambridge, Massachusetts,  and
        Digital Equipment Corporation, Maynard, Massachusetts.




------------------
2  LIB XT_R2COMPAT
------------------

XtInitialize(shell_name_string, app_class_string,            [procedure]
             options, num_options, argc_ptr, argv) -> widget
        Initialize the toolkit,  create a  default application  context,
        open a display and create an application shell.


XtCreateApplicationShell(name, widgetclass, args, num)       [procedure]
        Create and  initialize an  application  shell with  the  default
        application context.


XtMainLoop()                                                 [procedure]
        Infinite loop which repeatedly performs XtNextEvent followed  by
        XtDispatchEvent.


XtNextEvent(xeventptr_return)                                [procedure]
        Process an event.


XtProcessEvent(inputmask)                                    [procedure]
        Process single input event, timeout or alternate input source.


XtPeekEvent(xeventptr_return) -> bool                        [procedure]
        Look at an event on the queue.


XtPending() -> bool                                          [procedure]
        Check for pending events.


XtAddInput(src, condition, inputcallbackproc, data)          [procedure]
            -> inputid
        Register  a  new  source  of  events  with  default  application
        context.


XtAddTimeout(interval_int, timercallbackproc, data)          [procedure]
            -> intervalid
        Create a timeout in the default application context.


XtDestroyGC(widget, gc)                                      [procedure]
        Remove a shared graphics context.




-----------------------
3  LIB FAST_XT_R2COMPAT
-----------------------

fast_XtInitialize(shell_name_string, app_class_string,       [procedure]
             options, num_options, argc_ptr, argv) -> widget
fast_XtCreateApplicationShell(name, widgetclass, args, num)  [procedure]
fast_XtMainLoop()                                            [procedure]
fast_XtNextEvent(xeventptr_return)                           [procedure]
fast_XtProcessEvent(inputmask)                               [procedure]
fast_XtPeekEvent(xeventptr_return) -> bool                   [procedure]
fast_XtPending() -> bool                                     [procedure]
fast_XtAddInput(src, condition, inputcallbackproc, data)     [procedure]
            -> inputid
fast_XtAddTimeout(interval_int, timercallbackproc, data)     [procedure]
            -> intervalid
fast_XtDestroyGC(widget, gc)                                 [procedure]
        As for the procedures  in LIB * XT_R2COMPAT, but without  checks
        for valid arguments.  These procedures  should only  be used  in
        fully debugged programs. See REF * XTOOLKIT for full details  of
        the Poplog X  naming conventions for  non-checking and  checking
        procedures.



--- C.x/x/pop/ref/xt_r2compat
--- Copyright University of Sussex 1990. All rights reserved.
