blob: 01a96b19344457dac3d62b67afcc3776dd43e495 [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta name="copyright" content="Copyright (c) 2005 BEA Systems, Inc. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html" >
<title>
Processor Option Input Dialog
</title>
</head>
<body>
<h1>
Processor Option Input Dialog
</h1>
<p>The Processor Option input dialog is reached from the <a href="apt_config.html">Annotation Processing
preferences pane</a>. It allows processor options to be added or modified.
<p>Options entered here will be presented to the processors through the AnnotationProcessorEnvironment
interface. Each option will be presented in two forms: as a key/value pair, and as a combined
key corresponding to the command-line form of the option, namely &quot;-Akey=value&quot;.
For instance, an option with key &quot;foo&quot; and value &quot;bar&quot; would be presented
both that way and as key &quot;-Afoo=bar&quot;, value null.
<p>Option values representing paths may begin with a percent-delimited token such as <code>%FOO%/</code>.
If the token is the name of a classpath variable, it will be replaced with the current
value of the variable at processor execution time. The special value <code>ROOT</code> expands
to the absolute path of the workspace. For example, <code>%ROOT%/foo/bar.xml</code> might
expand to <code>d:/my_workspace/foo/bar.xml</code>, and <code>%JRE_LIB%/rt.jar</code> might
expand to <code>c:/jdk1.5.0/lib/rt.jar</code>. Similarly, the special value <code>PROJECT.DIR</code>
expands to the absolute path of the current project.
<p>Certain options are automatically provided to the processors; entering them in this dialog
will have no effect, since the automatically provided values will override any values set here.
The automatic options are described <a href="automatic_processor_options.html">here</a>.
</body>
</html>