/* $DOC$
   $NAME$
      ft_IAmIdle()
   $CATEGORY$
      DOS/BIOS
   $ONELINER$
      Inform the operating system that the application is idle.
   $SYNTAX$
      ft_IAmIdle() -> lSuccess
   $ARGUMENTS$
      None
   $RETURNS$
      .T. if supported, .F. otherwise.
   $DESCRIPTION$
      Some multitasking operating environments (e.g. Windows or OS/2) can
      function more efficiently when applications release the CPU during
      idle states.  This function allows you "announce" to the operating
      system that your application is idle.

      Note that if you use this function in conjunction with ft_OnIdle(),
      you can cause Clipper to automatically release the CPU whenever
      Clipper itself detects an idle state.
   $EXAMPLES$
      DO WHILE Inkey() != K_ESC
         ft_IAmIdle()         // Wait for ESC and announce idleness
      ENDDO

      // Here's another way to do it:

      ft_OnIdle( {|| ft_IAmIdle() } )

      Inkey( 0 )              // Automatically reports idleness until key is pressed!
   $SEEALSO$
      ft_OnIdle()
   $END$
 */
