{ -----------------------------------------------------------------------------

                                 NOTICE:

      THESE MATERIALS are UNSUPPORTED by OSS!  If you do not understand how to
      use them do not contact OSS for help!  We will not teach you how to 
      program in Pascal.  If you find an error in these materials, feel free
      to SEND US A LETTER explaining the error, and how to fix it.

      THE BOTTOM LINE:

         Use it, enjoy it, but you are on your own when using these materials!


                               DISCLAIMER:

      OSS makes no representations or warranties with respect to the contents
      hereof and specifically disclaim all warranties of merchantability or
      fitness for any particular purpose.   This document is subject to change
      without notice.
      
      OSS provides these materials for use with Personal Pascal.  Use them in
      any way you wish.

   -------------------------------------------------------------------------- }


          Using Do_Dialog Without Editable Text Fields

                       September 29, 1986


The   Personal  Pascal  Manual  is  somewhat  misleading  in   its 
description of the Do_Dialog function (page 5-34).   In the second 
paragraph, the manual states:

"The second parameter is only significant if the box contains  one 
or more editable text fields.   If so,  then it specifies the item 
number of an editable field, and the text cursor will be placed in 
that field when the dialog is executed."

This  is  quite true,  but leads you to believe  that  the  second 
parameter  is ignored if there are no editable text fields in  the 
box.   This is not true!  If you have no editable text fields in a 
dialog box, use the value 0!  If you pass any other value, the GEM 
operating  system  will "hang up" the computer,  or  cause  a  Bus 
Error.   This also applies to using a dummy variable as the second 
parameter.   If  you  use  a dummy  variable,  the  value  is  NOT 
guaranteed to be zero.

If  you  have  been experiencing unexplained  system  hang-ups  or 
crashes  when accessing dialog boxes with no editable  text,  this 
is almost certainly the problem.