doc

docs/klish3.ru.md

@@ -183,6 +183,11 @@ VIEW. Можно определить VIEW со "стандартными" ко
 Как и VIEW, команды и параметры могут быть ссылками. В этом случае ссылку можно
 рассматривать просто как подстановку того объекта, на который указывает ссылка.
 
+Параметры могут быть обязательными, опциональными, либо являться обязательным
+выбором среди нескольких параметров - кандидатов. Таким образом при вводе команды
+оператором некорые параметры могут быть указаны, а некоторые нет. При разборе
+командной строки составляется последовательность выбранных параметров.
+
 
 ### Тип параметра
 
@@ -198,3 +203,21 @@ VIEW. Можно определить VIEW со "стандартными" ко
 
 
 ### Действие
+
+Каждая команда должна определять действие, выполняемое при вводе этой команды
+оператором. Действие может быть одно, либо несколько действий для одной команды.
+Действие объявляется тегом 'ACTION' внутри команды. В ACTION указывается ссылка
+на символ (функцию) из плугина функций, которая будет исполнена в данном случае.
+Все данные внутри тега ACTION доступны символу. Символ по своему усмотрению может
+использовать эту информацию. В качестве данных, например, может быть задан
+скрипт, который будет выполнен символом.
+
+Результатом выполнения действия является "код возврата". Он определяет успешность
+или неуспешность выполнения команды вцелом. Если для одной команды определено
+более одного действия, то вычисление кода возврата становится более сложной
+задачей. Каждое действие имеет флаг, определяющий влияет ли код возврата
+текущего действия на общий код возврата. Так же действия имеют настройки,
+определяющие будет ли выполняться действие при условии, что предыдущее действие
+завершилось с ошибкой. Если последовательно выполняются несколько действий,
+имеющих флаг влияния на общий код возврата, то общим кодом возврата будет код
+возврата последнего такого действия.