/* $DOC$ $NAME$ ft_Pending() $CATEGORY$ Menus/Prompts $ONELINER$ Display same-line pending messages after a wait. $SYNTAX$ ft_Pending( , [ ], [ ], ; [ ], [ ] ) -> NIL $ARGUMENTS$ is the message string to display. is an optional screen row for message display, default row 24. is an optional screen col for message display, default col 0. is an optional wait (sec) between messages, default 5 sec. is an optional color string for displayed messages, default is white text over red background. $RETURNS$ NIL $DESCRIPTION$ A good way to display information messages during the running of an application is to send them all to the SAME line on the screen where users are expected to look for them. In order to give users a chance to read the current message before the next one is displayed we may need to insert a delay after each message. ft_Pending() function displays messages by keeping track of the time of the last message and providing a delay ONLY if the next pending message is issued much too soon after the current one. $EXAMPLES$ ft_Pending( "Message one", 20, 0, 3, "W+/G" ) // Displays "Message one." // sets row to 20, col to 0. // wait to 3 and color to // bright white over green. ft_Pending( "Message two" ) // Displays "Message two", after 5 sec. ft_Pending( "Message three" ) // Displays "Message three", after 5 sec. // Note that default row, col, wait time and color need to be set only // once in the very first call to ft_Pending() and only if the internal // default values are not appropriate. $END$ */