doc

docs/klish3.ru.md

@@ -385,6 +385,9 @@ SEQ сам может быть элементом контейнера SWITCH.
 * `HOTKEY`
 * `ACTION`
 
+> Нельзя путать [текущий путь сессии](#области-видимости) с путем для создания
+> ссылок
+
 
 ## Теги
 
@@ -1304,7 +1307,50 @@ SEQ сам может быть элементом контейнера SWITCH.
 
 * [`name`](#атрибут-name) - идентификатор элемента.
 * [`help`](#атрибут-help) - описание элемента.
-* [`ref`](#атрибут-name) - ссылка на другой `VIEW`.
+* [`ref`](#атрибут-ref) - ссылка на другой `VIEW`.
+
+```
+<VIEW name="view1">
+	<COMMAND name="cmd1"/>
+	<VIEW name="view1_2">
+		<COMMAND name="cmd2"/>
+	</VIEW>
+</VIEW>
+
+<VIEW name="view2">
+	<COMMAND name="cmd3"/>
+	<VIEW ref="/view1"/>
+</VIEW>
+
+<VIEW name="view3">
+	<COMMAND name="cmd4"/>
+	<VIEW ref="/view1/view1_2"/>
+</VIEW>
+
+<VIEW name="view4">
+	<COMMAND name="cmd5"/>
+</VIEW>
+```
+
+Пример демонстрирует как работают области видимости относительно доступных
+оператору команд.
+
+Если текущий путь сессии `/view1`, то оператору доступны команды "cmd1" и "cmd2".
+
+Если текущий путь сессии `/view2`, то оператору доступны команды "cmd1", "cmd2",
+"cmd3".
+
+Если текущий путь сессии `/view3`, то оператору доступны команды "cmd2" и "cmd4".
+
+Если текущий путь сессии `/view4`, то оператору доступна команда "cmd5".
+
+Если текущий путь сессии `/view4/view1`, то оператору доступны команды "cmd1",
+"cmd2", "cmd5".
+
+Если текущий путь сессии `/view4/view1`, то оператору доступны команды "cmd1",
+"cmd2", "cmd5".
+
+
 
 
 ### COMMAND