Index: OpenProjects.java =================================================================== RCS file: /cvs/projects/projectuiapi/src/org/netbeans/api/project/ui/OpenProjects.java,v retrieving revision 1.4 diff -u -r1.4 OpenProjects.java --- OpenProjects.java 23 Jun 2004 18:12:01 -0000 1.4 +++ OpenProjects.java 14 Dec 2004 17:37:53 -0000 @@ -67,7 +67,41 @@ public Project[] getOpenProjects() { return trampoline.getOpenProjectsAPI(); } - + + /** + * Opens given projects. + * Acquires {@link org.netbeans.api.project.ProjectManager#mutex()} in the write mode. + * @param projects to be opened. In the case when some of the projects are already opened + * these projects are not opened again. If the projects contain duplicates, the duplicated + * projects are opened just once. + * @param openSubprojects if true also subprojects are opened. + * @since org.netbeans.modules.projectuiapi/0 1.2 + *
+ * This method is designed for use by logical view's Libraries Node to open one or more of dependent
+ * projects. This method can be used also by other project GUI components which need to open certain
+ * project(s), eg. code generation wizards.
+ * The method should not be used for opening newly created project, insted the
+ * {@link org.openide.WizardDescriptor.InstantiatingIterator#instantiate()} used for creation of new project
+ * should return the project directory.
+ * The method should not be also used to provide a GUI to open subprojects.
+ * The {@link org.netbeans.spi.project.ui.support.CommonProjectActions#openSubprojectsAction()} should be used
+ * instead.
+ *