home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / recio213.zip / readme < prev    next >
Text File  |  1995-09-04  |  4KB  |  100 lines
  1. recio, Version 2.13, Release September 4, 1995.
  2. Copyright (C) 1994-1995, William Pierpoint.
  3.  
  4.  
  5. Description
  6. -----------
  7. The recio library consists of a set of a hundred functions that make it 
  8. easy to read and write text files in which each line is treated as a data 
  9. record, and each record is subdivided into fields.  Fields may be delimited 
  10. either by a character, such as a comma, or by column positions.  Field 
  11. types available are integer, unsigned integer, long, unsigned long, float, 
  12. double, time_t, struct tm, character, and string.  The learning curve is 
  13. rapidly traversed because (1) functions are based on analogous counterparts 
  14. in stdio and (2) function names are based on a consistent set of mnemonics.
  15.  
  16.  
  17. Getting Started
  18. ---------------
  19. First check the MANIFEST file for brief one line descriptions of the files 
  20. in this release.
  21.  
  22. Learning the recio functions will be easier if you read the documentation 
  23. in the following order:
  24.  
  25. TUTOR.TXT  - Introductory material including some simple example programs.
  26. USAGE.TXT  - Shows the typical order in which functions are used.
  27. SPEC.TXT   - Specification of all functions and macros.  Use as reference.
  28. TIPS.TXT   - Tips and ideas on using the recio functions.
  29. DESIGN.TXT - Design and development notes.
  30.  
  31. To save disk space, this package contains the executable for only one of 
  32. the test programs.  Source for other test programs is included.  To make 
  33. all the test programs, see MKTEST.BAT.  This package also contains the 
  34. libraries for only the small and large memory models.  To make libraries 
  35. for all memory models, see MKLIBS.BAT.
  36.  
  37. All you need to do to use the recio functions in your application is to
  38.  
  39. #include "recio.h"
  40.  
  41. in your source code and link using the recio library for the memory model 
  42. you are using.  For example, if using the small memory model, link with 
  43. RECIOS.LIB.  If you use a compiler other than Borland C 3.1, you will need 
  44. to recompile the source code.
  45.  
  46. If you use the recio library regularly, then you may wish to copy recio.h 
  47. to your compiler's INCLUDE directory and copy the recio libraries to your 
  48. compiler's LIBRARY directory.  You can then 
  49.  
  50. #include <recio.h>
  51.  
  52. in your source code and link to the recio library using the compiler's 
  53. default paths.
  54.  
  55.  
  56. Source Code
  57. -----------
  58. Complete C source code for recio is provided.  To recompile, you will need 
  59. an ANSI-C compatible compiler.  This release used Borland C 3.1.  MKLIBS.BAT 
  60. will generate all the libraries for this compiler.  Modify the MAKEFILE to 
  61. reflect your setup and to set the memory model.  To use another compiler, 
  62. you will need to generate libraries or object code for that compiler.  To 
  63. port to another compiler, you can find useful information in the file
  64. PORTABLE.
  65.  
  66.  
  67. Distribution
  68. ------------
  69. This is free software; you can redistribute it and/or modify it under the 
  70. terms of the GNU General Public License, Version 1, February 1989, as 
  71. published by the Free Software Foundation.
  72.  
  73. This software is distributed in the hope that it will be useful, but 
  74. WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 
  75. or FITNESS FOR A PARTICULAR PURPOSE.  More details on the GNU General 
  76. Public License can be found in the file COPYRITE.
  77.  
  78. You should have received a copy of the GNU General Public License along 
  79. with this program; if not, write to the Free Software Foundation, Inc., 
  80. 675 Mass Ave, Cambridge, MA 02139, USA.
  81.  
  82.  
  83. Archive
  84. -------
  85.  
  86. The latest public version of the recio library is available from the 
  87. SimTel software repository on the Internet.  It can be accessed via 
  88. anonymous ftp from ftp.coast.net (205.137.48.28), or from one of the 
  89. many SimTel mirror sites.  Look in directory SimTel/msdos/c.
  90.  
  91. For World Wide Web users, the ftp URL (uniform resource locator) is 
  92. ftp://ftp.coast.net/SimTel and the www URL is http://www.coast.net/SimTel.
  93.  
  94.  
  95. Contact
  96. -------
  97. Please send feedback to:
  98.  
  99.         73545.207@compuserve.com
  100.