Document searching by database id

[m_librarian.git] / docs-ru / command_line.rst

diff --git a/docs-ru/command_line.rst b/docs-ru/command_line.rst
index 6f3c94b5b5f5c97e6734d2dd308e10e918dd9a0b..eb83521e6a350086bce73283b530d28ffd36c57f 100644 (file)
--- a/docs-ru/command_line.rst
+++ b/docs-ru/command_line.rst
@@ -32,7 +32,7 @@ ml-search.py
 
 Использование::
 
-    ml-search.py [-i] [-I] [-t] [-s] [-f] ...
+    ml-search.py [-i] [-I] [-t] [-s] [-f] [-d] [-c] ...
 
 Программа выполняет поиск по базе данных и показывает список
 результатов. В настоящее время может искать только в списке авторов.
@@ -45,6 +45,11 @@ ml-search.py
                           (это тип поиска по умолчанию)
     -s, --substring       тип поиска: подстрока в любом месте
     -f, --full            тип поиска: полное совпадение всей строки
+    -d, --details         Выводить больше информации о найденных
+                          объектах; повторите эту опцию несколько раз,
+                          чтобы получить ещё больше деталей
+    -c, --count           Выводить число найденных объектов, а не сами
+                          объекты
 
 Опции ``-i/-I`` не могут использованы одновременно, поскольку означают
 противоположные команды. В случае, если ни одна из них не использована,
@@ -94,12 +99,15 @@ ml-search.py
 Искать и печатать список авторов, чья фамилия начинается на "друг" и имя
 начинается на "в", без учёта регистра.
 
+При использовании опции `-d` также выводится id из БД.
+
+
 Поиск книг
 ^^^^^^^^^^
 
 Использование::
 
-    ml-search.py [-i/-I] [-t/-s/-f] books [-t title] [-s series] [-a archive] [-f file] [-d]
+    ml-search.py [-i/-I] [-t/-s/-f] books [-t title] [-s series] [-a archive] [-f file] [--id id] [--surname name] [--name name] [--misc-name name] [--fullname name] [--aid aid] [-e ext] [--eid eid] [--gname name] [--gtitle title] [--gid gid] [-l lang] [--lid lid]
 
 Искать и печатать список книг по заголовку, серии, архиву, имени файла.
 
@@ -109,14 +117,28 @@ ml-search.py
     -s, --series серия     Искать по серии
     -a, --archive архив    Искать по имени архива (zip-файла)
     -f, --file файл        Искать по имени файла (без расширения)
-    -d, --details          Выводить больше информации о найденных книгах;
-                           повторите эту опцию несколько раз, чтобы
-                           получить ещё больше деталей
+    --id id                Искать по id книги
+    --surname surname      Искать по фамилии автора
+    --name name            Искать по имени автора
+    --misc-name misc. name Искать по доп. имени автора
+    --fullname name        Искать по полному имени автора
+    --aid aid              Искать по id автора
+    -e, --ext ext          Искать по расширению имени файла
+    --eid eid              Искать по id расширения
+    --gname name           Искать по названию жанра
+    --gtitle title         Искать по заголовку жанра
+    --gid gid              Искать по id жанра
+    -l, --lang lang        Искать по языку
+    --lid lid              Искать по id языка
 
 По умолчанию программы выводит список заголовков найденных книг. При
-использовании опции `-d` также выводится список авторов и жанров, а
-также серия, к которой принадлежит книга (если принадлежит) и порядковый
-номер книги в этой серии.
+использовании опции `-d` также выводится id из БД, список авторов и
+жанров, а также серия, к которой принадлежит книга (если принадлежит) и
+порядковый номер книги в этой серии. С двумя опциями `-d` (`-d -d` или
+просто `-dd`) программа выводит дату файла и язык. С тремя `-d`
+выводятся имя архива, имя файла, расширение и размер файла, и признак,
+была ли книга помечена как удалённая.
+
 
 Поиск расширений
 ^^^^^^^^^^^^^^^^
@@ -127,6 +149,9 @@ ml-search.py
 
 Искать и печатать список расширений имён файлов по имени.
 
+При использовании опции `-d` также выводится id из БД.
+
+
 Поиск жанров
 ^^^^^^^^^^^^
 
@@ -141,6 +166,9 @@ ml-search.py
     -n, --name имя         Искать по названию
     -t, --title заголовок  Искать по заголовку
 
+При использовании опции `-d` также выводится id из БД.
+
+
 Поиск языков
 ^^^^^^^^^^^^
 
@@ -150,4 +178,6 @@ ml-search.py
 
 Искать и печатать список языков по имени.
 
+При использовании опции `-d` также выводится id из БД.
+
 .. vim: set tw=72 :