home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 138.lha / M4 / readme < prev    next >
Encoding:
Text File  |  1986-11-20  |  3.7 KB  |  64 lines
  1.         What you have here is a completely PD implementation of
  2.         M4. It was originally written for the GNU project. 
  3.         This version was the last version before a major re-write 
  4.         took place.
  5.         Pd M4 is based on software tools macro, as described in the
  6.         two tools books by Kernighan and Plauger. Although some
  7.         serious changes have been made, this version inherits the basic
  8.         design problems of the original, hence the ugliness of the
  9.         underlying code. [GNU version of this processor is re-designed
  10.         in a much cleaner fashion, and is expected to be out before 
  11.         1988. GNU version also includes an extensive texinfo document.]
  12.         PDness:
  13.         This code *is* PD. You (public) have all the rights to the code. 
  14.         [But this also means you (singular) do not have any *extra*
  15.         rights to the code, hence it is impossible for you to restrict
  16.         the use and distribution of this code in any way.]
  17.         Dedication:
  18.         This posting is a dedication to an old 750 that started out
  19.         running 4.1BSD and had 1.5 meg, 1 dz11, and 2 Rk07 drives.
  20.         It was named yetti [sic] by accident, and was managed by the
  21.         author until its retirement few months ago. [the name yetti 
  22.         now identifies a different machine]
  23.         Distribution + misc:
  24.         The distribution includes a small test suite, the sources and
  25.         a man page. texinfo document is not included. The makefile is
  26.         pretty simple. See the makefile for configuration options.
  27.         Try "make time" for some timing comparisons between your un*x
  28.         m4 and the pd m4. [It should be slighly slower than V7 m4, and
  29.         slightly faster than SV m4]. Make sure to set MBIN to indicate
  30.         the location of un*x m4. See the test suite (test.m4) for some
  31.         additional comments about pd m4 vs un*x m4.
  32.         Some thoughts:
  33.         M4 is a neat macro processor but probably a bit outdated by
  34.         now. It does not need gratuitous additions, or "features", but
  35.         a complete re-write. As it stands, it is powerful enough for
  36.         most macro processing needs. We have, for example, used it to
  37.         build a configuration language for DECNET under VMS. It can
  38.         be a handy software engineering tool under most circumstances,
  39.         and can displace a lot of meaningless little hacks written in
  40.         C, pascal or whatever. [See some net postings for references.]
  41.         Suggestions for hacking:
  42.         If you want to hack M4 further, you may wish to implement the
  43.         SV m4 "trace" facility, and extended (5-char) Comment/Quote
  44.         definitions. This version also needs some dynamicity for its
  45.         data structures, and the ability to handle multiple file names
  46.         in the command line. If you want to add "features", you may wish
  47.         to first think about implementing the "feature" as an M4 macro.
  48.         If you really want to elevate this processor into a more state-of
  49.         the-art tool, than you should probably re-write it. [But I have
  50.         already done that, so you may wish to wait for the GNU version to
  51.         get a head start.]
  52.         Feedback:
  53.         If you have any important fixes and/or speed improvements,  I am
  54.         much interested, since my new version inherits some code from this
  55.         version. I am also interested in hearing about any unique applica-
  56.         tions of M4. I am not interested in gratuitous hacks or "neat"
  57.         kitchen-sink features. 
  58.         Contact:
  59.                 Usenet: [decvax|ihnp4]!utzoo!yetti!oz || 
  60.                             ...seismo!mnetor!yetti!oz
  61.                 Bitnet: oz@[yulibra|yuyetti].BITNET
  62.                 Phonet: [416] 736-5257 x 3976
  63.         enjoy.  oz
  64.