Bug 154445 [Wizards] Incomplete javadoc for WizardNewProjectCreationClass.getProjectHandle
This method return systematically the handle of the project relative to the workspace root. However, a user could expect to get the handle of the project taking the path specified in the page into account. This should be explained in the javadoc or the method should be changed...
bundles/org.eclipse.ui.ide/extensions/org/eclipse/ui/dialogs/WizardNewProjectCreationPage.java
if (!locationArea.isDefault()) {
            IStatus locationStatus = workspace.validateProjectLocationURI(handle,
                    locationArea.getProjectLocationURI());
            if (!locationStatus.isOK()) {
                setErrorMessage(locationStatus.getMessage());
                return false;
            }
        }
        setErrorMessage(null);
        setMessage(null);
        return true;
    }
    /*
     * see @DialogPage.setVisible(boolean)
     */
    public void setVisible(boolean visible) {
        super.setVisible(visible);
        if (visible) {
			projectNameField.setFocus();
		}
    }
    /**
     * Returns the useDefaults.
     * @return boolean
     */
    public boolean useDefaults() {
        return locationArea.isDefault();
    }
}