home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / PROG_C / RECIO110.ZIP / README < prev    next >
Text File  |  1994-03-28  |  3KB  |  89 lines
  1. recio, Version 1.10, Release March 28, 1994.
  2. Copyright (C) 1994, William Pierpoint.
  3.  
  4.  
  5. Description
  6. -----------
  7. The recio library consists of a set of more than 50 functions and macros 
  8. that make it easy to read a file in which each line is treated as a data 
  9. record, and each record is subdivided into fields.  Fields may be either 
  10. character delimited or column delimited.  The learning curve is rapidly 
  11. traversed as many functions are based on analogous counterparts in stdio.  
  12.  
  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.  The MAKEFILE 
  44. will regenerate 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
  77. -------
  78. In some of my spare time over the past several years I have defined and 
  79. refined the recio library.  It is blue-collar code--not sophisicated,  
  80. glamorous, or whiz-bang--but it does the dirty work that needs to be done.
  81. If you have to develop C code that reads data from old legacy programs, 
  82. the recio library may be just what you need.
  83.  
  84. For this release I've documented and cleaned up my working code.  Some 
  85. portions of the code were redesigned and rewritten, so while I can always 
  86. hope I've found all the bugs, the laws of probability are not in my favor.
  87. But if it is not perfect, may you find it as flawless as an Olympics 
  88. Silver Medal ice-skating performance!
  89.