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

[Alexander Bokovoy]

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

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

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

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

-- 
/ Alexander Bokovoy
Samba Team                      http://www.samba.org/
ALT Linux Team                  http://www.altlinux.org/
Midgard Project Ry              http://www.midgard-project.org/