From owner-freebsd-doc@FreeBSD.ORG Tue Apr 5 02:47:33 2005 Return-Path: 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 4EC8216A4CE for ; Tue, 5 Apr 2005 02:47:33 +0000 (GMT) Received: from cfcl.com (cpe-24-221-172-174.ca.sprintbbd.net [24.221.172.174]) by mx1.FreeBSD.org (Postfix) with ESMTP id E125543D2F for ; Tue, 5 Apr 2005 02:47:30 +0000 (GMT) (envelope-from rdm@cfcl.com) Received: from [192.168.254.205] ([192.168.254.205]) by cfcl.com (8.12.6/8.12.6) with ESMTP id j352oiJm076520 for ; Mon, 4 Apr 2005 19:50:44 -0700 (PDT) (envelope-from rdm@cfcl.com) Mime-Version: 1.0 Message-Id: In-Reply-To: <4251F848.3040200@noogenesis.org> References: <4251F848.3040200@noogenesis.org> X-Mailer: Eudora for Macintosh! Date: Mon, 4 Apr 2005 19:41:35 -0800 To: freebsd-doc@freebsd.org From: Rich Morin Content-Type: text/plain; charset="us-ascii" ; format="flowed" Subject: Re: documentation and specification for freebsd internals X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 05 Apr 2005 02:47:33 -0000 I would love to see something like this take shape, but I've got a few extra ideas and requirements to offer. Here goes... The system would be very wiki-like, but it would have explicit support for binding pages to arbitrary path names in FreeBSD (and maybe some other name spaces, as well). The system would allow some of its pages to be mechanically created, rather than hand-edited. This would allow interested folks to write scripts which grovel over the tree and produce pages, diagrams, etc. FWIW, I recently created a set of Perl document mechanization scripts for a software project: http://www.slac.stanford.edu/exp/glast/flight/web/e_tut/docs.shtml http://www.slac.stanford.edu/exp/glast/flight/web/e_tut/doc_mech.shtml -r -- email: rdm@cfcl.com; phone: +1 650-873-7841 http://www.cfcl.com - Canta Forda Computer Laboratory http://www.cfcl.com/Meta - The FreeBSD Browser, Meta Project, etc. http://www.ptf.com/dossier - Prime Time Freeware's DOSSIER series