Customer's detailed description:

All problems listed here are based on the assumption that a window's
dialogs should always appear on top of the window, never behind it. It
is up to the window manager to enforce this behavior.

So, compile the sample program (with production JDK 1.1.6). run it and
then try out these three test cases:

Case 1:
Execute the window manager action to bring Frame1 to the
front. On my CDE environment, clicking on the title bar does
this. The frame appears in front of the dialog. The dialog is
also raised, but just under the frame. I would think this is a
dtwm bug.

Case 2:
Use the menu bar in Frame2 to execute File/Frame 1 To Front.
The frame appears in front of the dialog. Again, the dialog is
also raised, but just under the frame. I list this separate
from case 1 since Fvwm95 (an alternate window manager) behaves
correctly in case 1 but fails case 2.

Case 3:
Iconify Frame1 using the proper window manager command. The
frame and dialog both disappear (this is correct). Now,
de-iconify Frame1, using the menu function in Frame2. Frame1
re-appears, but the dialog is now gone and there appears to be
no way to get it back.

******************************************************************************

import java.awt.*;
import java.awt.event.*;

class Main
implements ActionListener
{

Frame frame1;
Frame frame2;
Dialog dialog;

public static void
main(
String[] args)
{
new Main();
}

Main()
{
// Frame 1
frame1 = new Frame();
frame1.setSize(400, 200);
frame1.setLocation(400, 400);
frame1.setTitle("Frame 1");

frame1.setVisible(true);

// Frame 2

frame2 = new Frame();
frame2.setSize(400, 200);
frame2.setLocation(350, 350);
frame2.setTitle("Frame 2");

MenuBar menuBar = new MenuBar();
frame2.setMenuBar(menuBar);
Menu file = new Menu("File");
menuBar.add(file);
MenuItem item = new MenuItem("Frame 1 To Front");
file.add(item);
item.addActionListener(this);
item = new MenuItem("De-Iconify Frame 1");
file.add(item);
item.addActionListener(this);

frame2.setVisible(true);

// Dialog on Frame 1

dialog = new Dialog(frame1);
//dialog.setModal(true);
dialog.setSize(100, 200);
dialog.setLocation(500, 500);
dialog.setTitle("Dialog");
dialog.setVisible(true);
}
public void
actionPerformed(
ActionEvent e)
{
if ("Frame 1 To Front".equals(e.getActionCommand())) {
frame1.toFront();
}
else {
frame1.setVisible(false);
frame1.setVisible(true);
}
}

}
******************************************************************************