diff options
Diffstat (limited to 'docs/manual/tasks/inifile.html')
-rw-r--r-- | docs/manual/tasks/inifile.html | 110 |
1 files changed, 110 insertions, 0 deletions
diff --git a/docs/manual/tasks/inifile.html b/docs/manual/tasks/inifile.html new file mode 100644 index 0000000..d5722a9 --- /dev/null +++ b/docs/manual/tasks/inifile.html @@ -0,0 +1,110 @@ +<!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> |