hpux man page for xtnextevent

XtNextEvent()															     XtNextEvent()

Name
  XtNextEvent - return next event from input queue.

Synopsis
  void XtNextEvent(event_return)
	 XEvent *event_return;

Inputs
  None.

Outputs
  event_return
	      Returns the dequeued event structure.

Availability
  XtNextEvent() has been superseded by XtAppNextEvent().

Description
  XtNextEvent()  returns the next event on the input queue.  If no events are pending, it flushes the output buffer and blocks.  It also dis-
  patches timer and alternate input callbacks and calls any work procedures that have been registered with XtAddWorkProc().

Usage
  XtNextEvent() has been superseded by XtAppNextEvent(), which performs the same function on a per-application context basis.	XtNextEvent()
  now  calls XtAppNextEvent() passing the default application context created by XtInitialize().  Very few programs need multiple application
  contexts, and you can continue to use XtNextEvent() if you initialize your application with XtInitialize().  We  recommend,  however,  that
  you use XtAppInitialize(), XtAppNextEvent(), and the other XtApp*() application context specific functions.

  See XtAppNextEvent() for more information.

See Also
  XtAppNextEvent(1).

Xt - Event Handling														     XtNextEvent()