src/share/classes/java/awt/FileDialog.java

@@ -1,7 +1,7 @@
 /*
- * Copyright (c) 1995, 2010, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1995, 2013, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
  * under the terms of the GNU General Public License version 2 only, as
  * published by the Free Software Foundation.  Oracle designates this

@@ -455,13 +455,18 @@
     /**
      * Sets the selected file for this file dialog window to be the
      * specified file. This file becomes the default file if it is set
      * before the file dialog window is first shown.
      * <p>
+     * The file could be highlighted or its name could be entered depending on
+     * native file dialog implementation.
+     * <p>
+     * This method accepts full path or file name with extension when used
+     * together with <code>setDirectory()</code> method.
+     * <p>
      * Specifying "" as the file is exactly equivalent to specifying
-     * <code>null</code>
-     * as the file.
+     * <code>null</code> as the file.
      *
      * @param    file   the file being set
      * @see      #getFile
      * @see      #getFiles
      */