From owner-freebsd-doc@FreeBSD.ORG Sun Sep 24 18:22:19 2006 Return-Path: X-Original-To: freebsd-doc@freebsd.org Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id AEF4416A407 for ; Sun, 24 Sep 2006 18:22:19 +0000 (UTC) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id E7CDD43D4C for ; Sun, 24 Sep 2006 18:22:18 +0000 (GMT) (envelope-from marc@blackend.org) Received: from gothic.blackend.org (gothic.blackend.org [192.168.1.203]) by abigail.blackend.org (8.13.4/8.13.3) with ESMTP id k8OIMEvp058081; Sun, 24 Sep 2006 20:22:14 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: from gothic.blackend.org (localhost.blackend.org [127.0.0.1]) by gothic.blackend.org (8.13.8/8.13.3) with ESMTP id k8OIMEKf002847; Sun, 24 Sep 2006 20:22:14 +0200 (CEST) (envelope-from marc@gothic.blackend.org) Received: (from marc@localhost) by gothic.blackend.org (8.13.8/8.13.3/Submit) id k8OIMEug002846; Sun, 24 Sep 2006 20:22:14 +0200 (CEST) (envelope-from marc) Date: Sun, 24 Sep 2006 20:22:14 +0200 From: Marc Fonvieille To: Duane Whitty Message-ID: <20060924182214.GA2650@gothic.blackend.org> Mail-Followup-To: Duane Whitty , freebsd-doc@freebsd.org References: <20060905223444.GA33935@dwpc.dwlabs.ca> <20060924070721.GA961@gothic.blackend.org> <4516C36B.7030701@dwlabs.ca> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <4516C36B.7030701@dwlabs.ca> X-Useless-Header: blackend.org X-Operating-System: FreeBSD 6.2-PRERELEASE User-Agent: Mutt/1.5.11 Cc: freebsd-doc@freebsd.org Subject: Re: man pages and handbooks X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 24 Sep 2006 18:22:19 -0000 On Sun, Sep 24, 2006 at 02:42:03PM -0300, Duane Whitty wrote: [...] > > > > >If you want to just merge/copy some manual pages parts in the > >arch-handbook then you miss the point since there's no gain in > >duplicating the information. For example if you want to talk about the > >ULE schedule we are not looking for a sched_ule(4) manual page copy but > >a documented text covering the features, how to use it or code with it, > > I agree. > > >etc.; another example would be the USB devices, if your look at the > >current chapter, the text explain how the USB stack works (it's quite > >the case) but miss a part explaining how to write a simple USB (HID?) > >driver. > > I somewhat agree but I also don't believe that the > Architecture Handbook is the best location for detailed > tutorial information on how to develop for a specific > subsystem; Just my opinion. Is that not be what the > Developers' Handbook is for? [Not meant as a rhetorical > question] > [...] The Developers Handbook is for people who want to develop under FreeBSD, the Arch Handbook is for people who want to develop or understand FreeBSD internals. Just read, as example, http://www.freebsd.org/doc/en_US.ISO8859-1/books/arch-handbook/devicedrivers.html etc. Marc