From owner-freebsd-ports Wed Aug 30 12:58:50 2000 Delivered-To: freebsd-ports@freebsd.org Received: from ns1.sunesi.net (ns1.sunesi.net [196.15.192.194]) by hub.freebsd.org (Postfix) with ESMTP id 2ACE737B42C; Wed, 30 Aug 2000 12:58:44 -0700 (PDT) Received: from nbm by ns1.sunesi.net with local (Exim 3.03 #1) id 13UE0G-000PI3-00; Wed, 30 Aug 2000 21:58:32 +0200 Date: Wed, 30 Aug 2000 21:58:32 +0200 From: Neil Blakey-Milner To: Nilmoni Deb Cc: Theo Bell , freebsd-ports@FreeBSD.org Subject: Ports Magick Unclear, Proposal to demystify (Was: Re: adding a port) Message-ID: <20000830215831.A96939@mithrandr.moria.org> References: <20000830212332.A96743@mithrandr.moria.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i In-Reply-To: ; from ndeb@ece.cmu.edu on Wed, Aug 30, 2000 at 03:27:57PM -0400 Organization: Sunesi Clinical Systems X-Operating-System: FreeBSD 3.3-RELEASE i386 X-URL: http://rucus.ru.ac.za/~nbm/ Sender: owner-freebsd-ports@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed 2000-08-30 (15:27), Nilmoni Deb wrote: > > It does. If it can't find it: > > It does not. What it gives (for FreeBSD 3.1 ) is something like > "pkg.tar.gz doesnot seem to be in the system" > > There is no mention of any path. True. It doesn't seem to be in the handbook or the ports man page either. In this case, obviousness and user-friendliness should take precedence. For the manpage, I'd suggest adding something to: fetch Fetch all of the files needed to build this port from the site(s) listed in MASTER_SITES and PATCH_SITES. See FETCH_CMD and MASTER_SITE_OVERRIDE. Maybe: "The files are placed in the location provided by the DISTDIR variable by the user, and defaults to /usr/ports/distfiles if not provided. If the DIST_SUBDIR variable is set by the port, it is placed in the subdirectory indicated by the variable." In the handbook, a new section 4.2.1.3: Manually fetching and installing distribution files. This can say something like: "If you already have the distribution file required by a port, you can find where it looks for it with: make -V DISTDIR -V DIST_SUBDIR. Place it in the subdirectory (if any) indicated in the second line off the directory on the first line. For example, you may get: /usr/ports/distfiles squid2.2 You should then place the file in /usr/ports/distfiles/squid2.2. If you want to find out a list of files a port needs, type 'make fetch-list'." I propose a target "wheredist" to return ${DISTDIR}/${DIST_SUBDIR} to make the documentation and usage much easier. I also propose that ${ECHO_MSG} ">> $$file doesn't seem to exist on this system." be changed to: ${ECHO_MSG} ">> $$file doesn't seem to exist in ${DISTDIR}/${DIST_SUBDIR}." Any other suggestions? Neil -- Neil Blakey-Milner Sunesi Clinical Systems nbm@mithrandr.moria.org To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-ports" in the body of the message