ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ehatc...@apache.org
Subject cvs commit: jakarta-ant/docs/manual/CoreTasks loadfile.html
Date Fri, 20 Dec 2002 01:38:31 GMT
ehatcher    2002/12/19 17:38:31

  Modified:    docs/manual/CoreTasks loadfile.html
  Log:
  fix missing filterchain in example
  
  Revision  Changes    Path
  1.8       +1 -97     jakarta-ant/docs/manual/CoreTasks/loadfile.html
  
  Index: loadfile.html
  ===================================================================
  RCS file: /home/cvs/jakarta-ant/docs/manual/CoreTasks/loadfile.html,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -r1.7 -r1.8
  --- loadfile.html	4 Sep 2002 11:05:16 -0000	1.7
  +++ loadfile.html	20 Dec 2002 01:38:31 -0000	1.8
  @@ -1,97 +1 @@
  -<html>
  -<head>
  -<title>LoadFile Task</title>
  -</head>
  -
  -<body>
  -
  -
  -<h2><a name="loadfile">LoadFile</a></h2>
  -<h3>Description</h3>
  -<p>
  - Load a text file into a single property. Unless an encoding is specified,
  - the encoding of the current locale is used.
  -
  -</p>
  -
  -<h3>Parameters</h3>
  -<table border="1" cellpadding="2" cellspacing="0">
  -  <tr>
  -    <td valign="top"><b>Attribute</b></td>
  -    <td valign="top"><b>Description</b></td>
  -    <td align="center" valign="top"><b>Required</b></td>
  -  </tr>
  -  <tr>
  -    <td valign="top">srcFile</td>
  -    <td valign="top">source file</td>
  -    <td valign="top" align="center">Yes</td>
  -  </tr>
  -  <tr>
  -    <td valign="top">property</td>
  -    <td valign="top">property to save to</td>
  -    <td valign="top" align="center">Yes</td>
  -  </tr>
  -  <tr>
  -    <td valign="top">encoding</td>
  -    <td valign="top">encoding to use when loading the file</td>
  -    <td align="center" valign="top">No</td>
  -  </tr>
  -  <tr>
  -    <td valign="top">failonerror</td>
  -    <td valign="top">Whether to halt the build on failure</td>
  -    <td align="center" valign="top">No, default "true"</td>
  -  </tr>
  -</table>
  -<p>
  -The LoadFile task supports nested <a href="../CoreTypes/filterchain.html">
  -FilterChain</a>s.
  -
  -<h3>Examples</h3>
  -<pre>    &lt;loadfile property="message"
  -      srcFile="message.txt"/&gt;
  -</pre>
  -Load file message.txt into property "message"; an <tt>&lt;echo&gt;</tt>
  -can print this.
  -
  -<pre>    &lt;loadfile property="encoded-file"
  -      srcFile="loadfile.xml"
  -      encoding="ISO-8859-1"/&gt;
  -</pre>
  -Load a file using the latin-1 encoding
  -
  -<pre>    &lt;loadfile
  -      property="optional.value"
  -      srcFile="optional.txt"
  -      failonerror="false"/&gt;
  -</pre>
  -Load a file, don't fail if it is missing (a message is printed, though)
  -
  -<pre>    &lt;loadfile
  -      property="mail.recipients"
  -      srcFile="recipientlist.txt"&gt;
  -      &lt;filterchain&gt;
  -        &lt;<a href="../CoreTypes/filterchain.html#striplinebreaks">striplinebreaks</a>/&gt;
  -      &lt;/filterchain&gt;
  -    &lt;/loadfile&gt;
  -</pre>
  -Load a property which can be used as a parameter for another task (in this case mail),
  -merging lines to ensure this happens.
  -
  -<pre>    &lt;loadfile
  -      property="system.configuration.xml"
  -      srcFile="configuration.xml"&gt;
  -        &lt;<a href="../CoreTypes/filterchain.html#expandproperties">expandproperties</a>/&gt;
  -    &lt;/loadfile&gt;
  -</pre>
  -Load an XML file into a property, expanding all properties declared
  -in the file in the process.
  -
  -
  -<hr>
  -
  -<p align="center">Copyright &copy; 2001-2002 Apache Software Foundation. All
