home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / mac / util / develope / mgawk211.cpt / MACINTOSH.README < prev   
Text File  |  1991-08-18  |  5KB  |  127 lines
  1. This file is the README for MacGawk patch 4:
  2.  
  3. **NOTE - this release is about 9 months late. For those who were 
  4. depending on me to maintain a timely update schedule, I apologize. My 
  5. personal life and my professional life have been in an uproar that is 
  6. only slightly subsiding.
  7.  
  8. New
  9.  
  10. This release is mostly bug fixes and cosmetic updates. The ability to run 
  11. multiple scripts without re-launching is not included due to problems 
  12. with memory management and the cconsole() code from Symantec.
  13.  
  14. Bugs fixed:
  15.  
  16. Regular expressions no longer exhaust memory.
  17.  
  18. The NF builtin is now correctly calculated.
  19.  
  20. The split() function now works.
  21.  
  22. Temporary files now deleted after gawk exits.
  23.  
  24. About GNU awk for the Macintosh...
  25.  
  26. This is GNU awk, gawk, for the Macintosh. For those who don╒t know, GNU
  27. stands for GNU╒s Not UNIX, an as-yet unfinished operating system,and is
  28. the primary goal of the Free Software Foundation. The FSF has publically
  29. condemned Apple Computer for it╒s litigation in defense of perceived
  30. copyrights. The FSF, therefore, has no knowledge of the existence of this
  31. gawk version, and would not support it if it did. Do not report bugs or
  32. make any other contact with FSF concerning Macintosh gawk.
  33.     
  34. Why Macintosh gawk exists
  35.  
  36. gawk for the Macintosh exists for a number of reasons. First, I use gawk
  37. extensively as part of my day to day work activities and wanted to have
  38. it at home. Second, I was looking for a project in C to work on at home
  39. to learn Mac programming. And third, it was a challenge. I have every
  40. intention of following the GNU copyleft, meaning that I can not sell gawk
  41. itself ( I could conceivably charge for support ) for profit and must
  42. also make full source available.
  43.     
  44. Macintosh gawk is Free Software
  45.  
  46. I do not charge for gawk. It is free software, not shareware or public
  47. domain. I encourage you to read the documents that describe the GNU
  48. Public License, or GPL so that you understand what this means.
  49.     
  50. Differences from UNIX gawk
  51.  
  52. Macinstosh gawk lacks some features that UNIX-like systems provide. These
  53. features include pipes and multiple processes. Mac gawk will quit when
  54. source programs invoke these functions. I caution against redirecting
  55. input and output in getline and print/printf calls. All other features
  56. should work the same. Read the Macintosh Supplement.mw document for
  57. details.
  58.     
  59. Macintosh caveats
  60.         
  61. Multifinder
  62.  
  63. Mac gawk will run under Multifinder, but is not particularly MF adapted.
  64. It is set to use a partition size of 768K but large input files may
  65. require more, much more. Operation under Finder should be fine.
  66.         
  67. Command Line
  68.  
  69. Macintosh gawk uses the THINK C ccommand interface. This provides a
  70. dialog box that allows the user to enter UNIX shell-like command lines.
  71. Redirection of input and output is done with radio buttons.
  72.         
  73. TEXT Files Mac gawk reads and writes standard Macintosh TEXT files. To
  74. use word processor files, it will be necessary to save them as TEXT first.
  75.     
  76. Behind the scenes
  77.  
  78. Compilation Mac gawk was compiled using THINK C 4.0.2 on a 4M Mac+
  79. running System 6.0.7. gawk requires bison to generate the awk.tab.c file.
  80. This is generally only required when making changes in the actual awk
  81. language. The source files were converted to comply with the ANSI
  82. standard ( as THINK defines it ) and makes full use of function prototypes.
  83.         
  84. The author
  85.  
  86. I╒m not really the author, I just did the porting. My name is Tom
  87. Maszerowski, I work as a software engineer for Moscom, Inc. in Pittsford,
  88. NY. Moscom is nice enough to allow me email and UUCP acccess and I thank
  89. them, but there are no guarantees. Thanks to my wife as well, for
  90. allowing me the time at home to do this.
  91.     
  92. Bugs and updates
  93.  
  94. Please do not contact the FSF concerning this version of gawk. I expect
  95. to be the sole point of contact for bugs and source code updates. I
  96. monitor the GNU groups on NETNEWS and will try to incorporate them as
  97. needed. If you make changes to the gawk source you feel will benefit
  98. others send them to me.
  99.     
  100. Addresses
  101.  
  102. I can be reached at the following email addresses:
  103.                               tcm@moscom.com
  104.                    {rit,tropix,ur-valhalla}!moscom!tcm
  105.  
  106. Mail delivery is usually quite good and I try to respond in a timely
  107. fashion ( although timely is a subjective term ).
  108.  
  109. Manual
  110.  
  111. The manual with a supplement is found in the "gawk Manual.mw" and
  112. "Macintosh Supplement.mw" files. The manual was made by converting the
  113. original texinfo file to to nroff and then to text. The text was then
  114. converted to MacWrite5.0 format for the release. I tried to keep 
  115. pagination correct but this may change based on the device you print to.
  116.  
  117. Directions
  118.  
  119. The source should be stripped of non-Mac code, since it seems unlikely that 
  120. someone without a Mac would grab this source code. 
  121.  
  122. Memory allocation problems should be fixed, possibly with replacement of 
  123. the THINK malloc() calls with something else.
  124.  
  125. Real Mac interface would be nice, possibly using Prototyper ( this 
  126. presents a problem with source distribution since Prototyper-produced 
  127. code requires libraries that cannot be given away ).