From owner-freebsd-ports  Thu Sep 12 02:27:06 1996
Return-Path: owner-ports
Received: (from root@localhost)
          by freefall.freebsd.org (8.7.5/8.7.3) id CAA24783
          for ports-outgoing; Thu, 12 Sep 1996 02:27:06 -0700 (PDT)
Received: from relay.nuxi.com (nuxi.cs.ucdavis.edu [128.120.56.38])
          by freefall.freebsd.org (8.7.5/8.7.3) with ESMTP id CAA24778
          for <freebsd-ports@freefall.freebsd.org>; Thu, 12 Sep 1996 02:27:03 -0700 (PDT)
Received: (from obrien@localhost) by relay.nuxi.com (8.7.5/8.6.12) id CAA03973; Thu, 12 Sep 1996 02:26:29 -0700 (PDT)
From: "David E. O'Brien" <obrien@Nuxi.cs.ucdavis.edu>
Message-Id: <199609120926.CAA03973@relay.nuxi.com>
Subject: Re: port of su2
To: jkh@time.cdrom.com (Jordan K. Hubbard)
Date: Thu, 12 Sep 1996 02:26:28 -0700 (PDT)
Cc: obrien@Nuxi.cs.ucdavis.edu, gurney_j@resnet.uoregon.edu,
        freebsd-ports@freefall.freebsd.org
In-Reply-To: <2781.842518438@time.cdrom.com> from "Jordan K. Hubbard" at "Sep 12, 96 01:53:58 am"
X-PGP-Fingerprint: B7 4D 3E E9 11 39 5F A3  90 76 5D 69 58 D9 98 7A
X-Pgp-Keyid: 34F9F9D5
X-Mailer: ELM [version 2.4ME+ PL22 (25)]
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Sender: owner-ports@FreeBSD.ORG
X-Loop: FreeBSD.org
Precedence: bulk

> > suggest you get almost any existing port and follow its example.  Also,
> > take a glance at /usr/share/mk/bsd.port.mk.  It is *very* readable as
> > makefiles go.
> 
> I've read this 3 times and still can't figure out if it's very thinly
> veiled sarcasm or not. :-)

No sarcasm at all.  It has *tons* of clear readable comments.  I wish
every complex Makefile I've ever had to read was this well laid out and
commented.  There is no need for special documentation of the predefined
symbols, because they are so easy to find (along with their intended
use).  bsd.port.mk is a model for other complext development projects to
follow.

The "as makefiles go" means, yes, you still have to know some basic
Makefile syntax to understand what it is doing -- but not really that
much (especially since there aren't any implicit targets and things like
$*,$<, etc used).

-- David    (obrien@nuxi.com)