home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / unix / volume26 / cook-1.4 / part01 / README < prev   
Text File  |  1993-05-03  |  7KB  |  199 lines
  1.  
  2.  
  3.  
  4. readme(cook)                         readme(cook)
  5.  
  6.  
  7. NAME
  8.        cook - a    file construction tool
  9.  
  10. DESCRIPTION
  11.        Put simply, the cook program is yet another make-oid.
  12.  
  13.        The cook    program    is a tool for constructing files.  It is
  14.        given a set of files to create, and recipes of how to
  15.        create them.  In    any non-trivial    program    there will be
  16.        prerequisites to    performing the actions necessary to
  17.        creating    any file, such as include files.  The cook
  18.        program provides    a mechanism to define these.
  19.  
  20.        When a program is being developed or maintained,    the
  21.        programmer will typically change    one file of several which
  22.        comprise    the program.  The cook program examines    the last-
  23.        modified    times of the files to see when the prerequisites
  24.        of a file have changed, implying    that the file needs to be
  25.        recreated as it is logically out    of date.
  26.  
  27.        The cook    program    also provides a    facility for implicit
  28.        recipes,    allowing users to specify how to form a    file with
  29.        a given suffix from a file with a different suffix.  For
  30.        example,    to create filename.o from filename.c
  31.  
  32. HISTORY
  33.        The cook    program    was originally developed (starting in
  34.        1988) because I was marooned on an operating system
  35.        without anything    even vaguely resembling    make(1).  Since    I
  36.        had to write my own, I added a few improvements.     When I
  37.        finally escaped back to UNIX, it    took only two days to
  38.        port cook to SystemV.  I    have since deleted all code for
  39.        that original operating system, although    clues to its
  40.        identity    are still present.  There is no    prize for
  41.        guessing    what it    was.
  42.  
  43.        After I had cook    up on UNIX, the    progress the world had
  44.        made caught up with me.    It was gratifying that many of
  45.        the features other make-oid authors had thought necessary
  46.        were either already present, or easily and seamlessly
  47.        added.
  48.  
  49. ARCHIVE    SITE
  50.        The latest version of cook is available by anonymous ftp
  51.        from:
  52.        Host:   ftp.cse.nau.edu (134.114.64.70)
  53.        Dir:       /pub/Aegis
  54.        File:   README          #    what is    in this    directory
  55.        File:   cook.1.4.tar.Z     #    the complete source
  56.        File:   cook.1.4.patch.Z   #    patch to take 1.3 to 1.4
  57.        File:   cook.1.4.ps.Z      #    PostScript of the Manual
  58.  
  59.        To use anonymous    ftp, give "anonymous" as the user name
  60.        (omit the quotes) and your email    address    as the password.
  61.  
  62.  
  63.  
  64.                                 1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. readme(cook)                         readme(cook)
  71.  
  72.  
  73.        My grateful thanks to Paul Balyoz <pab@ftp.cse.nau.edu>
  74.        for his generosity in providing this archive space.
  75.  
  76.        This directory also contains a few other    pieces of
  77.        software    written    by me.    Please have a look if you are
  78.        interested.
  79.  
  80.        For those of you    without    ftp, I recommend the use of an
  81.        ftp-by-email server.  Here is a list of a few (there are
  82.        many more):
  83.           mail-server@pit-manager.mit.edu
  84.           ftpmail@decwrl.dec.com
  85.           ftpmail@cs.uow.edu.au
  86.  
  87.        In general, you can get a help message about how    to use
  88.        each system by sending email with a subject of "help" and
  89.        a message body containing just the word "help".
  90.  
  91. MAILING    LIST
  92.        A mailing list has been created so that users of    cook may
  93.        exchange    ideas about how    to use the cook    program.
  94.        Discussion may include, but is not limited to: bugs,
  95.        enhancements, and applications.    The list is not
  96.        moderated.
  97.  
  98.        The address of the mailing list is
  99.           cook-users@bmr.gov.au
  100.  
  101.        To subscribe to this mailing list, send an email    message
  102.        to majordomo@bmr.gov.au with a message body containing the
  103.        single line
  104.           subscribe    cook-users
  105.        Please note that    bmr.gov.au is an Internet site,    so if you
  106.        have an address which is    not readily derived from your
  107.        mail headers (majordomo is only a Perl program, after all)
  108.        you will    need to    use a message of the form:
  109.           subscribe    cook-users address
  110.        where address is    an email address which makes sense from
  111.        an Internet site.
  112.  
  113.        The software which handles this mailing list CANNOT send
  114.        you a copy of the cook program.    Please use ftp or ftp-by-
  115.        email, instead.
  116.  
  117. NEW IN THIS RELEASE
  118.        A number    of features have been added to cook with this
  119.        release.     A few of them are detailed here:
  120.  
  121.        * The cook program is now known to work on more systems.
  122.        Most changes were aimed at improving portability, or
  123.        avoiding    problems specific to some systems.
  124.  
  125.        * The GNU long option name convention is    now understood.
  126.        Option names for    cook were always long, so this mostly
  127.  
  128.  
  129.  
  130.                                 2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. readme(cook)                         readme(cook)
  137.  
  138.  
  139.        consists    of ignoring the    extra leading '-'.  The
  140.        "--foo=bar" convention is also understood for options with
  141.        arguments.
  142.  
  143.        * Tests which fail now tell you what it was they    were
  144.        testing for.  This will give the    user some idea of what is
  145.        happening.
  146.  
  147.        Plus the    usual crop of bug fixes    and tinkering.    For
  148.        excruciating detail, and    also acknowlegements of    those who
  149.        generously sent me feedback, please see the CHANGES file
  150.        included    in this    distribution.
  151.  
  152. BUILDING COOK
  153.        Full instructions for building the cook program may be
  154.        found in    the BUILDING file included in this distribution.
  155.  
  156. COPYRIGHT
  157.        cook version 1.4.D013
  158.        Copyright (C) 1988, 1989, 1990, 1991, 1992, 1993    Peter
  159.        Miller.
  160.        All rights reserved.
  161.  
  162.        This program is free software; you can redistribute it
  163.        and/or modify it    under the terms    of the GNU General Public
  164.        License as published by the Free    Software Foundation;
  165.        either version 2    of the License,    or (at your option) any
  166.        later version.
  167.  
  168.        This program is distributed in the hope that it will be
  169.        useful, but WITHOUT ANY WARRANTY; without even the implied
  170.        warranty    of MERCHANTABILITY or FITNESS FOR A PARTICULAR
  171.        PURPOSE.     See the GNU General Public License for    more
  172.        details.
  173.  
  174.        You should have received    a copy of the GNU General Public
  175.        License along with this program;    if not,    write to the Free
  176.        Software    Foundation, Inc., 675 Mass Ave,    Cambridge, MA
  177.        02139, USA.
  178.  
  179.        It should be in the LICENSE file    included with this
  180.        distribution.
  181.  
  182. AUTHOR
  183.        Peter Miller   UUCP     uunet!munnari!bmr.gov.au!pmiller
  184.        /\/\*          Internet     pmiller@bmr.gov.au
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                                 3
  197.  
  198.  
  199.