JWare/AntXtras PEd4Ant
                    Version 1.0.0b2, Release Apr 2010
                   -----------------------------------


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

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

CHANGES SINCE 1.0.0b1-3

- [BREAKING CHANGE] PEd4Ant is now compiled against the early AntXtras v3
  release. This release requires a 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