2006-09-11 04:19:00 +00:00
|
|
|
<!--
|
|
|
|
|
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.
|
|
|
|
|
-->
|
2001-02-13 12:32:01 +00:00
|
|
|
<html>
|
|
|
|
|
|
|
|
|
|
<head>
|
|
|
|
|
<meta http-equiv="Content-Language" content="en-us">
|
2005-04-29 18:58:16 +00:00
|
|
|
<link rel="stylesheet" type="text/css" href="../stylesheets/style.css">
|
2002-02-03 22:11:39 +00:00
|
|
|
<title>Cab Task</title>
|
2001-02-13 12:32:01 +00:00
|
|
|
</head>
|
|
|
|
|
|
|
|
|
|
<body>
|
|
|
|
|
|
|
|
|
|
<h2><a name="cab">Cab</a></h2>
|
|
|
|
|
<h3>Description</h3>
|
|
|
|
|
<p>The cab task creates Microsoft cab archive files. It is invoked
|
|
|
|
|
similar to the <a href="../CoreTasks/jar.html">jar</a> or <a href="../CoreTasks/zip.html">zip</a> tasks.
|
|
|
|
|
This task will work on Windows using the external cabarc tool (provided by Microsoft)
|
|
|
|
|
which must be located in your executable path.</p>
|
2002-06-22 23:38:38 +00:00
|
|
|
<p>To use this task on other platforms you need to download and compile libcabinet from
|
2001-02-13 12:32:01 +00:00
|
|
|
<a href="http://trill.cis.fordham.edu/~barbacha/cabinet_library/">
|
|
|
|
|
http://trill.cis.fordham.edu/~barbacha/cabinet_library/</a>.</p>
|
|
|
|
|
<p>See the section on <a href="../dirtasks.html#directorybasedtasks">directory based
|
|
|
|
|
tasks</a>, on how the inclusion/exclusion of files works, and how to
|
|
|
|
|
write patterns.</p>
|
|
|
|
|
<p>This task forms an implicit <a href="../CoreTypes/fileset.html">FileSet</a> and
|
|
|
|
|
supports all attributes of <code><fileset></code>
|
|
|
|
|
(<code>dir</code> becomes <code>basedir</code>) as well as the nested
|
|
|
|
|
<code><include></code>, <code><exclude></code> and
|
|
|
|
|
<code><patternset></code> elements.</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">cabfile</td>
|
|
|
|
|
<td valign="top">the name of the cab file to create.</td>
|
|
|
|
|
<td valign="top" align="center">Yes</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">basedir</td>
|
|
|
|
|
<td valign="top">the directory to start archiving files from.</td>
|
2003-03-19 10:48:01 +00:00
|
|
|
<td valign="top" align="center">No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">verbose</td>
|
|
|
|
|
<td valign="top">set to "yes" if you want to see the output from
|
|
|
|
|
the cabarc tool. defaults to "no".</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">compress</td>
|
|
|
|
|
<td valign="top">set to "no" to store files without compressing.
|
|
|
|
|
defaults to "yes".</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">options</td>
|
|
|
|
|
<td valign="top">use to set additional command-line options for
|
|
|
|
|
the cabarc tool. should not normally be necessary.</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">includes</td>
|
2002-06-22 23:38:38 +00:00
|
|
|
<td valign="top">comma- or space-separated list of patterns of files that
|
2001-02-13 12:32:01 +00:00
|
|
|
must be included. All files are included when omitted.</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">includesfile</td>
|
|
|
|
|
<td valign="top">the name of a file. Each line of this file is
|
|
|
|
|
taken to be an include pattern</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">excludes</td>
|
2002-06-22 23:38:38 +00:00
|
|
|
<td valign="top">comma- or space-separated list of patterns of files that
|
2001-02-13 12:32:01 +00:00
|
|
|
must be excluded. No files (except default excludes) are excluded
|
|
|
|
|
when omitted.</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">excludesfile</td>
|
|
|
|
|
<td valign="top">the name of a file. Each line of this file is
|
|
|
|
|
taken to be an exclude pattern</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">defaultexcludes</td>
|
|
|
|
|
<td valign="top">indicates whether default excludes should be used
|
|
|
|
|
or not ("yes"/"no"). Default excludes are used when omitted.</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
2003-03-19 10:48:01 +00:00
|
|
|
<h3>Parameters specified as nested elements</h3>
|
|
|
|
|
<h4>fileset</h4>
|
|
|
|
|
|
|
|
|
|
<p>The cab task supports any number of nested <a
|
|
|
|
|
href="../CoreTypes/fileset.html"><code><fileset></code></a>
|
|
|
|
|
elements to specify the files to be included in the archive.</p>
|
|
|
|
|
|
2001-02-13 12:32:01 +00:00
|
|
|
<h3>Examples</h3>
|
|
|
|
|
<blockquote><pre>
|
|
|
|
|
<cab cabfile="${dist}/manual.cab"
|
2002-06-22 23:38:38 +00:00
|
|
|
basedir="htdocs/manual"
|
2001-02-13 12:32:01 +00:00
|
|
|
/>
|
|
|
|
|
</pre></blockquote>
|
|
|
|
|
<p>cabs all files in the htdocs/manual directory into a file called
|
|
|
|
|
manual.cab in the ${dist} directory.</p>
|
|
|
|
|
<blockquote><pre>
|
|
|
|
|
<cab cabfile="${dist}/manual.cab"
|
|
|
|
|
basedir="htdocs/manual"
|
|
|
|
|
excludes="mydocs/**, **/todo.html"
|
|
|
|
|
/>
|
|
|
|
|
</pre></blockquote>
|
|
|
|
|
<p>cabs all files in the htdocs/manual directory into a file called
|
|
|
|
|
manual.cab in the ${dist} directory. Files in the directory mydocs,
|
|
|
|
|
or files with the name todo.html are excluded.</p>
|
|
|
|
|
<blockquote><pre>
|
|
|
|
|
<cab cabfile="${dist}/manual.cab"
|
|
|
|
|
basedir="htdocs/manual"
|
|
|
|
|
includes="api/**/*.html"
|
|
|
|
|
excludes="**/todo.html"
|
|
|
|
|
verbose="yes"
|
|
|
|
|
/>
|
|
|
|
|
</pre></blockquote>
|
|
|
|
|
<p>Cab all files in the htdocs/manual directory into a file called
|
|
|
|
|
manual.cab in the ${dist} directory. Only html files under the
|
|
|
|
|
directory api are archived, and files with the name todo.html are
|
|
|
|
|
excluded. Output from the cabarc tool is displayed in the build
|
|
|
|
|
output.</p>
|
2003-03-19 10:48:01 +00:00
|
|
|
|
|
|
|
|
<blockquote><pre>
|
|
|
|
|
<cab cabfile="${dist}/manual.cab"
|
|
|
|
|
verbose="yes">
|
|
|
|
|
<fileset
|
|
|
|
|
dir="htdocs/manual"
|
|
|
|
|
includes="api/**/*.html"
|
|
|
|
|
excludes="**/todo.html"
|
|
|
|
|
/>
|
|
|
|
|
</cab>
|
|
|
|
|
</pre></blockquote>
|
|
|
|
|
<p>is equivalent to the example above.</p>
|
|
|
|
|
|
2006-09-11 04:33:25 +00:00
|
|
|
|
2001-02-13 12:32:01 +00:00
|
|
|
|
|
|
|
|
</body>
|
|
|
|
|
</html>
|
|
|
|
|
|
