Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.
View | Details | Raw Unified | Return to bug 297478
Collapse All | Expand All

(-)src/org/eclipse/core/resources/IFile.java (-1 / +3 lines)
Lines 1-5 Link Here
1
/*******************************************************************************
1
/*******************************************************************************
2
 *  Copyright (c) 2000, 2009 IBM Corporation and others.
2
 *  Copyright (c) 2000, 2010 IBM Corporation and others.
3
 *  All rights reserved. This program and the accompanying materials
3
 *  All rights reserved. This program and the accompanying materials
4
 *  are made available under the terms of the Eclipse Public License v1.0
4
 *  are made available under the terms of the Eclipse Public License v1.0
5
 *  which accompanies this distribution, and is available at
5
 *  which accompanies this distribution, and is available at
Lines 240-245 Link Here
240
	 * <ul>
240
	 * <ul>
241
	 * <li> This resource already exists in the workspace.</li>
241
	 * <li> This resource already exists in the workspace.</li>
242
	 * <li> The parent of this resource does not exist.</li>
242
	 * <li> The parent of this resource does not exist.</li>
243
	 * <li> The parent of this resource is a virtual folder.</li>
243
	 * <li> The project of this resource is not accessible.</li>
244
	 * <li> The project of this resource is not accessible.</li>
244
	 * <li> The parent contains a resource of a different type 
245
	 * <li> The parent contains a resource of a different type 
245
	 *      at the same path as this resource.</li>
246
	 *      at the same path as this resource.</li>
Lines 314-319 Link Here
314
	 * <ul>
315
	 * <ul>
315
	 * <li> This resource already exists in the workspace.</li>
316
	 * <li> This resource already exists in the workspace.</li>
316
	 * <li> The parent of this resource does not exist.</li>
317
	 * <li> The parent of this resource does not exist.</li>
318
	 * <li> The parent of this resource is a virtual folder.</li>
317
	 * <li> The project of this resource is not accessible.</li>
319
	 * <li> The project of this resource is not accessible.</li>
318
	 * <li> The parent contains a resource of a different type 
320
	 * <li> The parent contains a resource of a different type 
319
	 *      at the same path as this resource.</li>
321
	 *      at the same path as this resource.</li>
(-)src/org/eclipse/core/resources/IFolder.java (+2 lines)
Lines 66-71 Link Here
66
	 * <li> The parent of this resource is a project that is not open.</li>
66
	 * <li> The parent of this resource is a project that is not open.</li>
67
	 * <li> The parent contains a resource of a different type 
67
	 * <li> The parent contains a resource of a different type 
68
	 *      at the same path as this resource.</li>
68
	 *      at the same path as this resource.</li>
69
	 * <li> The parent of this resource is virtual, but this resource is not.</li>
69
	 * <li> The name of this resource is not valid (according to 
70
	 * <li> The name of this resource is not valid (according to 
70
	 *    <code>IWorkspace.validateName</code>).</li>
71
	 *    <code>IWorkspace.validateName</code>).</li>
71
	 * <li> The corresponding location in the local file system is occupied
72
	 * <li> The corresponding location in the local file system is occupied
Lines 142-147 Link Here
142
	 * <li> The parent of this resource is a project that is not open.</li>
143
	 * <li> The parent of this resource is a project that is not open.</li>
143
	 * <li> The parent contains a resource of a different type 
144
	 * <li> The parent contains a resource of a different type 
144
	 *      at the same path as this resource.</li>
145
	 *      at the same path as this resource.</li>
146
	 * <li> The parent of this resource is virtual, but this resource is not.</li>
145
	 * <li> The name of this resource is not valid (according to 
147
	 * <li> The name of this resource is not valid (according to 
146
	 *    <code>IWorkspace.validateName</code>).</li>
148
	 *    <code>IWorkspace.validateName</code>).</li>
147
	 * <li> The corresponding location in the local file system is occupied
149
	 * <li> The corresponding location in the local file system is occupied
(-)porting/3.6/recommended.html (+8 lines)
Lines 18-23 Link Here
18
18
19
<ol>
19
<ol>
20
  <li><a href="#setDerived">Use IResource#setDerived(boolean, IProgressMonitor)</a></li>
20
  <li><a href="#setDerived">Use IResource#setDerived(boolean, IProgressMonitor)</a></li>
21
  <li><a href="#createResourceInVirtualFolderException">A new reason of IFile#create and IFolder#create failure</a></li>
21
</ol>
22
</ol>
22
23
23
<hr>
24
<hr>
Lines 29-33 Link Here
29
As of 3.6, the <code>IResource#setDerived(boolean)</code> is deprecated. <code>IResource#setDerived(boolean, IProgressMonitor)</code>
30
As of 3.6, the <code>IResource#setDerived(boolean)</code> is deprecated. <code>IResource#setDerived(boolean, IProgressMonitor)</code>
30
should be used instead and this change will be reported in a subsequent resource change event.</p>
31
should be used instead and this change will be reported in a subsequent resource change event.</p>
31
32
33
<h2>1. <a name="createResourceInVirtualFolderException">A new reason of IFile#create and IFolder#create failure</a></h2>
34
<p>
35
As of 3.6, there is a new reason when <code>IFile#create</code> and <code>IFolder#create</code> fail, i.e. when a non-virtual resource 
36
is created in a virtual folder. Callers of this API that do preliminary verification before <code>#create</code> is called, 
37
should adapt to this change and support the new case. In particular wizards that create new resources and show errors in the title area 
38
when <code>#create</code> may fail, should handle the case by showing a new error rather than failing and writing to the log.</p>
39
32
</body>
40
</body>
33
</html>
41
</html>

Return to bug 297478