blob: a2c69fdc3ec90942b6415ac59255afed97082ab1 [file] [log] [blame]
<!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">
<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js" type="text/javascript"></script>
<LINK REL="STYLESHEET" HREF="../book.css" CHARSET="ISO-8859-1" TYPE="text/css">
<title>Ant Editor Preferences</title>
</HEAD>
<BODY>
<H1 CLASS="Head">Ant Editor Preferences</H1>
<p>The following preferences can be changed on the
<a class="command-link" href='javascript:executeCommand("org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.ant.ui.AntEditorPreferencePage)")'>
<img src="PLUGINS_ROOT/org.eclipse.help/command_link.png" alt="command link">
<strong>Ant &gt; Editor</strong></a> page.</p>
<h2>Appearance options</h2>
<table border="1" cellspacing="0" width="80%">
<thead>
<tr>
<th width="25%">Option</th>
<th>Description</th>
<th width="8%">Default</th>
</tr>
</thead>
<tbody>
<tr>
<td> Mark occurrences of the selected element in the current buildfile</td>
<td>This option allows you to select elements and mark occurrences in the current buildfile.</td>
<td align="center">Off</td>
</tr>
<tr>
<td>Keep marks when selection changes</td>
<td>This option allows you to keep marks when the selection changes.</td>
<td align="center">On</td>
</tr>
</tbody>
</table>
<P>Here is what the Appearance tab of the Ant editor preference page
looks like.
</P>
<P>
<img src="../images/ant_editor_appearance.png" alt="Ant editor appearance preference page" border="0">
</P>
<h2>Syntax options</h2>
<p>The Foreground options located on the Syntax tab, allow you to format the font
of comments, constant strings, DTD declarations, processing instructions, tags
and text. The Preview pane allows you to see your changes before you apply them.
</p>
<table border="1" cellspacing="0" width="80%">
<thead>
<tr>
<th width="25%">Option</th>
<th>Description</th>
<th width="8%">Default</th>
</tr>
</thead>
<tbody>
<tr>
<td>Foreground</td>
<td>This table is used to change the foreground colour of the selected element (within the table).</td>
<td align="center">&nbsp;</td>
</tr>
<tr>
<td>Colour</td>
<td>This option allows you to select a colour to set for the selected foreground element.</td>
<td align="center">&nbsp;</td>
</tr>
<tr>
<td>Bold</td>
<td>This option allows you to set the bold state of the selected foreground element.</td>
<td align="center">Off</td>
</tr>
<tr>
<td>Italic</td>
<td>This option allows you to set the italic state of the selected foreground element.</td>
<td align="center">Off</td>
</tr>
<tr>
<td>Preview</td>
<td>Shows you a preview of the changes made to the selected foreground element.</td>
<td align="center">&nbsp;</td>
</tr>
</tbody>
</table>
<p>
Here is what the Syntax tab of the Ant editor preference page looks like.
</p>
<p><img src="../images/ant_editor_syntax.png" alt="Ant editor syntax preference page" border="0"></p>
<h2>Problems options</h2>
<p>The Problems options allow you to ignore all buildfile problems or to specify
the specific files that you do not want the Ant Editor to check for problems.
You can also set the severity level for buildfile problems such as task configuration,
an incomplete classpath, property setting tasks, import tasks, and security
problems. </p>
<table border="1" cellspacing="0" width="80%">
<thead>
<tr>
<th width="25%">Option</th>
<th>Description</th>
<th width="8%">Default</th>
</tr>
</thead>
<tbody>
<tr>
<td>Ignore all buildfile problems</td>
<td>This option allows you to ignore all buildfile problems by default.</td>
<td align="center">Off</td>
</tr>
<tr>
<td>Names</td>
<td>This option allows you to specify the names of buildfiles that will NOT be checked for problems in the Ant editor.
Entries in this field are comma-separated.</td>
<td align="center">&nbsp;</td>
</tr>
<tr>
<td>Task configuration</td>
<td>This option allows you to set the severity for task configuration problems.</td>
<td align="center">Ignore</td>
</tr>
<tr>
<td>Incomplete classpath</td>
<td>This option allows you to set the severity for incomplete classpath problems.</td>
<td align="center">Warning</td>
</tr>
<tr>
<td>Property setting tasks</td>
<td>This option allows you to set the severity for property setting tasks problems.</td>
<td align="center">Ignore</td>
</tr>
<tr>
<td>Import tasks</td>
<td>This option allows you to set the severity for import tasks problems.</td>
<td align="center">Warning</td>
</tr>
<tr>
<td>Security problems</td>
<td>This option allows you to set the severity for security problems.</td>
<td align="center">Warning</td>
</tr>
</tbody>
</table>
<p>
Here is what the Problems tab of the Ant editor preference page looks like.
</p>
<p><img src="../images/ant_editor_problems.png" alt="Ant editor Problems preference page" border="0"></p>
<h2>Folding options</h2>
<p>The Folding options allow you to enable folding when opening a new editor and
to specify which region types should be folded.</p>
<table border="1" cellspacing="0" width="80%">
<thead>
<tr>
<th width="25%">Option</th>
<th>Description</th>
<th width="8%">Default</th>
</tr>
</thead>
<tbody>
<tr>
<td>Enable folding when opening a new editor</td>
<td>This option allows you to always enable folding for any newly created Ant editors.</td>
<td align="center">On</td>
</tr>
<tr>
<td>DTD blocks</td>
<td>This option allows you to always have DTD blocks in a buildfile automatically folded when opened in an Ant editor.</td>
<td align="center">Off</td>
</tr>
<tr>
<td>Comments</td>
<td>This option allows you to always have comments in a buildfile automatically folded when opened in an Ant editor.</td>
<td align="center">Off</td>
</tr>
<tr>
<td>Defining tasks</td>
<td>This option allows you to always have defining tasks in a buildfile automatically folded when opened in an Ant editor.</td>
<td align="center">Off</td>
</tr>
<tr>
<td>Targets</td>
<td>This option allows you to always have targets in a buildfile automatically folded when opened in an Ant editor.</td>
<td align="center">Off</td>
</tr>
</tbody>
</table>
<p>
Here is what the Folding tab of the Ant editor preference page looks like.
</p>
<p><img src="../images/ant_editor_folding.png" alt="Ant editor Folding preference page" border="0"></p>
<p> <img border="0" src="../images/ngrelc.png" alt="Related concepts" ><br>
<a href="../concepts/concepts-antsupport.htm">Ant support</a>
</p>
<p>
<img border="0" src="../images/ngrelr.png" alt="Related reference" ><br>
<a href="ref-anteditor.htm">Ant Editor</a><br>
<a href="../reference/ref-antprefs.htm">General Ant preferences</a><br>
<a href="../reference/ref-antruntimeprefs.htm">Ant runtime preferences</a><br>
<a href="../reference/ref-antformatter.htm">Ant formatter preferences</a><br>
<a href="../reference/ref-anttemplates.htm">Ant templates preferences</a>
</p>
</BODY>
</HTML>