NAME 
        CloseWorkBench -- Closes the Workbench screen.

    SYNOPSIS 
        Success = CloseWorkBench()
        D0

        long closeworkbench( void );

    FUNCTION 
        This routine attempts to close the Workbench screen:
       -   Test whether or not any applications have opened windows on the
           Workbench, and return FALSE if so.  Otherwise ...
       -   Clean up all special buffers
       -   close the workbench screen
       -   Make the Workbench program mostly inactive (it will still
           monitor disk activity)
       -   Return TRUE

    INPUTS 
        None

    RESULT 
        TRUE if the Workbench screen closed successfully
        FALSE if the Workbench was not open, or if it has windows
            open which are not Workbench drawers.

   NOTES
        This routine has been drastically rewritten for V36.
        It is much more solid, although we haven't eliminated
        all the problem cases yet.

    BUGS 
        The name of this function is improperly spelled.  It ought
        to have been CloseWorkbench().

        It might be more convenient to have it return TRUE if the
        Workbench wasn't opened when called.  The idea as it is now
        is probably this: if you want to free up the memory of the
        Workbench screen when your program begins, you can call
        CloseWorkBench().  The return value of that call indicates
        whether you should call openworkbench() when your program
        exits: if FALSE, that means either the the Workbench existed
        but you could not close it, or that it wasn't around to
        begin with, and you should not try to re-open it.

        We would prefer that you provide a user selection to attempt
        to open or close the Workbench screen from within your application,
        rather than your making assumptions like these.

    SEE ALSO 
        openworkbench()