| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
| <html lang="en"> |
| <HEAD> |
| |
| <meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2011. 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>Linked resources</title> |
| <script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js" type="text/javascript"> </script> |
| </HEAD> |
| |
| <BODY BGCOLOR="#ffffff"> |
| <H1 CLASS="Head">Linked resources</H1> |
| <p> |
| Linked resources are files and folders that are stored in locations |
| in the file system outside of the project's location. These special resources can be |
| used to add files and folders to your project that for some reason must be stored in a |
| certain place outside of your project. For example, a linked folder can be used |
| to store build output separately from your source files. |
| </p> |
| <p> |
| You can even use linked resources to overlap other resources in the workspace, so |
| resources from one project can appear in another project. |
| If you do want to have overlapping resources in your workspace, do so with caution. |
| Keep in mind that this means changing a resource in one place will cause simultaneous |
| changes in the duplicate resource. Deleting one duplicate resource will delete both! |
| </p> |
| <p> |
| Deleting a linked resource will <em>not</em> cause the corresponding resource |
| in the file system to be deleted. However, deleting child resources of linked folders |
| <em>will</em> cause them to be removed from the file system. |
| </p> |
| <p> |
| Linked resource target paths can be either defined as absolute paths, or relative to a path variable. |
| </p> |
| <p> |
| The linked resource target path can be changed by selecting the <b>Edit...</b> button in the |
| <b>File > Properties > Resource</b> property page of the linked resource. |
| </p> |
| <p> |
| A list of all linked resources that exist in a project can be seen and edited from the |
| <b>File > Properties > Resource > Linked Resources</b> property page, under the |
| <b>Linked Resources</b> tab. |
| </p> |
| <p> |
| Some plug-ins built on top of the Eclipse platform are not compatible with linked resources. |
| If this is the case, you can completely disable the linked resource feature to prevent them |
| from being created in your workspace. Linked resources can be disabled from the |
| <a class="command-link" href='javascript:executeCommand("org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.ui.preferencePages.LinkedResources)")'> |
| <img src="PLUGINS_ROOT/org.eclipse.help/command_link.svg" alt="command link"> |
| <b>General > Workspace > Linked Resources</b></a> preference page. |
| Certain types of projects or team repository providers may also disallow linked resources |
| from being created in some projects.</p> |
| <p> |
| |
| <h3 class="related">Related concepts</h3> |
| <a href="concepts-2.htm">Workbench</a><br> |
| <a href="../reference/ref-27.htm">Project Explorer view</a><br> |
| <a href="concepts-12.htm">Resources</a><br> |
| <a href="concepts-17.htm">Resource hierarchies</a><br> |
| |
| <h3 class="related">Related tasks</h3> |
| |
| <a href="../tasks/tasks-45.htm">Creating linked resources</a><br> |
| <a href="../tasks/tasks-67.htm">Deleting resources</a><br> |
| <a href="../tasks/tasks-49.htm">Viewing resource properties</a><br> |
| |
| <h3 class="related">Related reference</h3> |
| <a href="../reference/ref-14b.htm">Linked resources</a> |
| |
| |
| </BODY> |
| </HTML> |
