diff Lib/IMPL/DOM/Navigator.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.pm	Tue Dec 20 23:00:30 2011 +0300
+++ b/Lib/IMPL/DOM/Navigator.pm	Fri Dec 30 23:40:00 2011 +0300
@@ -234,18 +234,18 @@
 
 =head1 DESCRIPTION
 
-     DOM .
+Объект для хождения по дереву DOM объектов.
 
-     ().
+Результатом навигации является множество узлов (альтернатив).
 
-     ,    ,
-        .
+Состоянием навигатора является текущий набор узлов, позиция в данном наборе,
+а также запрос по которому были получены данные результаты.
 
-        ,   
-       .    
-   ,      
-    ,   
- ,      .
+Если при навигации указан путь сосящий из нескольких фильтров, то он разбивается
+этапы простой навигации по кадой из частей пути. На каждом элементарном этапе
+навигации образуется ряд альтернатив, и при каждом следующем этапе навигации
+альтернативы предыдущих этапов могут перебираться, до получения положительного
+результата навигации, в противном случае навигация считается невозможной.
 
 =head1 METHODS
 
@@ -253,25 +253,25 @@
 
 =item C<<$obj->new($nodeStart)>>
 
-      .
+Создает объект навигатора с указанной начальной позицией.
 
 =item C<<$obj->Navigate([$query,...])>>
 
-      C<$query>.     
-         .     
-,    .
+Перейти в новый узел используя запрос C<$query>. На данный момент запросом может
+быть только имя узла и будет взят только первый узел. Если по запросу ничего не
+найдено, переход не будет осуществлен.
 
-      ,  C<undef>.
+Возвращает либо новый узел в который перешли, либо C<undef>.
 
 =item C<<$obj->Back()>>
 
-   ,   .
+Возвращается в предыдущий узел, если таковой есть.
 
-     ,  C<undef>.
+Возвращает либо узел в который перешли, либо C<undef>.
 
 =item C<<$obj->advanceNavigator()>>
 
-   ,   .
+Переходит в следующую альтернативу, соответствующую текущему запросу.
 
 =back