diff options
Diffstat (limited to 'framework/src/ant/apache-ant-1.9.6/manual/Tasks/truncate.html')
| -rw-r--r-- | framework/src/ant/apache-ant-1.9.6/manual/Tasks/truncate.html | 109 |
1 files changed, 0 insertions, 109 deletions
diff --git a/framework/src/ant/apache-ant-1.9.6/manual/Tasks/truncate.html b/framework/src/ant/apache-ant-1.9.6/manual/Tasks/truncate.html deleted file mode 100644 index b7df3f7e..00000000 --- a/framework/src/ant/apache-ant-1.9.6/manual/Tasks/truncate.html +++ /dev/null @@ -1,109 +0,0 @@ -<!-- - Licensed to the Apache Software Foundation (ASF) under one or more - contributor license agreements. See the NOTICE file distributed with - this work for additional information regarding copyright ownership. - The ASF 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. ---> -<html> - -<head> -<meta http-equiv="Content-Language" content="en-us"> -<link rel="stylesheet" type="text/css" href="../stylesheets/style.css"> -<title>Truncate Task</title> -</head> - -<body> - -<h2><a name="touch">Truncate</a></h2> -<h3>Description</h3> - -<p>Set the length of one or more files, as the intermittently available -<code>truncate</code> Unix utility/function. In addition to working with -a single file, this Task can also work on -<a href="../Types/resources.html">resources</a> and resource collections. -<strong>Since Apache Ant 1.7.1</strong>. -</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">file</td> - <td valign="top">The name of the file.</td> - <td valign="top" align="center">Unless a nested resource collection element - has been specified.</td> - </tr> - <tr> - <td valign="top">length</td> - <td valign="top">Specifies the new file length (in bytes) to set. - The following suffixes are supported: - <ul> - <li>K : Kilobytes (1024 bytes)</li> - <li>M : Megabytes (1024 K)</li> - <li>G : Gigabytes (1024 M)</li> - <li>T : Terabytes (1024 G)</li> - <li>P : Petabytes (1024 T)</li> - </ul> - </td> - <td valign="center" align="center" rowspan="2">At most one of these. - Omitting both implies <code>length="0"</code>. - </td> - </tr> - <tr> - <td valign="top">adjust</td> - <td valign="top">Specifies the number of bytes - (and positive/negative direction) - by which to adjust file lengths. The same suffixes are supported - for this attribute as for the <code>length</code> attribute. - </td> - </tr> - <tr> - <td valign="top">create</td> - <td valign="top">Whether to create nonexistent files.</td> - <td valign="top" align="center">No, default <i>true</i>.</td> - </tr> - <tr> - <td valign="top">mkdirs</td> - <td valign="top">Whether to create nonexistent parent - directories when creating new files.</td> - <td valign="top" align="center">No, default <i>false</i>.</td> - </tr> -</table> -<h3>Parameters specified as nested elements</h3> -<h4>any resource collection</h4> - -<p>You can use any number of nested resource collection elements to -define the resources for this task and refer to resources defined -elsewhere. <b>Note:</b> resources passed to this task are expected -to be filesystem-based.</p> - -<h3>Examples</h3> - -<pre> <truncate file="foo" /></pre> -<p>Sets the length of file <code>foo</code> to zero.</p> - -<pre> <truncate file="foo" length="1K" /></pre> -<p>Sets the length of file <code>foo</code> to 1 kilobyte (1024 bytes).</p> - -<pre> <truncate file="foo" adjust="1K" /></pre> -<p>Adjusts the length of file <code>foo</code> upward by 1 kilobyte.</p> - -<pre> <truncate file="foo" adjust="-1M" /></pre> -<p>Adjusts the length of file <code>foo</code> downward by 1 megabyte.</p> - -</body> -</html> |