[q-lang-cvs] q-csv README,1.5,1.6

[Albert G. <ag...@us...>]

Update of /cvsroot/q-lang/q-csv
In directory sc8-pr-cvs16.sourceforge.net:/tmp/cvs-serv509

Modified Files:
	README 
Log Message:
elaborate on different kinds of available interface functions

Index: README
===================================================================
RCS file: /cvsroot/q-lang/q-csv/README,v
retrieving revision 1.5
retrieving revision 1.6
diff -C2 -d -r1.5 -r1.6
*** README	10 Jan 2008 23:14:46 -0000	1.5
--- README	10 Jan 2008 23:41:21 -0000	1.6
***************
*** 8,12 ****
  that allow field delimiters and quote delimiters to be changed.
  
! Two variants of reading and writing are available:
  
  - freadcsv_data converts non-quoted numeric fields to integer or double values
--- 8,29 ----
  that allow field delimiters and quote delimiters to be changed.
  
! INSTALLATION
! 
! This module is (or will soon be) included in the binary "all in one" packages
! available from the Q website. Use these if you can. To install from the
! sources, run 'make' to compile the module and 'make install' (as root) to
! install it under the default prefix (/usr/local). If your Q installation lives
! elsewhere (e.g., under /usr), you can specify the installation prefix as
! follows: 'make prefix=/usr install'. (It is recommended to install the module
! under the same prefix as the Q interpreter so that the interpreter can find
! the module. Otherwise you might have to modify your QPATH accordingly.)
! 
! USAGE
! 
! Data records are represented as tuples of strings and numeric data. Two
! variants of reading and writing are available. Basically, the functions whose
! names end in _data will convert numeric (integer and floating point) values
! automatically, while the _string variants will treat them as ordinary (string)
! data. More precisely:
  
  - freadcsv_data converts non-quoted numeric fields to integer or double values
***************
*** 19,34 ****
    fwritecsv_string writes all values as quoted fields.
  
! INSTALLATION
  
! This module is (or will soon be) included in the binary "all in one" packages
! available from the Q website. Use these if you can.
  
! To install from the sources, run 'make' to compile the module and 'make
! install' (as root) to install it under the default prefix (/usr/local). If
! your Q installation lives elsewhere (e.g., under /usr), you can specify the
! installation prefix as follows: 'make prefix=/usr install'. (It is recommended
! to install the module under the same prefix as the Q interpreter so that the
! interpreter finds the module. Otherwise you might have to modify your QPATH
! accordingly.)
  
  NOTES
--- 36,51 ----
    fwritecsv_string writes all values as quoted fields.
  
! The primary interface functions freadcsv and fwritecsv are defined to be
! equivalent to the _data variants by default. If necessary, you can change this
! by adding appropriate definitions to your program, i.e.:
  
! freadcsv = freadcsv_string;
! fwritecsv = fwritecsv_string;
  
! The routines described above read/write one record at a time. Additional
! functions (freadfilecsv and fwritefilecsv, again with corresponding _data and
! _string variants) are provided to convert between entire CSV files and lists
! of tuples. Note that these require that the entire data fits into RAM and will
! thus be inefficient for huge datasets.
  
  NOTES