home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / s / sed15.zip / README < prev    next >
Text File  |  1991-10-01  |  5KB  |  144 lines

  1. SED (AKA HHSED)                        2 Oct 91
  2.  
  3. This all started with a port of sed (SIMTEL20's PD:<MSDOS.TXTUTL>SED.ARC)
  4. to TC 2.0. I was basically thrashing in the dark with NO idea what sed
  5. was *really* supposed to do.  (I only wanted something to work with shar
  6. files.)
  7.  
  8. It worked .. kinda .. and I threw it back up on SIMTEL20 as SED12.ZIP.
  9. Then Howard L. Helman (h**2) found it, discovered it wouldn't compile
  10. with BCC++, and jumped in with a truly massive, detailed rewrite
  11. (his HHSED contribution).
  12.  
  13. It's all integrated now and appears to work in MS-DOS as compiled
  14. by various flavors of Borland compilers.
  15.  
  16. I am *not* a sed wizard:  I'm only putting this sucker together
  17. and fielding it to the world.  For details, you need to get with
  18. Howard.
  19.  
  20. There's room for improvement:  see the documentation.
  21.  
  22. There's competition (the GNU sed).  Differences between them and us?
  23. Beats me.  Who's best?  Who knows.
  24.  
  25. This would be public domain, except people keep *stealing* from the
  26. public domain, copyrighting it as their own, and restricting the rest
  27. of us from using it again.  With that filthy, gods-cursed problem in
  28. mind, I'll copyright this sucker for the original author, me and h**2,
  29. just to keep the wicked in line.
  30.  
  31. You, Dear Reader, may do *anything* you wish with it except steal it.
  32.  
  33. Copyright (c) 1991 Eric S. Raymond, David P Kirschbaum & Howard L. Helman
  34. All Rights Reserved
  35.  
  36. David Kirschbaum
  37. Toad Hall
  38. kirsch@usasoc.soc.mil
  39.  
  40. === Recent History and Comments ===
  41.  
  42. Return-Path: <helman@elm.sdd.trw.com>
  43. Date: Mon, 23 Sep 91 09:24:22 PDT
  44. From: helman@elm.sdd.trw.com (Howard L. Helman)
  45.  
  46. This archive contains my update to the sed stream editor.
  47.  
  48. The following files should be in the archive:
  49.    1. sed.h       -- source header file 
  50.    2. sedcomp.c   -- source C command compiler
  51.    3. sedexec.c   -- source C sed execution code
  52.    4. README      -- this file
  53.  
  54. TC 2.0-related files (TC20.ZIP)
  55.    1. TCCONFIG.TC -- TC v2.0 config file
  56.    2. SED.PRJ     -- TC v2.0 project file
  57.  
  58. Document-related files (DOCS.ZIP)
  59.    1. sed.tex    -- documentation in LaTex format
  60.    2. sed.sty    -- style file for LaTex document
  61.    3. sed.lst    -- documentation in plain ASCII
  62.  
  63.    Sed.lst should print on any dumb printer it is exactly 66 lines
  64.    per page and has no special character.
  65.  
  66.    To see a really nice printout of the documentation you should
  67.    try to run the .tex version.  A LaTex style file for sed is
  68.    also included.   
  69.  
  70. Miscellaneous background files (HISTORY.ZIP)
  71.  
  72.  
  73. Compile Instructions (from h**2, slightly edited):
  74.  
  75. To create sed.com from the supplied source the following can be used
  76. (assuming BCC):
  77.    1. sed.h sedcomp.c and sedexec.c were placed in the default diretory
  78.    2. A turboc.cfg is created containing the following:
  79.         -w-stk -w-pia -a -G -O -Z  -P-.c 
  80.         -Ic:\BC2\INCLUDE
  81.         -Lc:\BC2\LIB
  82.    3. Adjust the defaults for INCLUDE and LIB for your system
  83.    4. invoke the complier: 
  84.         BCC -mt -lt -esed sedcomp.c sedexec.c c:\bc2\lib\wildargs.obj
  85.    5. sed.com created.
  86.    6. TCC should work the -P-.c should not be needed.
  87.       [If your TCC is not configured to consider signed chars the
  88.       default, you should include the -K- switch to force signed chars.]
  89.    7. BC or TC could also be used in a manner similar to the above.
  90.       [(For TC 2.0, use the provided TCCONFIG.TC and SED.PRJ files.)]
  91.    8. On the sun4 under Unix the command was:
  92.         cc -o hhsed sedcomp.c sedexec.c   
  93.  
  94. ========
  95.  
  96. v1.4, 20 Sep 91:
  97.  
  98. The new h**2 code (and probably v1.2) was broken under TC 2.0
  99. (with the last line of the included test files garbaged).
  100.  
  101. There were also several dozen warning messages that disturbed me.
  102.  
  103. After chasing down and eliminating all the warnings and (the
  104. *real* bug fix) switching to signed chars, it started working.
  105.  
  106. Redistributing for testing.  Now including the little test files
  107. which I found somewhere (I forget):
  108.   ctrans
  109.   pascal
  110.   sedtest.bat
  111.  
  112. and the TC 2.0 integrated environment related files:
  113.   tcconfig.tc
  114.   sed.prj
  115.  
  116. Feel free to expand our test files in any way you desire.
  117. I wish we had a full suite of sed tests.
  118.  
  119. David Kirschbaum
  120. Toad Hall
  121. kirsch@usasoc.soc.mil
  122.  
  123. ========
  124.  
  125. v1.5, 2 Oct 91
  126.  
  127. Received more changes from Howard Helman, and posted them
  128. all manually.  Then received his final version of the
  129. source (HHSED14C.MSG) and started to go with that.
  130.  
  131. Then received his final FINAL version (HHSED15A.MSG)
  132. and am going with that.
  133.  
  134. (There are lots of warning messages when compiling
  135. under TC 2.0.  If you ignore them, it runs just fine.)
  136.  
  137. Edited his README file a bit to integrate everything,
  138. add a nice historical intro, etc.
  139.  
  140. See sed14b.pch for his v1.4 -> v1.4b patches.
  141.  
  142. David Kirschbaum
  143. Toad Hall
  144.