From owner-freebsd-ports  Thu Dec  4 06:10:13 1997
Return-Path: <owner-freebsd-ports>
Received: (from root@localhost)
          by hub.freebsd.org (8.8.7/8.8.7) id GAA23879
          for ports-outgoing; Thu, 4 Dec 1997 06:10:13 -0800 (PST)
          (envelope-from owner-freebsd-ports)
Received: from silvia.HIP.Berkeley.EDU (ala-ca34-49.ix.netcom.com [207.93.143.177])
          by hub.freebsd.org (8.8.7/8.8.7) with ESMTP id GAA23874
          for <ports@FreeBSD.ORG>; Thu, 4 Dec 1997 06:10:10 -0800 (PST)
          (envelope-from asami@vader.cs.berkeley.edu)
Received: (from asami@localhost) by silvia.HIP.Berkeley.EDU (8.8.8/8.6.9) id GAA01546; Thu, 4 Dec 1997 06:09:39 -0800 (PST)
Date: Thu, 4 Dec 1997 06:09:39 -0800 (PST)
Message-Id: <199712041409.GAA01546@silvia.HIP.Berkeley.EDU>
To: jfieber@indiana.edu
CC: max@wide.ad.jp, ports@FreeBSD.ORG
In-reply-to: <Pine.BSF.3.96.971203223109.26584D-100000@fallout.campusview.indiana.edu> (message from John Fieber on Thu, 4 Dec 1997 09:02:32 -0500 (EST))
Subject: Re: the location of the Handbook and the FAQ
From: asami@cs.berkeley.edu (Satoshi Asami)
Sender: owner-freebsd-ports@FreeBSD.ORG
X-Loop: FreeBSD.org
Precedence: bulk

 * Whoops, you lost me there!  Explain?  What is the "local" tree we
 * are talking about?

The local doc source tree.

 * The difference, as far as how the port is constructed, is small. 
 * The japanese handbook port has a dependency that you have to step
 * outside the standard ports mechanism to satisfy--getting the
 * handbook source.  What is needed is not a standard place to have
 * the source installed on your system, but a standard place you can
 * ftp it from.  Alternately, it could be cvsupped directly into the
 * work directory by the port makefile.

And didn't you already line out all the sticky parts of how to do
that?  Sure, we can move all the nastiness out of the ports mechanism
to whatever script you are going to write to build the tarball on the
ftp site and commit the date/checksum changes to the ports, but I
think the current japanese/handbook method is MUCH simpler.

 * Although it isn't any harder to DO once you know WHAT to do, you
 * do have to figure out what to do (cvsupping the doc-all
 * collection) and I get a fair amount of email from puzzled users
 * about that point.  Eliminating the external depenedency would
 * remove that apparently not-completely-obvious step.

Totally clueless people can use packages.  As for clueful users, I
don't think cvsupping doc-all is that much harder than cvsupping
ports-all.

Satoshi