blob: a9bca7e01b5f5dbfe8915ab4d41622ac6c223f12 [file] [log] [blame]
<!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>Linked resources</title>
<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"> </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>
Special rules apply when manipulating linked resources. Since they must be located
directly below a project, you cannot copy or move linked resources into other folders.
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>
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.png">
<b>General &gt; Workspace &gt; 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>
<img border="0" src="../images/ngrelc.png" alt="Related concepts" ><br>
<a href="concepts-2.htm">Workbench</a><br>
<a href="cnav.htm">Navigator view</a><br>
<a href="concepts-12.htm">Resources</a><br>
<a href="concepts-17.htm">Resource hierarchies</a><br>
</p>
<p><img border="0" src="../images/ngrelt.png" alt="Related tasks" ><br>
<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>
</p>
<p><img border="0" src="../images/ngrelr.png" alt="Related references" >
<br>
<a href="../reference/ref-14b.htm">Linked resources</a>
</p>
</BODY>
</HTML>