[docs] Re: &ALTDISTRO;

[Alexander Bokovoy]

On Mon, Apr 21, 2003 at 01:38:48PM +0400, Vitaly Ostanin wrote:
> On Mon, 21 Apr 2003 08:02:48 +0300
> Alexander Bokovoy <a.bokovoy на sam-solutions.net> wrote:
> 
> > On Thu, Apr 17, 2003 at 03:36:27PM +0400, Vitaly Ostanin wrote:
> > > > Тогда надо сделать для этого собственный тэг, <altdistro/>.
> > > 
> > > То есть, всё-таки сделать изменения DTD... Как вариант,
> > > можно.
> > Как вариант -- в новой документации в Самбе я сделал
> > дополнительный тег-обертку <samba:parameter> для инкапсуляции
> > мета-информации о
> 
> Это тег описан в DTD, который указан в исходном документе? То
> есть, является ли исходный документ валидным без лбых обработок?
Исходный документ представляет собой заготовку, которая включает в себя
три других документа, каждый из которых состоит из серии <xi:include/> для
целого ряда маленьких xml-файлов в поддиректориях.

Вот эти XML-файлы и содержат <samba:parameter/> в себе. Сами по себе эти
файлы являются валидным XML по DTD smbconf.dtd  Однако они не предназначены 
для валидации по отдельности, их назначение -- удобство поддержки описаний 
параметров в относительно изолированном пространстве, поскольку в smb.conf
на сегодня более 320 параметров. 

При сборке происходит преобразование данных в <samba:parameter/> в
некоторые последовательности Docbook XML и получившийся xml-файл (уже без
<xi:include/>) используется для дальнейшей сборки. Этот файл уже валиден в
рамках Docbook XML и не содержит никаких лишних тегов или атрибутов.

> > параметрах smb.conf(5). Исходники преобразуются посредством
> > дополнительной xslt (на самом деле, двух -- в трехпроходной
> > связке) в валидный Docbook XML. В результате, в исходном
> > формате мы имеем всю важную информацию о параметрах, их
> > местоположении и т.д., а в результирующем файле уже
> > непосредственно Docbook XML.
> > 
> > Все это можно посмотреть на
> > http://cvs.samba.org/cgi-bin/cvsweb/samba/docs/docbook/smbdotconf/
> 
> Я скачал
> http://cvs.samba.org/cgi-bin/cvsweb/~checkout~/samba/docs/docbook/smbdotconf/smb.conf.5.xml?rev=1.3&content-type=text/plain
> но не нашёл там упоминаний "samba:parameter" или "<parameter"
Естественно. Почитайте README и посмотрите в поддиректории.

-- 
/ Alexander Bokovoy
---
If only you had a personality instead of an attitude.