Further extension of the migration guide
authorAlpar Juttner <alpar@cs.elte.hu>
Wed, 08 Oct 2008 14:21:01 +0100
changeset 30747ec522b838e
parent 306 2bf7c645d5a6
child 308 dd4f08b7e203
Further extension of the migration guide
doc/mainpage.dox
doc/migration.dox
     1.1 --- a/doc/mainpage.dox	Wed Oct 08 11:38:31 2008 +0200
     1.2 +++ b/doc/mainpage.dox	Wed Oct 08 14:21:01 2008 +0100
     1.3 @@ -56,5 +56,5 @@
     1.4  <a class="el" href="modules.html">Modules</a>
     1.5  section.
     1.6  
     1.7 -
     1.8 +If you are a user of the old (0.x) series of LEMON, please check out the \ref migration "Migration Guide" for the backward incompatibilities.
     1.9  */
     2.1 --- a/doc/migration.dox	Wed Oct 08 11:38:31 2008 +0200
     2.2 +++ b/doc/migration.dox	Wed Oct 08 14:21:01 2008 +0100
     2.3 @@ -77,21 +77,29 @@
     2.4  
     2.5  \section migration-error Exceptions and Debug tools
     2.6  
     2.7 +<b>The class hierarchy of exceptions has largely been simplified. Now,
     2.8 +only the i/o related tools may throw exceptions. All other exceptions
     2.9 +have been replaced with either the \c LEMON_ASSERT or the \c LEMON_DEBUG
    2.10 +macros.</b>
    2.11 +
    2.12 +<b>On the other hand, the parameter order of constructors of the
    2.13 +exceptions has been changed. See \ref IoError and \ref FormatError for
    2.14 +more details.</b>
    2.15 +
    2.16  \section migration-other Others
    2.17  - <b>The contents of <tt>graph_utils.h</tt> are moved to <tt>core.h</tt>
    2.18    and <tt>maps.h</tt>. <tt>core.h</tt> is included by all graph types,
    2.19    therefore it usually do not have to be included directly.</b>
    2.20  - <b><tt>path_utils.h</tt> is merged to \c path.h.</b>
    2.21 +- <b>The semantic of the assignment operations and copy constructors of maps
    2.22 +  are still under discussion. So, you must copy them by hand (i.e. copy
    2.23 +  each entry one-by-one)</b>
    2.24  - <b>The parameters of the graph copying tools (i.e. \c GraphCopy,
    2.25    \c DigraphCopy) have to be given in the from-to order.</b>
    2.26  - \c copyDigraph() and \c copyGraph() are renamed to \c digraphCopy()
    2.27    and \c graphCopy(), respectively.
    2.28 -- The of
    2.29 - - DefXyzMap --> SetXyzMap
    2.30 - - DefHeap --> SetHeap
    2.31 - - DefStandardHeap --> SetStandardHeap
    2.32 - - DefOperationTraits --> SetOperationTraits
    2.33 - - DefProcessedMapToBeDefaultMap --> SetStandardProcessedMap
    2.34 +- <b>The interface of \ref DynArcLookUp has changed. It is now the same as
    2.35 +  of \ref ArcLookUp and \ref AllArcLookUp</b>
    2.36  - Some map types should also been renamed. Namely,
    2.37    - \c IntegerMap -> \c RangeMap
    2.38    - \c StdMap -> \c SparseMap