<?xml version="1.0" encoding="UTF-8"?>
<!--
Licensed to the Ant-Contrib Project under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The Ant-Contrib Project licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<document xmlns:xhtml="http://www.w3.org/1999/xhtml" xmlns:taskdocs="http://ant-contrib.sf.net/taskdocs">
<properties>
<title>precompile</title>
</properties>
<body>
<section name="precompile">
<subsection name="Description">An element that specifies a prototype file and rules for source files that
should not use precompiled headers</subsection>
<subsection name="parameters">
<table>
<tr>
<td>
<b>Attribute</b>
</td>
<td>
<b>Description</b>
</td>
<td>
<b>Type</b>
</td>
</tr>
<tr>
<td>description</td>
<td>Sets a description of the current data type.</td>
<td>String</td>
</tr>
<tr>
<td>id</td>
<td>Sets an id that can be used to reference this element.</td>
<td>String</td>
</tr>
<tr>
<td>if</td>
<td>Set the 'if' condition.
The processor will be ignored unless the property is defined.
The value of property is insignificant, but values that would imply
misinterpretation ("false", "no") will throw an exception when
isActive() is evaluated.</td>
<td>String</td>
</tr>
<tr>
<td>prototype</td>
<td>Sets file to precompile.
Should be a source file that includes only one unguarded header file.
Default value is "stdafx.cpp".</td>
<td>File</td>
</tr>
<tr>
<td>refid</td>
<td>Specifies that this element should behave as if the content of the
element with the matching id attribute was inserted at this location.</td>
<td>Reference</td>
</tr>
<tr>
<td>unless</td>
<td>Set the 'unless' condition. If named property exists at execution time,
the processor will be ignored.
Value of property is insignificant, but values that would imply
misinterpretation ("false", "no") of the behavior will throw an
exception when isActive is called.</td>
<td>String</td>
</tr>
</table>
</subsection>
<subsection name="parameters as nested elements">
<dl>
<dt>
<a href="PrecompileExceptDef.html">except</a>
</dt>
<dd>Adds filesets that specify files that should not be processed with
precompiled headers enabled.</dd>
</dl>
</subsection>
</section>
</body>
</document>