From owner-cvs-all Tue Jun 22 1: 2:45 1999 Delivered-To: cvs-all@freebsd.org Received: from hcsext.hcs.de (hcshh.hcs.de [194.123.40.1]) by hub.freebsd.org (Postfix) with SMTP id EB9D015208; Tue, 22 Jun 1999 01:02:31 -0700 (PDT) (envelope-from hm@hcs.de) Received: from hcswork.hcs.de([192.76.124.5]) (2347 bytes) by hcsext.hcs.de via sendmail with P:smtp/R:inet_hosts/T:smtp (sender: ) id for ; Tue, 22 Jun 1999 10:02:28 +0200 (CEST) (Smail-3.2.0.104 1998-Nov-20 #1 built 1998-Dec-11) Received: by hcswork.hcs.de (Smail3.1.29.0 #12) id m10wLVh-0000fqC; Tue, 22 Jun 99 10:02 METDST Message-Id: From: hm@hcs.de (Hellmuth Michaelis) Subject: Re: cvs commit: src/sys/isa sio.c In-Reply-To: <19990622121104.Q76907@freebie.lemis.com> from Greg Lehey at "Jun 22, 99 12:11:04 pm" To: grog@lemis.com (Greg Lehey) Date: Tue, 22 Jun 1999 10:02:25 +0200 (METDST) Cc: dfr@nlsystems.com, peter@FreeBSD.org, cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Reply-To: hm@hcs.de Organization: HCS Hanseatischer Computerservice GmbH X-Mailer: ELM [version 2.4ME+ PL39 (25)] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Content-Length: 1393 Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk From the keyboard of Greg Lehey: > > device_is_enabled(9) > > Nice to know there's a man page. But the real thing is that the > "right thing" to do needs to be documented somewhere. It would be > nice, for example, to have an overview of the design principles. Yes, > I know I'm asking for a lot here, but it would really help. I strongly second this. I've read the newbus page on freefall, the man pages and the code and i still do not know where to start and how this all fits together. More, i think that core should make it mandatory for such dramatic changes to the architecture, that this kind of changes are properly and completely documented either before or at least within a fixed timeframe from the time such changes are commited to the tree. Don't get me wrong, it seems that the authors did a great job and i appreciate it very much! Anyway, i don't think you are asking for too much - of what use is a shiny new design of a new subsystem in the very basic FreeBSD architecture if just some handful few people knew how it works and how to use it ? hellmuth -- Hellmuth Michaelis Tel +49 40 559747-70 HCS Hanseatischer Computerservice GmbH Fax +49 40 559747-77 Oldesloer Strasse 97-99 Mail hm [at] hcs.de 22457 Hamburg WWW http://www.hcs.de To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message