[docs] Re: samba links (was: on olinking)

[Vitaly Ostanin]

On Mon, 17 Nov 2003 11:43:49 +0200
Alexander Bokovoy <a.bokovoy на sam-solutions.net> wrote:

> On Mon, Nov 17, 2003 at 11:34:21AM +0300, Vitaly Ostanin wrote:
> > > Сами по себе эти linkends не валидны в исходных документах,
> > > поскольку исходные документы по отдельности не используются
> > > --
> > Валидность важна и при написании исходных документов. Сложно
> > сразу написать правильный документ, который нельзя проверить.
> Собственно, пока проверка на валидность невозможна из-за того,
> что отсутствуют стандартные заголовки в XML-файле, с указанием
> используемых namespaces.

> Согласись, что это небольшая проблема -- добавить их будет
> несложно.

Конечно.

> > > применением, поскольку сами по себе представляют некоторую
> > > ссылочную абстракцию, а функциональное различие можно
> > > указывать, например, при помощи ролевого атрибута (или есть
> > > что-нибудь более пригодное?).
> > Если и нет пригодного, то всегда можно добавить.
> Конечно. Есть желание минимизировать добавления.

> > > Теперь касательно предложенной схемы. Да, замена targetptr
> > > имеет смысл -- на сущность, адекватную результирующему
> > > документу, который может быть не только валидным Docbook
> > > XML, но и, например, чистой выборкой мета-информации. Так
> > > что только xref тут не обойтись, но это довольно простая
> > > "проблема", которую ясно как решать.
> > 
> > Можно для тупых - зачем? Со ссылками внутри собранного дерева
> > понятно, важны внешние ссылки. Если не отходить от
> > _модульного_ принципа разработки документов, то от olink
> > никуда не деться.
> Мне непонятен вопрос -- что -- "зачем"? Мне важно различение
> разных типов ссылок внутри собранного дерева. Есть ссылки вида
> "этот параметр -- синоним вот этого" или "этот параметр обратен
> вот этому", а есть ссылки, образующие зависимости -- их не надо
> отображать в результирующем текстовом документе, но они влияют
> на другие задачи обработки этих же исходных данных (например,
> сверка документированных параметров с реальным C кодом парсера
> конфигурационного файла).

Понятно. Так это не относится к olink. Это указание типа ссылки,
чем бы она ни была сделана - link, xref, olink. Точнее, даже не
типа ссылки, а зависимостей параметров, по типу rpm-пакетов.

По-моему, такие зависимости надо оформлять отдельно от ссылок.
Ссылки вообще можно не указывать, а генерировать из зависимостей.

Если интересна конкретная задача с типами ссылок на параметры в
smb.conf, можно это обсудить отдельным тредом с примерами.

<skipped/>

-- 
Regards, Vyt
mailto:  vyt на vzljot.ru
JID:     vyt на vzljot.ru
----------- следущая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : отсутствует
Тип     : application/pgp-signature
Размер  : 189 байтов
Описание: отсутствует
Url     : /pipermail/docs/attachments/20031117/6c895de9/attachment.bin