diff Lib/IMPL/DOM/Navigator/Builder.pm @ 180:d1676be8afcc

Перекодировка в utf-8
author sourcer
date Fri, 30 Dec 2011 23:40:00 +0300
parents 76515373dac0
children 4d0e1962161c
line wrap: on
line diff
--- a/Lib/IMPL/DOM/Navigator/Builder.pm	Tue Dec 20 23:00:30 2011 +0300
+++ b/Lib/IMPL/DOM/Navigator/Builder.pm	Fri Dec 30 23:40:00 2011 +0300
@@ -136,7 +136,7 @@
 
 =head1 NAME
 
-C< IMPL::DOM::Navigator::Builder > - ,     .
+C< IMPL::DOM::Navigator::Builder > - Навигатор, строящий документ по указанной схеме.
 
 =head1 SYNOPSIS
 
@@ -153,8 +153,8 @@
 
 =head1 DESCRIPTION
 
- DOM    .    
-      C<IMPL::DOM::XMLReader>.
+Построитель DOM документов по указанной схеме. Обычно используется в связке
+с объектами для чтения такими как C<IMPL::DOM::XMLReader>.
 
 =head1 METHODS
 
@@ -162,25 +162,25 @@
 
 =item C< CTOR($classDocument,$schema) >
 
-  ,      ( , 
-L<IMPL::Object::Factory>)  .     
-   .
+Создает новый объект, принимает на вход класс документа (или фабрику, например
+L<IMPL::Object::Factory>) и схему. В процессе процедуры построения документа
+будет создан объект документа.
 
 =item C< NavigateCreate($nodeName,\%props) >
 
-         .     
-   ,   .
+Создает новый узел с указанным именем и переходит в него. В случае если в схеме
+подходящий узел не найден, то вызывается исключение.
 
-       ,     
-       .  
-     C<< IMPL::DOM::Document->Create >>
+При этом по имени узла ищется его схема, после чего определяется класс для
+создания экземпляра и созданный узел доавляется в документ. При создании
+нового узла используется метод документа C<< IMPL::DOM::Document->Create >>
 
-       C<%props>,   
-      C<nodeName>,   .
+Свойства узла передаются при создании через параметр C<%props>, но имя создаваемого
+узла НЕ может быть переопределено свойством C<nodeName>, оно будет проигнорировано.
 
 =item C< Document >
 
-,       .
+Свойство, которое содержит документ по окончании процедуры построения.
 
 =back