Index: lemon/graph_reader.h
===================================================================
--- lemon/graph_reader.h	(revision 1534)
+++ lemon/graph_reader.h	(revision 1540)
@@ -37,9 +37,10 @@
   /// Before you read this documentation it might be useful to read the general
   /// description of  \ref graph-io-page "Graph Input-Output".
+  ///
   /// If you don't need very sophisticated
   /// behaviour then you can use the versions of the public function
   /// \ref readGraph() to read a graph (or a max flow instance etc).
   ///
-  /// The given file format may contain several maps and labeled nodes or 
+  /// The file to be read may contain several maps and labeled nodes or 
   /// edges.
   ///
@@ -47,7 +48,8 @@
   /// that you need. The interface of the \c GraphReader is very similar to
   /// the GraphWriter but the reading method does not depend on the order the
-  /// given commands.
-  ///
-  /// The reader object suppose that each not readed value does not contain 
+  /// given commands (i.e. you don't have to insist on the order in which the
+  /// maps are given in the file).
+  ///
+  /// The reader object assumes that not readed values do not contain 
   /// whitespaces, therefore it has some extra possibilities to control how
   /// it should skip the values when the string representation contains spaces.
@@ -91,9 +93,9 @@
   ///
   /// With the \c readAttribute() functions you can read an attribute
-  /// in a variable. You can specify the reader for the attribute as
+  /// into a variable. You can specify the reader for the attribute as
   /// the nodemaps.
   ///
   /// After you give all read commands you must call the \c run() member
-  /// function, which execute all the commands.
+  /// function, which executes all the commands.
   ///
   /// \code
@@ -120,5 +122,5 @@
     ///
     /// Construct a new GraphReader. It reads into the given graph
