helm/DEVEL/pxp/pxp/compatibility/README

   1 This directory contains the modules for Markup-0.2.10
   2 compatibility. The modules consist mainly of wrapper classes for the
   3 new PXP classes, and translate the old methods to the new ones.
   4
   5 Please note that the compatibility is not perfect. Sometimes there are
   6 new methods which do not exist in Markup-0.2.10, and sometimes even
   7 existing methods changed their signature. I have tried to avoid that,
   8 but there are some ugly cases which are hard to solve without such
   9 modifications.
  10
  11 Translating old methods into new methods costs time and
  12 memory. Because of this, it is best to consider the compatibility
  13 modules as migration path to PXP: You can test whether PXP parses your
  14 input files, and you can compare the old API with the new API
  15 directly. (However, it is hard to test new features of PXP with the
  16 compatibility modules; the old API does not reflect the new features.)
  17
  18 The compatibility modules are currently maintained, but that will stop
  19 once PXP has been established.
  20
  21 (Gerd)