| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><HTML> |
| <HEAD> |
| |
| <meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2005. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." > |
| |
| <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1"> |
| <META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css"> |
| |
| <LINK REL="STYLESHEET" HREF="../book.css" CHARSET="ISO-8859-1" TYPE="text/css"> |
| <TITLE> |
| Derived resources |
| </TITLE> |
| |
| <link rel="stylesheet" type="text/css" HREF="../book.css"> |
| </HEAD> |
| <BODY BGCOLOR="#ffffff"> |
| <h2>Derived resources</h2> |
| |
| <p>Many resources get created in the course of translating, compiling, copying, |
| or otherwise processing files that the user creates and edits. <b>Derived |
| resources</b> are resources that are not original data, and can be recreated |
| from their source files. It is common for derived files to be excluded |
| from certain kinds of processing. </p> |
| <p>For example, derived resources are typically not kept in a team repository, |
| since they clutter the repository, change regularly, and can be recreated from |
| their source files. It is not practical for team providers to make |
| decisions about which files are derived. The resource API provides a |
| common mechanism for plug-ins to indicate the resources they create that are |
| derived.</p> |
| <p>Plug-ins may use <a href="../reference/api/org/eclipse/core/resources/IResource.html"><b>IResource</b></a>.<b>setDerived(boolean) |
| </b>to indicate that a resource is derived from other resources. Newly created resources are not |
| derived by default, so this |
| method must be used to explicitly mark the resource as derived. A |
| common use is to mark a subfolder of the project as derived when an |
| "output" folder (such as the "bin" folder in Java projects) |
| is created by the plug-in.</p> |
| <p>Other plug-ins, usually team providers, can use <a href="../reference/api/org/eclipse/core/resources/IResource.html"><b>IResource</b></a>.<b>isDerived |
| </b>to determine whether a particular resource should be managed by the |
| repository. Attempts to mark projects or the workspace root as derived will be |
| ignored.</p> |
| <blockquote> |
| <p><i>Note: The concept of derived resources is provided for other |
| (non-team) plug-ins to indicate which resources are inappropriate for repository |
| management. Special files created by team implementations to manage their |
| data should not be marked as derived resources. See <a href="team_resources_private.htm">Team |
| private resources</a> for a technique for marking team-related implementation |
| resources hidden.</i></p> |
| </blockquote> |
| <p> </p> |
| |
| |
| |
| </BODY> |
| </HTML> |