From notifications-return-17077-apmail-ant-notifications-archive=ant.apache.org@ant.apache.org Fri Oct 21 11:34:22 2011 Return-Path: X-Original-To: apmail-ant-notifications-archive@minotaur.apache.org Delivered-To: apmail-ant-notifications-archive@minotaur.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id B16259BC5 for ; Fri, 21 Oct 2011 11:34:22 +0000 (UTC) Received: (qmail 96125 invoked by uid 500); 21 Oct 2011 11:34:22 -0000 Delivered-To: apmail-ant-notifications-archive@ant.apache.org Received: (qmail 96084 invoked by uid 500); 21 Oct 2011 11:34:21 -0000 Mailing-List: contact notifications-help@ant.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@ant.apache.org Delivered-To: mailing list notifications@ant.apache.org Received: (qmail 96077 invoked by uid 99); 21 Oct 2011 11:34:21 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 21 Oct 2011 11:34:21 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 21 Oct 2011 11:34:18 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id D9F1123889DA for ; Fri, 21 Oct 2011 11:33:56 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1187304 - in /ant/antlibs/compress/trunk: changes.xml docs/index.html docs/pack200normalize.html Date: Fri, 21 Oct 2011 11:33:56 -0000 To: notifications@ant.apache.org From: bodewig@apache.org X-Mailer: svnmailer-1.0.8-patched Message-Id: <20111021113356.D9F1123889DA@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: bodewig Date: Fri Oct 21 11:33:56 2011 New Revision: 1187304 URL: http://svn.apache.org/viewvc?rev=1187304&view=rev Log: document pack200normalize Added: ant/antlibs/compress/trunk/docs/pack200normalize.html (with props) Modified: ant/antlibs/compress/trunk/changes.xml ant/antlibs/compress/trunk/docs/index.html Modified: ant/antlibs/compress/trunk/changes.xml URL: http://svn.apache.org/viewvc/ant/antlibs/compress/trunk/changes.xml?rev=1187304&r1=1187303&r2=1187304&view=diff ============================================================================== --- ant/antlibs/compress/trunk/changes.xml (original) +++ ant/antlibs/compress/trunk/changes.xml Fri Oct 21 11:33:56 2011 @@ -48,6 +48,12 @@ Support for pack200 compression has been added. + The new pack200normalize task allows you to prepare JAR + archives so they can be signed and compressed with pack200 and + the signature will still be valid after uncompressing them + again. + + Read-only support for the Unix dump format has been added in the form of an <undump> task and corresponding <dumpentry> and <dumpfileset> resources. Modified: ant/antlibs/compress/trunk/docs/index.html URL: http://svn.apache.org/viewvc/ant/antlibs/compress/trunk/docs/index.html?rev=1187304&r1=1187303&r2=1187304&view=diff ============================================================================== --- ant/antlibs/compress/trunk/docs/index.html (original) +++ ant/antlibs/compress/trunk/docs/index.html Fri Oct 21 11:33:56 2011 @@ -50,6 +50,7 @@
  • gunzip
  • gzip
  • pack200
  • +
  • pack200normalize
  • tar
  • unar
  • uncpio
  • Added: ant/antlibs/compress/trunk/docs/pack200normalize.html URL: http://svn.apache.org/viewvc/ant/antlibs/compress/trunk/docs/pack200normalize.html?rev=1187304&view=auto ============================================================================== --- ant/antlibs/compress/trunk/docs/pack200normalize.html (added) +++ ant/antlibs/compress/trunk/docs/pack200normalize.html Fri Oct 21 11:33:56 2011 @@ -0,0 +1,124 @@ + + + + + + + Pack200Normalize + + + + +

    Pack200Normalize

    +

    Description

    + +

    In general packing and unpacking a JAR changes its binary + representation which breaks any signature that has been used to + sign the initial JAR. It is possible to "normalize" a JAR by + packing and unpacking it again so that any signature applied to + the "normalized" JAR will stay valid during another pack/unpack + cycle. + See Pack200.Packer's + javadocs for more details.

    + +

    This task can be used to normalize a JAR in-place or to create a + new normalized JAR separate from the original JAR. The later + allows you to run <jar> + and <pack200normalize> in succession and the + "normalization" step wouldn't do anything unless the original jar + changed.

    + +

    If you want to normalize the JAR in-place, you must set the force + attribute to true as any file will always be up-to-date when + compared to itself.

    + +

    Parameters

    + + + + + + + + + + + + + + + + + + + + + +
    AttributeDescriptionRequired
    srcfilethe file to normalize.Yes.
    destfilethe normalized archive.No, defaults to the + srcfile.
    forceWhether to normalize the archive even if the + destfile seems up-to-date.No, defaults to false
    + +

    Parameters specified as nested elements

    + +

    property

    + +

    Sets a property for the packer (see the Pack200 javadocs for + details).

    + +

    Note this task implicitly sets the segment limit to -1.

    + + + + + + + + + + + + + + + + + +
    AttributeDescriptionRequired
    keyName of the property.Yes.
    valueValue of the property.Yes.
    + +

    Examples

    + +
    +    <cmp:pack200normalize destfile="foo-normalized.jar"
    +                 xmlns:cmp="antlib:org.apache.ant.compress"
    +                 srcfile="foo.jar">
    +      <property key="pack.effort" value="9"/>
    +    </cmp:pack200normalize>
    +  
    +

    Normalizes foo.jar where foo-normalized.jar is the + normalized archive. As both the normalization step and the actual + packing must use the same parameters the normalization prepares + for better compression results by using above than normal + effort.

    + +
    +    <cmp:pack200normalize force="true"
    +                 xmlns:cmp="antlib:org.apache.ant.compress"
    +                 srcfile="foo.jar"/>
    +  
    +

    Normalizes foo.jar in-place.

    + Propchange: ant/antlibs/compress/trunk/docs/pack200normalize.html ------------------------------------------------------------------------------ svn:eol-style = native