How exactly does the modal variable in Java Dialogs work?

In the JavaDocs for Dialog(Dialog,String,modal) it says the following:

modal - if true, dialog blocks input to other app windows when shown

If I understand correctly, if I pass a true argument to the constructor of a Dialog, will it just pause all the program until the user gives some kind of input to the application using this dialog?

For example suppose that we have this function in a class and a JDialog called test.

 public void function(){

  /*line*/   test t = new test(null, true); 

             while(true){
             System.out.println("print stuff");
        }
     }

If I call this function, it will pause, at line, then since the initial dialog is empty, if for example I close the dialog, then the while loop will be executed.

Is the phrase "the program pauses until the user gives an input 开发者_JAVA百科using the dialog" is a somewhat correct description of what the modal variable is useful for?

---

Its partially correct, but.

But it isn't enough to call teh constructor, but you need to show the dialog after the constructor like this:

t.setVisible(true);

and yes, after this, the while loop does not start till the dialog isn't closed ( setVisible(false) )