rights
  -Reserved.</p>
  -
  -</body>
  -</html>
  -
  +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
 <title>LoadFile Task</title>
</head>
<body>
<h2><a name="loadfile">LoadFile</a></h2>
<h3>Description</h3>
<p>
Load a text file into a single property. Unless an encoding is specified,
 the encoding of
the current locale is used. </p>
<h3>Parameters</h3>
<table border="1"
cellpadding="2" cellspacing="0">
  <tbody>
    <tr>
    <td valign="top"><b>Attribute</b></td>
   <td valign="top"><b>Description</b></td>
    <td align="center"
valign="top"><b>Required</b></td>
  </tr>
  <tr>
    <td
valign="top">srcFile</td>
    <td valign="top">source file</td>
    <td
valign="top" align="center">Yes</td>
  </tr>
  <tr>
    <td valign="top">property</td>
   <td valign="top">property to save to</td>
    <td valign="top" align="center">Yes</td>
 </tr>
  <tr>
    <td valign="top">encoding</td>
    <td valign="top">encoding
to use when loading the file</td>
    <td align="center" valign="top">No</td>
 </tr>
  <tr>
    <td valign="top">failonerror</td>
    <td valign="top">Whether
to halt the build on failure</td>
    <td align="center" valign="top">No, default
"true"</td>
  </tr>
  </tbody>
</table>
<p>The LoadFile task
supports nested <a
 href="../CoreTypes/filterchain.html">FilterChain</a>s. </p>
<h3>Examples</h3>
<pre>
   &lt;loadfile property="message"<br>      srcFile="message.txt"/&gt;<br></pre>
Load
file message.txt into property "message"; an <tt>&lt;echo&gt;</tt>can
print
this. 
<pre>    &lt;loadfile property="encoded-file"<br>      srcFile="loadfile.xml"<br>
     encoding="ISO-8859-1"/&gt;<br></pre>
Load a file using the latin-1 encoding

<pre>    &lt;loadfile<br>      property="optional.value"<br>      srcFile="optional.txt"<br>
     failonerror="false"/&gt;<br></pre>
Load a file, don't fail if it is missing
(a message is printed, though) 
<pre>    &lt;loadfile<br>      property="mail.recipients"<br>
     srcFile="recipientlist.txt"&gt;<br>      &lt;filterchain&gt;<br>
       &lt;<a
 href="../CoreTypes/filterchain.html#striplinebreaks">striplinebreaks</a>/&gt;<br>
     &lt;/filterchain&gt;<br>    &lt;/loadfile&gt;<br></pre>
Load
a property which can be used as a parameter for another task (in this
case mail), merging
lines to ensure this happens. 
<pre>    &lt;loadfile<br>      property="system.configuration.xml"<br>
     srcFile="configuration.xml"&gt;<br>        &lt;filterchain&gt;<br>
         &lt;<a
 href="../CoreTypes/filterchain.html#expandproperties">expandproperties</a>/&gt;<br>
       &lt;/filterchain&gt;<br>    &lt;/loadfile&gt;<br></pre>
Load
an XML file into a property, expanding all properties declared in the
file in the process.

<hr>
<p align="center">Copyright &copy; 2001-2002 Apache Software Foundation.
All
rights Reserved.</p>
<br>
</body>
</html>
  \ No newline at end of file
  
  
  

--
To unsubscribe, e-mail:   <mailto:ant-dev-unsubscribe@jakarta.apache.org>
For additional commands, e-mail: <mailto:ant-dev-help@jakarta.apache.org>


Mime
View raw message