home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_400 / 423_01 / recio200 / readme < prev    next >
Encoding:
Text File  |  1994-04-15  |  3.2 KB  |  84 lines
  1. recio, Version 2.00, Release April 15, 1994.
  2. Copyright (C) 1994, William Pierpoint.
  3.  
  4.  
  5. Description
  6. -----------
  7. The recio library consists of a set of more than 75 functions that make 
  8. it easy to read and write text files in which each line is treated as a 
  9. data record, and each record is subdivided into fields.  Fields may be 
  10. either character delimited or column delimited.  The learning curve is 
  11. rapidly traversed because (1) functions are based on analogous counterparts 
  12. in stdio and (2) function names are based on consistent mnemonics.
  13.  
  14. Getting Started
  15. ---------------
  16. First check the MANIFEST file for brief one line descriptions of the  
  17. files in this release.
  18.  
  19. Learning the recio functions will be easier if you read the documentation 
  20. in the following order:
  21.  
  22. TUTOR.TXT  - Introductory material including some simple example programs.
  23. USAGE.TXT  - Shows the typical order in which functions are used.
  24. SPEC.TXT   - Specification of all functions and macros.  Use as reference.
  25. TIPS.TXT   - Tips and ideas on using the recio functions.
  26. DESIGN.TXT - Design and development notes.
  27.  
  28. If you use the Borland C compiler, all you need to do to use the recio 
  29. functions in your application is to
  30.  
  31. #include "recio.h"
  32.  
  33. in your source code and link using the recio library for the memory 
  34. model you are using.  For example, if using the small memory model, 
  35. link with RECIOS.LIB.  See the echo, wc, and test example programs.  
  36. If you use another compiler, you will need to recompile the source 
  37. for your compiler.
  38.  
  39.  
  40. Source Code
  41. -----------
  42. Complete source code for recio is provided.  To recompile, you will need an 
  43. ANSI-C compatible compiler.  This release used Borland C 3.1.  MKLIBS.BAT 
  44. will generate all the libraries for this compiler.  Modify the MAKEFILE to 
  45. reflect your setup and to set the memory model.  To use another compiler, 
  46. you will need to generate libraries or object code for that compiler.
  47.  
  48.  
  49. Distribution
  50. ------------
  51. This is free software; you can redistribute it and/or modify it under the 
  52. terms of the GNU General Public License, Version 1, February 1989, as 
  53. published by the Free Software Foundation.
  54.  
  55. This software is distributed in the hope that it will be useful, but 
  56. WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 
  57. or FITNESS FOR A PARTICULAR PURPOSE.  Read the file COPYRITE for more 
  58. details on the GNU General Public License.
  59.  
  60. You should have received a copy of the GNU General Public License along 
  61. with this program; if not, write to the Free Software Foundation, Inc., 
  62. 675 Mass Ave, Cambridge, MA 02139, USA.
  63.  
  64.  
  65. Contact
  66. -------
  67. Please send feedback to:
  68.  
  69.         bill@anacapa.ncel.navy.mil
  70. or
  71.         Bill Pierpoint
  72.         1152 Harris Avenue
  73.         Camarillo, CA 93010-2921
  74.  
  75.  
  76. Preface to version 2.00
  77. -----------------------
  78. I was not planning to add output functionality to this package so soon, but 
  79. since it turned out that I had another week on my hands before my next contract 
  80. starts, here it is.  In order to keep the zip file down to a manageable size, 
  81. I have included only the executable of one test program, and the small and 
  82. large recio libraries.  The batch files MKLIBS.BAT and MKTEST.BAT make all 
  83. the libraries and all the test programs.
  84.