From owner-freebsd-ports Sun Jan 18 20:26:57 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id UAA21358 for freebsd-ports-outgoing; Sun, 18 Jan 1998 20:26:57 -0800 (PST) (envelope-from owner-freebsd-ports@FreeBSD.ORG) Received: from time.cdrom.com (root@time.cdrom.com [204.216.27.226]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id UAA21350 for ; Sun, 18 Jan 1998 20:26:51 -0800 (PST) (envelope-from jkh@time.cdrom.com) Received: from time.cdrom.com (jkh@localhost.cdrom.com [127.0.0.1]) by time.cdrom.com (8.8.8/8.6.9) with ESMTP id UAA03287; Sun, 18 Jan 1998 20:26:49 -0800 (PST) To: Warner Losh cc: John Fieber , ports@FreeBSD.ORG Subject: Re: Docs for bsd.ports.mk In-reply-to: Your message of "Sun, 18 Jan 1998 21:03:16 MST." <199801190403.VAA02286@harmony.village.org> Date: Sun, 18 Jan 1998 20:26:49 -0800 Message-ID: <3284.885184009@time.cdrom.com> From: "Jordan K. Hubbard" Sender: owner-freebsd-ports@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Perhaps the best solution is to revamp the web docs until they're a bit less confusingly organized and also cover more of the details. Then write a man page which tries to give the ports collection in overview and simply refers to various URLs for the "meaty" stuff. Then you'd only really have the web pages to maintain as the ports collection evolved and the man page would stay largely change-proof. Jordan > In message John Fieber writes: > : You mean beyond what www.freebsd.org/handbook/porting.html > : provides? > > Yes. Right now the porting.html talks about writing a port. It is > excellent for writing a port. However, there are many dirty tricks > that have been used for building ports. The NOCLEANDEPENDS question I > just had, for example. Also things like PREFIX and alternative > FETCH_CMDs and the like would be good to have as well. > > Warner