From owner-freebsd-current Tue Jun 27 9:19:44 2000 Delivered-To: freebsd-current@freebsd.org Received: from sv01.geocities.co.jp (sv01.geocities.co.jp [210.153.89.155]) by hub.freebsd.org (Postfix) with ESMTP id C180937BA7E; Tue, 27 Jun 2000 09:19:28 -0700 (PDT) (envelope-from hrs@geocities.co.jp) Received: from mail.geocities.co.jp (mail.geocities.co.jp [210.153.89.137]) by sv01.geocities.co.jp (8.9.3+3.2W/3.7W) with ESMTP id BAA18512; Wed, 28 Jun 2000 01:19:26 +0900 (JST) Received: from mail.hrs.jp (sutnmax2-ppp33.ed.noda.sut.ac.jp [133.31.173.103]) by mail.geocities.co.jp (1.3G-GeocitiesJ-3.3) with ESMTP id BAA25205; Wed, 28 Jun 2000 01:19:24 +0900 (JST) Message-Id: <200006271619.BAA25205@mail.geocities.co.jp> Received: from localhost (alph.hrs.jp [192.168.0.10]) by mail.hrs.jp (8.9.3/3.7W/DomainMaster) with ESMTP id XAA35233; Tue, 27 Jun 2000 23:49:36 +0900 (JST) (envelope-from hrs@hrs.jp) To: nik@FreeBSD.ORG Cc: doc@FreeBSD.ORG, current@FreeBSD.ORG Subject: Re: XML driver config file to replace LINT In-Reply-To: <20000625195803.G470@kilt.nothing-going-on.org> References: <20000625195803.G470@kilt.nothing-going-on.org> <20000626115008.B462@catkin.nothing-going-on.org> X-Mailer: Mew version 1.94.1 on Emacs 19.34 / Mule 2.3 (SUETSUMUHANA) Mime-Version: 1.0 Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Date: Tue, 27 Jun 2000 23:49:34 +0900 From: Hiroki Sato X-Dispatcher: imput version 990905(IM130) Lines: 48 Sender: owner-freebsd-current@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG Nik Clayton wrote in <20000625195803.G470@kilt.nothing-going-on.org>: > [ That schema is not set in stone, and certainly requires more work. In > particular, we probably need "lang" and "encoding" options on the > element, to support comments in more than one language. ] > > 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 it is difficult to maintain the files because few editors can handle various languages/encodings at the same time. So, especially for translators, it is better that the .xml files are separated on a encoding/language basis. However, separated .xml files according to encoding/language like FreeBSD Handbook also cause another problem. If these files are used to create actual configuration files as not only doc or advisory purpose, translated .xml files but are not synchronized with English version can be more harmful. For instance, the out-dated translation couldn't create an appropriate LINT, so non-English readers cannot know modifications in the original file. Thus, configuration items that don't need to translate should be common, and others such as description field that can be translated should be separated, and it is better that latter separated .xml files (i.e. translated one) have a additional marker that indicates whether a file is synch'ed with the original version or not. Nik Clayton wrote in <20000626115008.B462@catkin.nothing-going-on.org>: > The aim is that we have one file that describes the drivers -- this file > will be used by us to keep the documentation up to date, but it will also > be used by the system -- if the driver writer doesn't update this file then > the system won't know about their driver, and won't build it. They'll *have* > to keep it up to date. One file...why? A port in Ports Collection depends on some files not one file, but it works fine. I think we can maintain more easily several small files than big one file. -- | Hiroki Sato/HRS | | j7397067@ed.noda.sut.ac.jp(univ) | hrs@jp.FreeBSD.org(FreeBSD doc-jp Project) To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-current" in the body of the message