Return-Path: Delivered-To: apmail-ant-dev-archive@www.apache.org Received: (qmail 24283 invoked from network); 26 Jun 2007 03:55:57 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2) by minotaur.apache.org with SMTP; 26 Jun 2007 03:55:57 -0000 Received: (qmail 81093 invoked by uid 500); 26 Jun 2007 03:56:00 -0000 Delivered-To: apmail-ant-dev-archive@ant.apache.org Received: (qmail 81063 invoked by uid 500); 26 Jun 2007 03:56:00 -0000 Mailing-List: contact dev-help@ant.apache.org; run by ezmlm Precedence: bulk List-Unsubscribe: List-Help: List-Post: List-Id: "Ant Developers List" Reply-To: "Ant Developers List" Delivered-To: mailing list dev@ant.apache.org Received: (qmail 81052 invoked by uid 500); 26 Jun 2007 03:56:00 -0000 Received: (qmail 81049 invoked by uid 99); 26 Jun 2007 03:56:00 -0000 Received: from herse.apache.org (HELO herse.apache.org) (140.211.11.133) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 25 Jun 2007 20:56:00 -0700 X-ASF-Spam-Status: No, hits=-99.5 required=10.0 tests=ALL_TRUSTED,NO_REAL_NAME X-Spam-Check-By: apache.org Received: from [140.211.11.3] (HELO eris.apache.org) (140.211.11.3) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 25 Jun 2007 20:55:56 -0700 Received: by eris.apache.org (Postfix, from userid 65534) id 347A21A981A; Mon, 25 Jun 2007 20:55:36 -0700 (PDT) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r550671 - /ant/sandbox/antlibs/props/trunk/docs/index.html Date: Tue, 26 Jun 2007 03:55:36 -0000 To: ant-cvs@apache.org From: mbenson@apache.org X-Mailer: svnmailer-1.1.0 Message-Id: <20070626035536.347A21A981A@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: mbenson Date: Mon Jun 25 20:55:35 2007 New Revision: 550671 URL: http://svn.apache.org/viewvc?view=rev&rev=550671 Log: refine docs again Modified: ant/sandbox/antlibs/props/trunk/docs/index.html Modified: ant/sandbox/antlibs/props/trunk/docs/index.html URL: http://svn.apache.org/viewvc/ant/sandbox/antlibs/props/trunk/docs/index.html?view=diff&rev=550671&r1=550670&r2=550671 ============================================================================== --- ant/sandbox/antlibs/props/trunk/docs/index.html (original) +++ ant/sandbox/antlibs/props/trunk/docs/index.html Mon Jun 25 20:55:35 2007 @@ -47,58 +47,47 @@

There are several ways to use the tasks:

    -
  • The traditional way: +

  • The traditional way: 

    -          <taskdef 
-            resource="org/apache/ant/props/antlib.xml">
-            <classpath>
-              <pathelement location="YOUR-PATH-TO/ant-props.jar"/>
-            </classpath>
-          </taskdef>
+          <typedef resource="org/apache/ant/props/antlib.xml"
+                   classpath="YOUR-PATH-TO/ant-props.jar"/>
    - Using this approach the provided extensions will live in the default namespace. + Using this approach the provided extensions will live in the default namespace.

    • -
  • Similar, but assigning a namespace URI +

  • Similar, but assigning a namespace URI 

               <typedef uri="antlib:org.apache.ant.props"
-            resource="org/apache/ant/props/antlib.xml">
-            <classpath>
-              <pathelement location="YOUR-PATH-TO/ant-props.jar"/>
-            </classpath>
-          </taskdef>
+                   resource="org/apache/ant/props/antlib.xml"
+                   classpath="YOUR-PATH-TO/ant-props.jar"/>
    Placing the properties extensions into their own namespace, usable e.g.: 
    -          <project
-            xmlns:props="antlib:org.apache.ant.props"
-            xmlns="antlib:org.apache.tools.ant">
+          <project xmlns:props="antlib:org.apache.ant.props">
             ...
             <propertyhelper>
               <props:nested />
             </propertyhelper>
    - or a variation thereof. + or a variation thereof.

    • -
  • Using Ant's autodiscovery. Place ant-props.jar +

  • Using Ant's autodiscovery. Place ant-props.jar into a directory and use ant -lib DIR-CONTAINING-THE-JAR or copy it into ANT_HOME/lib - and then in your build file, simply declare the namespace on the project tag: 

    -          <project
-            xmlns:props="antlib:org.apache.ant.props">
+          <project xmlns:props="antlib:org.apache.ant.props">
    And all tasks of this library will automatically be available - in the props namespace without any - taskdef. + in the props namespace without any typedef.

@@ -106,12 +95,16 @@

The types provided are (so far) instances of org.apache.tools.ant.PropertyHelper.Delegate and can be invoked - using the <propertyhelper> task provided at the referenced Bugzilla entry: + using the <propertyhelper> task provided at the referenced Bugzilla entry:

    -
  • nested - Implements evaluation of nested Ant properties e.g. ${${double-expand-me}}.
    • -
  • stringops - Implements *nix shell-inspired string ops.
    • -
  • refs - Given ref:refid, expands to reference refid.
    • +
  • nested - Implements nested property expansion; e.g. ${${double-expand-me}}. +
    • +
  • stringops - Implements *nix shell-inspired string operations. +
    • +
  • refs - Given ref:refid, resolves reference + refid. +
  • types - Given type:arg, attempts to invoke type constructor (project, arg), then (arg). --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org For additional commands, e-mail: dev-help@ant.apache.org