jarlib-manifest Task

jarlib-manifest

Description

Task to generate a manifest that declares all the dependencies in manifest. The dependencies are determined by looking in the specified path and searching for Extension / "Optional Package" specifications in the manifests of the jars.

Note that this task works with extensions as defined by the "Optional Package" specification. For more information about optional packages, see the document Optional Package Versioning in the documentation bundle for your Java2 Standard Edition package, in file guide/extensions/versioning.html or online at http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html.

See the Extension and ExtensionSet documentation for further details

Parameters

Attribute	Description	Required
destfile	The file to generate Manifest into	Yes.

Parameters specified as nested elements

extension

Extension the extension that this library implements.

depends

ExtensionSets containing all dependencies for jar.

options

ExtensionSets containing all optional dependencies for jar. (Optional dependencies will be used if present else they wilkl be ignored)

Examples

Basic Manifest generated for single Extension

<extension id="e1"
    extensionName="MyExtensions"
    specificationVersion="1.0"
    specificationVendor="Peter Donald"
    implementationVendorID="vv"
    implementationVendor="Apache"
    implementationVersion="2.0"
    implementationURL="http://somewhere.com"/>

<jarlib-manifest destfile="myManifest.txt">
    <extension refid="e1"/>
</jarlib-manifest>

Search for extension in fileset

A large example with required and optional dependencies

<extension id="e1"
    extensionName="MyExtensions"
    specificationVersion="1.0"
    specificationVendor="Peter Donald"
    implementationVendorID="vv"
    implementationVendor="Apache"
    implementationVersion="2.0"
    implementationURL="http://somewhere.com"/>

<extensionSet id="option.ext">
    <libfileset dir="lib/option">
        <include name="**/*.jar"/>
    </libfileset>
</extensionSet>

<extensionSet id="depends.ext">
    <libfileset dir="lib/required">
        <include name="*.jar"/>
    </libfileset>
</extensionSet>

<jarlib-manifest destfile="myManifest.txt">
    <extension refid="e1"/>
    <depends refid="depends.ext"/>
    <options refid="option.ext"/>
</jarlib-manifest>