home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / prog / c / bmake15.lzh / readme < prev    next >
Text File  |  1991-10-13  |  5KB  |  138 lines
  1.  
  2.                          Readme For The Make Utility
  3.  
  4.     Copyright (c) 1991 by Ben Eng
  5.  
  6.     This program is free software; you can redistribute it and/or modify
  7.     it under the terms of the GNU General Public License as published by
  8.     the Free Software Foundation; either version 1, or (at your option)
  9.     any later version.
  10.  
  11.     This program is distributed in the hope that it will be useful,
  12.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  13.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14.     GNU General Public License for more details.
  15.  
  16.     You should have received a copy of the GNU General Public License
  17.     along with this program; if not, write to the Free Software
  18.     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  19.  
  20.  
  21.  
  22. HOW TO CONTACT ME
  23.  
  24.     Ben Eng
  25.     150 Beverley St. Apt #1L
  26.     Toronto, Ontario
  27.     M5T 1Y6
  28.     CANADA
  29.  
  30.     telephone:  (416)-979-8761
  31.  
  32.     e-mail:  uunet!mnetor!becker!jetpen!ben
  33.     BIX:     jetpen
  34.  
  35.  
  36. MANIFEST
  37.  
  38.     README     -  This file
  39.     COPYING    -  The GNU General Public License
  40.     bmake      -  The binary executable for the Amiga
  41.     less       -  utility for reading text files under Amiga OS 2.0
  42.  
  43.     Source Code to the Make utility
  44.  
  45.         Makefile
  46.         builtin.c
  47.         cond.c
  48.         cond.h
  49.         depend.c
  50.         depend.h
  51.         dumprules.c
  52.         expand.c
  53.         fncall.c
  54.         input.c
  55.         lists.c
  56.         log.c
  57.         macro.c
  58.         main.c
  59.         make.c
  60.         make.h
  61.         param.c
  62.         parsing.c
  63.         pattern.c
  64.         read.c
  65.         recipe.c
  66.         snode.c
  67.         touch.c
  68.         version.c
  69.  
  70.     Some files necessary to make ben.lib
  71.  
  72.         ben/basename.c
  73.         ben/makefile
  74.         ben/scdir.c
  75.         ben/system.c
  76.  
  77.     include/scdir.h  -- header file for the scdir routines
  78.  
  79.     docs/mdoc.tex     - AmigaTeX documentation for Make
  80.     docs/manpage.sty  - by Rong Chen (rchen@cs.uiuc.edu)
  81.  
  82.  
  83. ABOUT THE PROGRAM
  84.  
  85. This program requires Amiga OS 2.0 to run with maximum capability.  Under
  86. Amiga OS 1.3, there is no wildcard support.  Run the program with the
  87. argument `?' to see its usage, or `-h' to get more descriptive help on
  88. acceptable command line arguments.
  89.  
  90. Because the program was compiled with DICE 2.06.37, the heap memory
  91. routines directly perform an AllocMem() from the system memory pool.  The
  92. Make program performs many small allocations and deallocations, so it is
  93. possible for memory to become fragmented.  Hopefully, sophisticated heap
  94. memory routines will appear in the standard library to reduce memory
  95. fragmentation.  I haven't noticed any problems with fragmentation though.
  96.  
  97. The environment variable ENV:system can be set to `yes' if you wish the
  98. command execution to use the Amiga OS 2.0 System() call.  If ENV:system is
  99. set to `no', the Amiga OS Execute() call is used instead.  The latter is
  100. desirable if you are still running with a shell that does not support the
  101. 2.0 conventions (WShell 1.2 falls under this category).
  102.  
  103. Command line arguments to Make may not be grouped together; `-a -n' is
  104. completely different from `-an' (which doesn't exist).
  105.  
  106. The present version of the Make program is incomplete and possibly
  107. bug-ridden.  The documentation and functionality are incomplete, and still
  108. require much work to be done.
  109.  
  110. As far as the author is concerned, because this software and documentation
  111. are distributed free of charge, he is not obligated to provide any support
  112. or updates.  However, the complete source code is provided, along with
  113. enough information to construct an executable from it.  The author would be
  114. very appreciative of any comments, bug reports and bug fixes that might be
  115. provided via paper mail and electronic mail (the addresses are provided
  116. above).
  117.  
  118. If there is something broken, first try to find an updated version of this
  119. program.  If the bug still exists in the most recent version of the
  120. program, please report it so that it can be fixed.  If you have fixed the
  121. bug yourself, please provide me with the fixes so that they can be
  122. incorporated into the next update.
  123.  
  124. If you actually use this program, I would like to know about it.  If I find
  125. that nobody uses it then I will not distribute future updates to it.  I
  126. write programs that are useful to me, and I tend to distribute them if they
  127. are useful to others.  I will only know that my programs are useful to
  128. others if they let me know that they use them.  Besides, I enjoy reading
  129. well-written mail.
  130.  
  131. Feel free to send me things of little or great value, if it suits your
  132. fancy.  Although this software is free (with respect to freedom) and no
  133. fees are charged for its private use, I am not at all opposed to receiving
  134. tokens of material wealth.
  135.  
  136.     -Ben
  137.  
  138.