--- a/Lib/IMPL/DOM/Navigator/Builder.pm	Mon Mar 15 02:38:09 2010 +0300
+++ b/Lib/IMPL/DOM/Navigator/Builder.pm	Mon Mar 15 17:45:13 2010 +0300
@@ -56,10 +56,17 @@
 1;
 
 __END__
+
 =pod
 
+=head1 NAME
+
+C< IMPL::DOM::Navigator::Builder > - Навигатор, строящий документ по указанной схеме.
+
 =head1 SYNOPSIS
 
+=begin code
+
 my $builder = new IMPL::DOM::Navigator::Builder(new MyApp::Document,$schema);
 my $reader = new IMPL::DOM::XMLReader(Navigator => $builder);
 
@@ -67,6 +74,8 @@
 
 my @errors = $schema->Validate($builder->Document);
 
+=end code
+
 =head1 DESCRIPTION
 
 Построитель DOM документов по указанной схеме. Обычно используется в связке
@@ -76,21 +85,27 @@
 
 =over
 
-=item C<CTOR($domDocument,$schema)>
+=item C< CTOR($classDocument,$schema) >
 
-Создает новый объект, принимает на вход пустой (но не обязательно) документ и
-схему.
+Создает новый объект, принимает на вход класс документа (или фабрику, например
+L<IMPL::Object::Factory>) и схему. В процессе процедуры построения документа
+будет создан объект документа.
 
-=item C<< $obj->NavigateCreate($nodeName) >>
+=item C< NavigateCreate($nodeName,\%props) >
 
 Создает новый узел с указанным именем и переходит в него. В случае если в схеме
 подходящий узел не найден, то вызывается исключение.
 
 При этом по имени узла ищется его схема, после чего определяется класс для
-создания экземпляра и созданный узел доавляется в документ.
+создания экземпляра и созданный узел доавляется в документ. При создании
+нового узла используется метод документа C<< IMPL::DOM::Document->Create >>
 
-Также имя создаваемого узла НЕ может быть переопределено свойством nodeName, оно
-будет проигнорировано.
+Свойства узла передаются при создании через параметр C<props>, но имя создаваемого
+узла НЕ может быть переопределено свойством C<nodeName>, оно будет проигнорировано.
+
+=item C< Document >
+
+Свойство, которое содержит документ по окончании процедурв построения.
 
 =back