JWare/AntXtras PEd4Ant
                     Version 1.0.0, Release Aug 2011
                   -----------------------------------


This document contains the major PEd4Ant version change notes. For the most
recent information, visit the website at http://antxtras.sourceforge.net.

------------------------------------------------------------------------------

CHANGES IN 1.0.0:

=> Rebuilt against final AntXtras v3.0.0 distribution with Ant 1.8.2.

=> Added the <flip> action item. Use with the <ped:editproperties>
   component to do a wholesale swap between keys and values. FS#248

------------------------------------------------------------------------------
CHANGES IN 1.0.0b2

- Enhanced <ped:testproperties> to support a 'hitproperty' option. Unlike
  the existing 'countproperty' this property is added IF AND ONLY IF
  there is at least one match for the test expression. The value is set
  to the number of hits.

- Enhanced the <select> action to have its own 'hitproperty' option that
  is set independent of the parent <ped:readproperties> or 
  <ped:testproperties>. FS#206.

- Completed implementation of <ped:mergeloadproperties>. You can now define
  a single filterchain, automatically expand property references, and mark
  the loaded properties object as readonly. FS#215.

- Fixed bug where the 'ordering' option for <insert> action did not work
  if the 'before' option was also defined. FS#258.

------------------------------------------------------------------------------
CHANGES IN 1.0.0b1-3

- [BREAKING CHANGE] PEd4Ant is now compiled against the early AntXtras v3
  release. This release requires JRE 1.5 and Ant 1.8 RC or nightly build.

- [BREAKING CHANGE] The default antlib file is now the namespace-expecting
   antlib (was 'antlib-ns.xml'). The previous antlib is now defined
   under 'antlib-nons.xml'

- Enhanced <ped:loadproperties> so you can read from XML-formatted source
  files. Automatic backups will copy the source's formats. Requires a 
  1.5 or later JRE.

- Enhanced <ped:saveproperties> so you can give it an different output file
  from source. Also works for non-file based sources like memory or URLs.

- Enhanced <ped:saveproperties> so you can tell it what to do if the source
  file has changed since the last save (or initial load if no edits done).
  Options are: "ignore", "reject" (don't save), or "balk" (script error)

- Enhanced <ped:saveproperties> so you can force it to re-baseline the loaded
  properties object (even if you save to a different output from source).

- Enhanced <ped:saveproperties> so it can write XML-formatted files as well
  as standard properties format.

- Enhanced <ped:loadproperties> so you can specify a single nested filter
  chain. The chain is applied to input stream on load (before any processing
  by the load itself-- see new 'expandpropertyrefs' option).

- Enhanced <ped:loadproperties> so you can automatically expand property
  references against the current Ant fixture as well as the loaded properties
  themselves. This operation is slightly different from using the standard
  <expandproperties> filter as it includes the loaded properties for value
  lookup (the standard filter does not-- it only knows about Ant's regular
  properties).

- Enhanced <ped:loadproperties> and <ped:makeproperties> with a new 
  'readonly' option. If set, this prevent *ANY* additional memory 
  modifications to the loaded properties.

- Fixed the auto backup function in the <ped:loadproperties> task. Now the 
  backup file is named as '{original}#.bak' where '{original}' is the source
  file's name including extension and '#' is an increasing integer that makes
  the name unique at the file system location; for example for a source
  file 'run.properties' => 'run.properties1.bak' and 'run.properties2.bak'.

- Added a "$ped:" function shortcut that lets you extract certain bits of
  readonly information about a loaded properties definition. You can, for
  example, use the 'ismodified' selector as part of a condition evaluation.
  Supported selectors are: ismodified, linecount, propertycount, and isempty.

- Enhanced the <insert> and <update> actions to allow you to nest value
  content as a nested element to permit CDATA and other strings not permitted
  in an attribute's value.

- Updated the <select> action to match the <update> action with a distinct
  key and value mapper so you can change keys while selecting on value
  matches and vice-versa.

- Enhanced the <select> action to support its own 'hitproperty'. Now you 
  can set different match properties for each distinct select action 
  within a single <ped:editproperties> or <ped:readproperties>.

- Added the simplified <ped:diffproperties> command. Lets you create terse
  property diff reports for two loaded properties. Note that blanks and
  comments are ignored for diffs.

- Added the missing <rename> edit action that is a shortcut for updating
  an existing property's name to something different.

- Enhanced <remove> so you can remove blank lines (whitespace without
  property names).

- Added a new <clear> edit action that lets you remove *ALL* of the lines
  of a loaded properties objects (properties, blanks, comments, everything).

- Added the missing 'ordering' option to the <insert> edit action for
  property sets as shown in the PEd4Ant Overview examples.

- Fixed a number of bugs against the 1.0.0b1 releases.

-SSMC