From owner-freebsd-ports Sat Apr 22 22:50:36 2000 Delivered-To: freebsd-ports@freebsd.org Received: from smtp6.mindspring.com (smtp6.mindspring.com [207.69.200.110]) by hub.freebsd.org (Postfix) with ESMTP id B9F0237B861; Sat, 22 Apr 2000 22:50:29 -0700 (PDT) (envelope-from asami@cs.berkeley.edu) Received: from silvia.hip.berkeley.edu (sji-ca1-64.ix.netcom.com [209.109.232.64]) by smtp6.mindspring.com (8.9.3/8.8.5) with ESMTP id BAA01572; Sun, 23 Apr 2000 01:50:26 -0400 (EDT) Received: (from asami@localhost) by silvia.hip.berkeley.edu (8.9.3/8.6.9) id WAA37737; Sat, 22 Apr 2000 22:50:23 -0700 (PDT) To: doc@freebsd.org Cc: ports@freebsd.org Subject: Re: Building a porters handbook References: <20000421193305.B30157@catkin.nothing-going-on.org> From: asami@freebsd.org (Satoshi - Ports Wraith - Asami) Date: 22 Apr 2000 22:50:22 -0700 In-Reply-To: Nik Clayton's message of "Fri, 21 Apr 2000 19:33:05 +0100" Message-ID: Lines: 46 X-Mailer: Gnus v5.7/Emacs 20.6 Sender: owner-freebsd-ports@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org * From: Nik Clayton * -doc, -ports * * [ FU to -doc ] (I don't read -doc...) * Per an earlier discussion on -doc, I'd like to pull section 4.4 of the * Handbook ("Making a port yourself") out of the Handbook and in to a * new "Porter's Handbook". That sounds like a good idea. Please put a link to the new handbook in the original handbook though, there are many documents (including some printed ones) that refer to "http://www.FreeBSD.org/handbook/porting.html" and we don't want people who go there to get "not found". * It's believed that most readers of the Handbook won't be creating ports, * so this section is 60 or so pages they'll not need. In the Handbook it * can be replaced with "If you would like to learn more about the ports * systems, or would like to create a port and submit it to the project, * please see the _Porter's Handbook_". Does this mean that the porters guide section doesn't get published anymore, or is it going to be published as a separate book? * I'll do this mechanically (so the translators won't have much work to do). Thanks. BTW, please ask the cvs-meisters for a repository copy so we won't lose history. * In the future, I expect that some of the port's specific stuff in the * "Committer's Guide" (damn, should've called it the "Committer's Handbook") * can migrate here as well, as can any nitty-gritty ports details that * you might have thought to be inappropriate for the Handbook. No, the (new) porter's handbook is for people creating or upgrading ports, not committers. The stuff in the committer's guide is something that is specific to committers and committers are required to read the committer's guide every now and then. For the benefit of people who only commit ports once in a while (and work elsewhere most of the time), I think they should be kept separate. Satoshi To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-ports" in the body of the message