Ticket #157: 190aec58b29c.patch

doc/migration.dox

@@ -57 +57 @@
 the words \c graph, \c digraph, \c edge and \c arc, so it replaces them
 in strings, comments etc. as well as in all identifiers.</b>
 
-\section migration-lgf LGF tools
+\section migration-lgf LGF tools 
+ - The \ref lgf-format "LGF file format" changed, the
+   <tt>\@nodeset</tt> is changed to <tt>\@nodes</tt>, the
+   <tt>\@edgeset</tt> and <tt>\@uedgeset</tt> to <tt>\@arcs</tt> or
+   <tt>\@edges</tt>, which are completely equivalents. The
+   <tt>\@nodes</tt>, <tt>\@edges</tt> and <tt>\@uedges</tt> are
+   removed from the format, the content of these sections should be
+   moved into the <tt>\@attributes</tt> section. The data fields in
+   the sections must follow a strict format, they must be character
+   sequences without whitespaces or quoted strings.
+ - The <tt>LemonReader</tt> and <tt>LemonWriter</tt> core interfaces
+   are removed from the LEMON.
+ - The section readers and writers are supported with different
+   interface, they should be written as functors. Beside the old
+   stream based section handling, currently line oriented section
+   reading and writing are also supported. Unfortunately, in the
+   section readers the lines should be counted manually. The sections
+   should be read and write with the SectionWriter and SectionReader
+   classes.
+ - Instead of the item readers and writers item converters should be
+   used. The converters are functors, which map the type to
+   std::string or std::string to the type. The converters for standard
+   containers are not implemented yet in the new LEMON. The converters
+   can return strings in any format, because if it necessary, the LGF
+   writer and reader will quote and unquote the given value.
+ - The DigraphReader and DigraphWriter are usable similarly as in the
+   0.x series, however the <tt>read</tt> or <tt>write</tt> prefix of
+   the member functions are removed.
+ - The new LEMON supports the function like interface, the \c
+   digraphReader and \c digraphWriter functions are more convenient than
+   using the classes directly.
 
 \section migration-search BFS, DFS and Dijkstra
 - <b>Using the function interface of BFS, DFS and %Dijkstra both source and