From owner-freebsd-doc Thu Aug 31 19:34:24 2000 Delivered-To: freebsd-doc@freebsd.org Received: from waterblue.imgsrc.co.jp (waterblue.imgsrc.co.jp [210.226.20.160]) by hub.freebsd.org (Postfix) with ESMTP id 9684D37B424 for ; Thu, 31 Aug 2000 19:34:21 -0700 (PDT) Received: from waterblue.imgsrc.co.jp (localhost [127.0.0.1]) by waterblue.imgsrc.co.jp (8.11.0/8.11.0) with ESMTP id e812YGG98489 for ; Fri, 1 Sep 2000 11:34:17 +0900 (JST) Date: Fri, 01 Sep 2000 11:34:16 +0900 Message-ID: <7m1yz4demv.wl@waterblue.imgsrc.co.jp> From: Jun Kuriyama To: freebsd-doc@freebsd.org Subject: Re: HARDWARE.TXT vs. {i386,alpha}/RELNOTES.TXT In-Reply-To: In your message of "Thu, 31 Aug 2000 18:15:02 -0400" <20000831181502.A50923@spirit.jaded.net> References: <200008291834.e7TIYFm20218@bmah-freebsd-0.cisco.com> <20000829204112.A5240@luna.osd.bsdi.com> <20000830154508.A62946@canyon.nothing-going-on.org> <20000830173121.D17060@spirit.jaded.net> <7mbsy9dgdi.wl@waterblue.imgsrc.co.jp> <20000831105322.A66090@canyon.nothing-going-on.org> <20000831181502.A50923@spirit.jaded.net> User-Agent: Wanderlust/1.1.1 (Purple Rain) SEMI/1.13.7 (Awazu) FLIM/1.13.2 (Kasanui) MULE XEmacs/21.1 (patch 12) (Channel Islands) (i386--freebsd) MIME-Version: 1.0 (generated by SEMI 1.13.7 - "Awazu") Content-Type: text/plain; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org At 31 Aug 2000 22:15:17 GMT, Dan Moschuk wrote: > Why do we need an XML parser in the tree at all? Why not keep the XML file on > freefall and regenerate/commit the handbook/HARDWARE.TXT everytime it is > updated? A similar process (without the XML voodoo before hand) is done with > src/UPDATING. Right. At this stage, we can do that (keep XML files and Makefile in doc repository and build them on freefall). But I think that method is not "Right thing". In the future, CVS repository should include *only* source file and machine generated file should be built by ${MAKE} on the fly. On the other hand, same informations are stored in many places. Ftp mirror sites are in www, handbook, sysinstall. Ports categories are in www, porters-handbook, sysinstall, bsd.port.mk. I think these data should be handled by more smart way and (IMHO) XML has possibility to achive it. That's why I said we need light XML/XSL tools in base system... -- Jun Kuriyama // IMG SRC, Inc. // FreeBSD Project To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message