*** doc/MainLoop.3.orig	Sun Jan 16 14:35:05 2000
--- doc/MainLoop.3	Sun Jan 16 14:35:05 2000
***************
*** 0 ****
--- 1,33 ----
+ '\"
+ '\" Copyright (c) 1990-1992 The Regents of the University of California.
+ '\" Copyright (c) 1994-1996 Sun Microsystems, Inc.
+ '\"
+ '\" See the file "license.terms" for information on usage and redistribution
+ '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
+ '\" 
+ '\" SCCS: @(#) MainLoop.3 1.3 96/03/26 18:15:01
+ '\" 
+ .so man.macros
+ .TH Tcl_MainLoop 3 "" Tcl "Tcl Library Procedures"
+ .BS
+ .SH NAME
+ Tcl_MainLoop \- loop for events until there is no more work to do.
+ .SH SYNOPSIS
+ .nf
+ \fB#include <tcl.h>\fR
+ .sp
+ \fBTcl_MainLoop\fR()
+ .BE
+ 
+ .SH DESCRIPTION
+ .PP
+ \fBTcl_MainLoop\fR is a procedure that loops repeatedly calling
+ \fBTcl_DoOneEvent\fR.  It returns only when there is no work to
+ be done any more (i.e. no main windows exist anymore).  Any
+ application that consists entirely of callbacks invoked via
+ \fBTcl_DoOneEvent\fR only has to call \fBTcl_MainLoop\fR after
+ initialization. The notifier will take care that the application
+ exits automatically when there is nothing to be done any more.
+ 
+ .SH KEYWORDS
+ application, event, main loop
