| <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
| |
| <html lang="en"> |
| <head> |
| <meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2012. 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"> |
| |
| <title>Source Attachment Property Page</title> |
| <link rel="stylesheet" href="../book.css" charset="ISO-8859-1" type="text/css"> |
| <script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js" type="text/javascript"> </script> |
| </head> |
| |
| <body> |
| <h1>Source Attachment Property Page</h1> |
| |
| <p>To browse the source of a type contained in library you can attach a source archive or source folder to this library. The editor will then show the source instead of the decompiled code. |
| Setting the source attachment also allows source level stepping with the debugger.</p> |
| |
| <p>The Source Attachment dialog can be reached in several ways:</p> |
| |
| <ul> |
| <li>Select a JAR in the Package Explorer and choose <b>Properties > Java Source Attachment</b> from the context |
| menu or the <a href="ref-menu-project.htm">Project menu</a></li> |
| |
| <li>Open the Java Build Path page of a project (<b>Projects > |
| Properties > Java Build Path</b>). On the <b>Libraries</b> page expand the library's node and select the <b>Source |
| attachment</b> attribute and press <b>Edit</b></li> |
| <li>Open an editor on a class file. If the |
| source attachment has not already been configured for this JAR, the |
| editor contains a button <span class="control">Attach Source</span></li> |
| </ul> |
| |
| <p>Depending of how a JAR was contributed to the classpath, you can see different types of Source attachment dialogs:</p> |
| |
| |
| |
| <h2>JAR</h2> |
| |
| <p>In the <span class="control">Path</span> field, enter the path of an archive or a folder containing the source. Use either the <b>Workspace</b>, <b>External |
| File</b> or the <b>External Folder</b> button to browse for a location.</p> |
| |
| For a source attachment in an external location you can also specify an optional <b>Encoding</b> for reading the source attachment. By default the workspace encoding is used. |
| |
| <h2>Variable</h2> |
| |
| <p>In the <span class="control">Location Variable Path</span> field |
| enter a <i>variable path</i> that points to the source attachment's location. |
| A variable path has as first segment a variable (which will resolve to a |
| folder or file), the rest is an optional path extension (e.g.<em>MYVARIABLE/src.jar</em> |
| ). Use either the <span class="control">Variable</span> button to select |
| an existing variable and the <span class="control">Extension</span> |
| button to select the extension path. The <span class="control">Extension</span> |
| button is only enabled when the variable can be extended (resolves to a |
| folder)</p> |
| |
| <p><var>JRE_SRC</var> is a reserved variable that points to a JRE selected in the <a href="../reference/preferences/java/debug/ref-installed_jres.htm">Installed JREs preference page</a> |
| (<a class="command-link" href='javascript:executeCommand("org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.jdt.debug.ui.preferences.VMPreferencePage)")'> |
| <img src="PLUGINS_ROOT/org.eclipse.help/command_link.svg" alt="Opens the Installed JRE preference page"> |
| <span class="control">Java > Installed JREs</span></a>). |
| Go to this preference page to configure the source attachment for the JRE's library..</p> |
| |
| |
| |
| <h3 class="related">Related concepts</h3> |
| <a href="../concepts/concept-build-classpath.htm">Build classpath</a> |
| |
| <h3 class="related">Related references</h3> |
| <a href="../reference/preferences/java/debug/ref-installed_jres.htm">Installed JREs preferences</a><br> |
| <a href="../reference/ref-properties-build-path.htm">Java build path properties</a> |
| </body> |
| </html> |
| |