-    /// and it use the given reader as the default skipper.
+    /// and it uses the given reader as the default skipper.
     GraphReader(std::istream& _is, 
 		typename SmartParameter<Graph>::Type _graph, 
@@ -135,5 +137,5 @@
     ///
     /// Construct a new GraphReader. It reads into the given graph
-    /// and it use the given reader as the default skipper.
+    /// and it uses the given reader as the default skipper.
     GraphReader(const std::string& _filename, 
 		typename SmartParameter<Graph>::Type _graph, 
@@ -151,5 +153,5 @@
     ///
     /// Construct a new GraphReader. It reads into the given graph
-    /// and it use the given reader as the default skipper.
+    /// and it uses the given reader as the default skipper.
     GraphReader(LemonReader& _reader, 
 		typename SmartParameter<Graph>::Type _graph, 
@@ -171,7 +173,7 @@
     }
 
-    /// \brief Add a new node map reader command for the reader.
-    ///
-    /// Add a new node map reader command for the reader.
+    /// \brief Give a new node map reading command to the reader.
+    ///
+    /// Give a new node map reading command to the reader.
     template <typename Map>
     GraphReader& readNodeMap(std::string name, Map& map) {
@@ -186,7 +188,7 @@
     }
 
-    /// \brief Add a new node map reader command for the reader.
-    ///
-    /// Add a new node map reader command for the reader.
+    /// \brief Give a new node map reading command to the reader.
+    ///
+    /// Give a new node map reading command to the reader.
     template <typename Reader, typename Map>
     GraphReader& readNodeMap(std::string name, Map& map, 
@@ -203,7 +205,7 @@
     }
 
-    /// \brief Add a new node map skipper command for the reader.
-    ///
-    /// Add a new node map skipper command for the reader.
+    /// \brief Give a new node map skipping command to the reader.
+    ///
+    /// Give a new node map skipping command to the reader.
     template <typename Reader>
     GraphReader& skipNodeMap(std::string name, 
@@ -213,7 +215,7 @@
     }
 
-    /// \brief Add a new edge map reader command for the reader.
-    ///
-    /// Add a new edge map reader command for the reader.
+    /// \brief Give a new edge map reading command to the reader.
+    ///
+    /// Give a new edge map reading command to the reader.
     template <typename Map>
     GraphReader& readEdgeMap(std::string name, Map& map) { 
@@ -229,7 +231,7 @@
 
 
-    /// \brief Add a new edge map reader command for the reader.
-    ///
-    /// Add a new edge map reader command for the reader.
+    /// \brief Give a new edge map reading command to the reader.
+    ///
+    /// Give a new edge map reading command to the reader.
     template <typename Reader, typename Map>
     GraphReader& readEdgeMap(std::string name, Map& map,
@@ -246,7 +248,7 @@
     }
 
-    /// \brief Add a new edge map skipper command for the reader.
-    ///
-    /// Add a new edge map skipper command for the reader.
+    /// \brief Give a new edge map skipping command to the reader.
+    ///
+    /// Give a new edge map skipping command to the reader.
     template <typename Reader>
     GraphReader& skipEdgeMap(std::string name, 
@@ -256,7 +258,7 @@
     }
 
-    /// \brief Add a new labeled node reader for the reader.
-    ///
-    /// Add a new labeled node reader for the reader.
+    /// \brief Give a new labeled node reading command to the reader.
+    ///
+    /// Give a new labeled node reading command to the reader.
     GraphReader& readNode(std::string name, Node& node) {
       node_reader.readNode(name, node);
@@ -264,7 +266,7 @@
     }
 
-    /// \brief Add a new labeled edge reader for the reader.
-    ///
-    /// Add a new labeled edge reader for the reader.
+    /// \brief Give a new labeled edge reading command to the reader.
+    ///
+    /// Give a new labeled edge reading command to the reader.
     GraphReader& readEdge(std::string name, Edge& edge) {
       edge_reader.readEdge(name, edge);
@@ -272,7 +274,7 @@
     }
 
-    /// \brief Add a new attribute reader command.
-    ///
-    ///  Add a new attribute reader command.
+    /// \brief Give a new attribute reading command.
+    ///
+    ///  Give a new attribute reading command.
     template <typename Value>
     GraphReader& readAttribute(std::string name, Value& value) {
@@ -281,7 +283,7 @@
     }
     
-    /// \brief Add a new attribute reader command.
-    ///
-    ///  Add a new attribute reader command.
+    /// \brief Give a new attribute reading command.
+    ///
+    ///  Give a new attribute reading command.
     template <typename Reader, typename Value>
     GraphReader& readAttribute(std::string name, Value& value, 
@@ -293,15 +295,15 @@
     /// \brief Conversion operator to LemonReader.
     ///
-    /// Conversion operator to LemonReader. It make possible
-    /// to access the encapsulated \e LemonReader, this way
-    /// you can attach to this reader new instances of 
-    /// \e LemonReader::SectionReader.
+    /// Conversion operator to LemonReader. It makes possible to access the
+    /// encapsulated \e LemonReader, this way you can attach to this reader
+    /// new instances of \e LemonReader::SectionReader. For more details see
+    /// the \ref rwbackground "Background of Reading and Writing".
     operator LemonReader&() {
       return *reader;
     }
 
-    /// \brief Executes the reader commands.
-    ///
-    /// Executes the reader commands.
+    /// \brief Executes the reading commands.
+    ///
+    /// Executes the reading commands.
     void run() {
       reader->run();
@@ -433,11 +435,19 @@
   /// \brief The undir graph reader class.
   ///
+  /// The \c UndirGraphReader class provides the graph input. 
+  /// Before you read this documentation it might be useful to read the general
+  /// description of  \ref graph-io-page "Graph Input-Output".
+  ///
+  /// If you don't need very sophisticated
+  /// behaviour then you can use the versions of the public function
+  /// \ref readGraph() to read a graph (or a max flow instance etc).
+  ///
   /// The given file format may contain several maps and labeled nodes or 
   /// edges.
   ///
   /// If you read a graph you need not read all the maps and items just those
-  /// that you need. The interface of the \c GraphReader is very similar to
-  /// the GraphWriter but the reading method does not depend on the order the
-  /// given commands.
+  /// that you need. The interface of the \c UndirGraphReader is very similar
+  /// to the UndirGraphWriter but the reading method does not depend on the
+  /// order of the given commands.
   ///
   /// The reader object suppose that each not readed value does not contain 
@@ -570,7 +580,7 @@
     }
 
-    /// \brief Add a new node map reader command for the reader.
-    ///
-    /// Add a new node map reader command for the reader.
+    /// \brief Give a new node map reading command to the reader.
+    ///
+    /// Give a new node map reading command to the reader.
     template <typename Map>
     UndirGraphReader& readNodeMap(std::string name, Map& map) {
@@ -585,7 +595,7 @@
     }
 
-    /// \brief Add a new node map reader command for the reader.
-    ///
-    /// Add a new node map reader command for the reader.
+    /// \brief Give a new node map reading command to the reader.
+    ///
+    /// Give a new node map reading command to the reader.
     template <typename Reader, typename Map>
     UndirGraphReader& readNodeMap(std::string name, Map& map, 
@@ -602,7 +612,7 @@
     }
 
-    /// \brief Add a new node map skipper command for the reader.
-    ///
-    /// Add a new node map skipper command for the reader.
+    /// \brief Give a new node map skipping command to the reader.
+    ///
+    /// Give a new node map skipping command to the reader.
     template <typename Reader>
     UndirGraphReader& skipNodeMap(std::string name, 
@@ -612,7 +622,7 @@
     }
 
-    /// \brief Add a new undirected edge map reader command for the reader.
-    ///
-    /// Add a new undirected edge map reader command for the reader.
+    /// \brief Give a new undirected edge map reading command to the reader.
+    ///
+    /// Give a new undirected edge map reading command to the reader.
     template <typename Map>
     UndirGraphReader& readUndirEdgeMap(std::string name, Map& map) { 
@@ -628,7 +638,7 @@
 
 
-    /// \brief Add a new undirected edge map reader command for the reader.
-    ///
-    /// Add a new undirected edge map reader command for the reader.
+    /// \brief Give a new undirected edge map reading command to the reader.
+    ///
+    /// Give a new undirected edge map reading command to the reader.
     template <typename Reader, typename Map>
     UndirGraphReader& readUndirEdgeMap(std::string name, Map& map,
@@ -645,7 +655,7 @@
     }
 
-    /// \brief Add a new undirected edge map skipper command for the reader.
-    ///
-    /// Add a new undirected edge map skipper command for the reader.
+    /// \brief Give a new undirected edge map skipping command to the reader.
+    ///
+    /// Give a new undirected edge map skipping command to the reader.
     template <typename Reader>
     UndirGraphReader& skipUndirEdgeMap(std::string name,
@@ -656,7 +666,7 @@
 
 
-    /// \brief Add a new edge map reader command for the reader.
-    ///
-    /// Add a new edge map reader command for the reader.
+    /// \brief Give a new edge map reading command to the reader.
+    ///
+    /// Give a new edge map reading command to the reader.
     template <typename Map>
     UndirGraphReader& readEdgeMap(std::string name, Map& map) { 
@@ -672,7 +682,7 @@
 
 
-    /// \brief Add a new edge map reader command for the reader.
-    ///
-    /// Add a new edge map reader command for the reader.
+    /// \brief Give a new edge map reading command to the reader.
+    ///
+    /// Give a new edge map reading command to the reader.
     template <typename Reader, typename Map>
     UndirGraphReader& readEdgeMap(std::string name, Map& map,
@@ -689,7 +699,7 @@
     }
 
-    /// \brief Add a new edge map skipper command for the reader.
-    ///
-    /// Add a new edge map skipper command for the reader.
+    /// \brief Give a new edge map skipping command to the reader.
+    ///
+    /// Give a new edge map skipping command to the reader.
     template <typename Reader>
     UndirGraphReader& skipEdgeMap(std::string name,
@@ -699,7 +709,7 @@
     }
 
-    /// \brief Add a new labeled node reader for the reader.
-    ///
-    /// Add a new labeled node reader for the reader.
+    /// \brief Give a new labeled node reading command to the reader.
+    ///
+    /// Give a new labeled node reading command to the reader.
     UndirGraphReader& readNode(std::string name, Node& node) {
       node_reader.readNode(name, node);
@@ -707,21 +717,22 @@
     }
 
-    /// \brief Add a new labeled edge reader for the reader.
-    ///
-    /// Add a new labeled edge reader for the reader.
+    /// \brief Give a new labeled edge reading command to the reader.
+    ///
+    /// Give a new labeled edge reading command to the reader.
     UndirGraphReader& readEdge(std::string name, Edge& edge) {
       undir_edge_reader.readEdge(name, edge);
     }
 
-    /// \brief Add a new labeled undirected edge reader for the reader.
-    ///
-    /// Add a new labeled undirected edge reader for the reader.
+    /// \brief Give a new labeled undirected edge reading command to the
+    /// reader.
+    ///
+    /// Give a new labeled undirected edge reading command to the reader.
     UndirGraphReader& readUndirEdge(std::string name, UndirEdge& edge) {
       undir_edge_reader.readUndirEdge(name, edge);
     }
 
-    /// \brief Add a new attribute reader command.
-    ///
-    ///  Add a new attribute reader command.
+    /// \brief Give a new attribute reading command.
+    ///
+    ///  Give a new attribute reading command.
     template <typename Value>
     UndirGraphReader& readAttribute(std::string name, Value& value) {
@@ -730,7 +741,7 @@
     }
     
-    /// \brief Add a new attribute reader command.
-    ///
-    ///  Add a new attribute reader command.
+    /// \brief Give a new attribute reading command.
+    ///
+    ///  Give a new attribute reading command.
     template <typename Reader, typename Value>
     UndirGraphReader& readAttribute(std::string name, Value& value, 
@@ -750,7 +761,7 @@
     }
 
-    /// \brief Executes the reader commands.
-    ///
-    /// Executes the reader commands.
+    /// \brief Executes the reading commands.
+    ///
+    /// Executes the reading commands.
     void run() {
       reader->run();
