Document author search

diff --git a/docs-ru/command_line.rst b/docs-ru/command_line.rst
index 6d75df3c984e963bebaea2d3cd346f8727fd2f4c..c29098d56399a9971c5ba4911ae034d1ed9aea52 100644 (file)
--- a/docs-ru/command_line.rst
+++ b/docs-ru/command_line.rst
@@ -61,4 +61,36 @@ ml-search.py
 * substring - поиск подстроки в любом месте; поиск "друг" найдёт "друг",
   "другой" и "подруга".
 
+
+Поиск авторов
+^^^^^^^^^^^^^
+
+Использование::
+
+    ml-search.py [-i] [-I] [-t ...] author [-s surname] [-n name] [-m misc]
+
+Искать и печатать список авторов по фамилии, имени и доп. имени (обычно
+отчеству).
+
+Опции::
+
+    -s, --surname фамилия  Искать по фамилии
+    -n, --name имя         Искать по имени
+    -m, --misc доп. имени  Искать по доп. имени
+
+Пример::
+
+    ml-search.py -i author -s друг
+
+Искать и печатать список авторов, чья фамилия начинается на "друг", без
+учёта регистра.
+
+Если использовать несколько опций, поиск будет сужен оператором "И".
+Пример::
+
+    ml-search.py -i author -s друг -n в
+
+Искать и печатать список авторов, чья фамилия начинается на "друг" и имя
+начинается на "в", без учёта регистра.
+
 .. vim: set tw=72 :

diff --git a/docs/command_line.rst b/docs/command_line.rst
index f3f2f58daaa062c6d501ec22a811dc2a0bd3a20c..3542054b8145f6d7ddd7d245efea66f28f938638 100644 (file)
--- a/docs/command_line.rst
+++ b/docs/command_line.rst
@@ -60,4 +60,35 @@ Option ``-t/--search-type`` defines the search type. Search types are:
 * substring - search for any substring; "duck" => "duck", "duckling",
   "McDuck" (except for case-sensitive search, of course).
 
+
+Author search
+^^^^^^^^^^^^^
+
+Usage::
+
+    ml-search.py [-i] [-I] [-t ...] author [-s surname] [-n name] [-m misc]
+
+Search and print a list of authors by surname/name/misc name.
+
+Options::
+
+    -s, --surname surname  Search by surname
+    -n, --name name        Search by name
+    -m, --misc misc. name  Search by misc. name
+
+Example::
+
+    ml-search.py -i author -s duck
+
+Search and print a list of authors whose surname starts with "duck",
+case insensitive.
+
+If a few options are given the search is limited with operator AND.
+Example::
+
+    ml-search.py -i author -s duck -n mack
+
+Search and print a list of authors whose surname starts with "duck", and
+name starts with "mack", case insensitive.
+
 .. vim: set tw=72 :