<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>Ant-contrib Tasks: IniFile
</title>
</head>
<body>
<h1>IniFile
</h1>
<p>Build and Edit Windows .ini files. Only the simple edits,
<code>remove
</code> and
<code>set
</code> are allowed. Set
has limited computation capability which is described later.
</p>
<h2>Parameters
</h2>
<table border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Attribute
</th>
<th>Description
</th>
<th>Required
</th>
</tr>
<tr>
<td valign="top">source
</td>
<td valign="top">The name source .ini file to read in.
</td>
<td align="center" valign="top">No.
</td>
</tr>
<tr>
<td valign="top">dest
</td>
<td valign="top">The name destination .ini file to write.
</td>
<td align="center" valign="top">Yes.
</td>
</tr>
</table>
<h2>Parameters specified as nested elements
</h2>
<code>remove
</code>
<table border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Attribute
</th>
<th>Description
</th>
<th>Required
</th>
</tr>
<tr>
<td valign="top">section
</td>
<td valign="top">The name of the section
</td>
<td align="center" valign="top">Yes.
</td>
</tr>
<tr>
<td valign="top">property
</td>
<td valign="top">The name property.
</td>
<td align="center" valign="top">No. If not supplied, the entire
section will be removed
</td>
</tr>
</table>
<code>set
</code>
<table border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Attribute
</th>
<th>Description
</th>
<th>Required
</th>
</tr>
<tr>
<td valign="top">section
</td>
<td valign="top">The name of the section
</td>
<td align="center" valign="top">Yes.
</td>
</tr>
<tr>
<td valign="top">property
</td>
<td valign="top">The name property.
</td>
<td align="center" valign="top">Yes.
</td>
</tr>
<tr>
<td valign="top">value
</td>
<td valign="top">The value to set the property to.
</td>
<td align="center" valign="top">No, if
<code>operation
</code> is specified.
</td>
</tr>
<tr>
<td valign="top">operation
</td>
<td valign="top">The operation to perform on the existing value.
Possible values are "+" and "-", which add and subtract 1,
respectively from the existing value. If the value doesn't
already exist, the set is not performed.
</td>
<td align="center" valign="top">No, if
<code>value
</code>
is specified.
</td>
</tr>
</table>
<h2>Example
</h2>
<pre><code>
<inifile source="myprog.ini" dest="myprog.new.ini"
>
<set section="Section1" property="release-date" value="${todays.date}" />
<set section="Section1" property="build-number" operation="+" />
<remove section="Section2" property="useless" />
<remove section="OutdatedSection" />
</inifile
>
</code></pre>
<hr>
<p align="center">Copyright
© 2002-2003 Ant-Contrib Project. All
rights Reserved.
</p>
</body>
</html>