README.rdoc in dwc-archive-0.1.6 vs README.rdoc in dwc-archive-0.2.0

@@ -20,9 +20,31 @@
     dwc.core.data          # summary of DarwinCore main file
     dwc.core.file_path     # path to the DarwinCore main file
     dwc.extensions         # array of DarwinCore Star extensions
     dwc.extensions[0].data # summary for an extension
 
+    # read content of the core data file into memory or used with a block
+    # it returns array of arrays of data
+    # rows that had a wrong encoding will be collected into errors array
+    data, errors = dwc.core.read 
+
+    # read content using a block with getting back results in sets 100 rows each
+    results = []
+    tail_data, tail_errors = dwc.core.read(100) do |data, errors|
+      results << [data, errors]
+    end
+    results << [tail_data, tail_errors]
+
+    # read content of an extension data file into memory
+    data, errors = dwc.core.extensions[0].read
+
+    # read content of an extension data using block
+    results = []
+    tail_data, tail_errors = dwc.core.extensions[0](100) do |data, errors|
+      results << [data, errors]
+    end
+    results << [tail_data, tail_errors]
+
     DarwinCore.clean_all   # remove all expanded archives
 
 == Note on Patches/Pull Requests
  
 * Fork the project.