From owner-freebsd-ports  Mon Mar 18 00:03:55 1996
Return-Path: owner-ports
Received: (from root@localhost)
          by freefall.freebsd.org (8.7.3/8.7.3) id AAA06195
          for ports-outgoing; Mon, 18 Mar 1996 00:03:55 -0800 (PST)
Received: from time.cdrom.com (time.cdrom.com [204.216.27.226])
          by freefall.freebsd.org (8.7.3/8.7.3) with ESMTP id AAA06189
          Mon, 18 Mar 1996 00:03:52 -0800 (PST)
Received: from localhost (localhost [127.0.0.1]) by time.cdrom.com (8.7.5/8.6.9) with SMTP id AAA05313; Mon, 18 Mar 1996 00:03:28 -0800 (PST)
To: Andreas Klemm <andreas@knobel.gun.de>
cc: Satoshi Asami <asami@cs.berkeley.edu>, doc@freebsd.org, ports@freebsd.org
Subject: Re: HOWTO make a FreeBSD port 
In-reply-to: Your message of "Mon, 18 Mar 1996 07:47:42 +0100."
             <Pine.BSF.3.91.960318073906.201A-100000@knobel.gun.de> 
Date: Mon, 18 Mar 1996 00:03:28 -0800
Message-ID: <5311.827136208@time.cdrom.com>
From: "Jordan K. Hubbard" <jkh@time.cdrom.com>
Sender: owner-ports@freebsd.org
X-Loop: FreeBSD.org
Precedence: bulk

> Ask Jordan. Some weeks ago he wanted me to write such a very beginner
> doku. The reason was that he thinks, that the section that is now
> in the handbook might be too academic "from programmer to programmer".

Yep.  The whole section needs a re-write along the following lines:

	1. What is the ports collection?
		<highly concise description>
	2. How do I use the ports collection?
		<highly concise description of how to navigate through
		ports and link things to the CD to save space>
	3. How do I make a port of my own?
		<real-life example that takes you through the process
		step-by-step>
	2. How does the ports collcetion work?
		<programmer-to-programmer info>

						Jordan