From owner-freebsd-current Mon Jun 26 3:27:41 2000 Delivered-To: freebsd-current@freebsd.org Received: from waterblue.imgsrc.co.jp (waterblue.imgsrc.co.jp [210.226.20.160]) by hub.freebsd.org (Postfix) with ESMTP id 2709037B846; Mon, 26 Jun 2000 03:27:33 -0700 (PDT) (envelope-from kuriyama@FreeBSD.org) Received: from waterblue.imgsrc.co.jp (localhost [127.0.0.1]) by waterblue.imgsrc.co.jp (8.11.0.Beta3/8.11.0.Beta1) with ESMTP id e5QARdh82029; Mon, 26 Jun 2000 19:27:39 +0900 (JST) Date: Mon, 26 Jun 2000 19:27:39 +0900 Message-ID: <7mvgyw4u04.wl@waterblue.imgsrc.co.jp> From: Jun Kuriyama To: doc@FreeBSD.org, current@FreeBSD.org Subject: Re: XML driver config file to replace LINT In-Reply-To: In your message of "26 Jun 2000 09:33:30 GMT" <20000625195803.G470@kilt.nothing-going-on.org> References: <20000625195803.G470@kilt.nothing-going-on.org> User-Agent: Wanderlust/1.1.1 (Purple Rain) SEMI/1.13.7 (Awazu) FLIM/1.13.2 (Kasanui) MULE XEmacs/21.1 (patch 9) (Canyonlands) (i386--freebsd) MIME-Version: 1.0 (generated by SEMI 1.13.7 - "Awazu") Content-Type: text/plain; charset=US-ASCII Sender: owner-freebsd-current@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG At 26 Jun 2000 09:33:30 GMT, nik wrote: > We have a problem with keeping our documentation up to date. One of the > most glaring examples of this is the hardware compatability list. We > currently list hardware information in LINT, HARDWARE.TXT, the FAQ, and the > Handbook. Any time this information changes it has to be updated in all > these places (and possibly more). This does not always happen. I don't like "Everything should be written in XML" type thought. But consept for automatic updating of document would be fine. So first of all, we (documentation project) should develop prototype tool to achive that conversion. And we should keep that master text simple to ease modification by hackers. If we force to write complex markups, hackers will *forget* to update that master text. :-) > LINT would then become a skeletal file for things which don't fit this > sort of pattern, and the full LINT would be generated by a script which > parsed the above and the skeletal file to generate the full LINT. I think developpers may dislike to install doc toolchain to build LINT file. $CVSROOT/src tree should not depend on doc toolchain. Another idea is to write some script to convert LINT to LINT.xml for documentation. And website and documents depend on it. Yes, this is not ideal world from the point of SGML/XML view, but we should not bother hackers' development in the source tree. -- Jun Kuriyama // FreeBSD Project To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-current" in the body of the message