]> git.phdru.name Git - m_librarian.git/blobdiff - docs-ru/command_line.rst
Output count of found objects
[m_librarian.git] / docs-ru / command_line.rst
index 140e330b0f4ce900ef1267256e13ff84b9c40955..8a07d15dc5ccf420ee0e4d4ebebed2be238a66f9 100644 (file)
@@ -32,7 +32,7 @@ ml-search.py
 
 Использование::
 
-    ml-search.py [-i] [-I] [-t {exact,start,substring}] ...
+    ml-search.py [-i] [-I] [-t] [-s] [-f] [-d] [-c] ...
 
 Программа выполняет поиск по базе данных и показывает список
 результатов. В настоящее время может искать только в списке авторов.
@@ -41,9 +41,15 @@ ml-search.py
 
     -i, --ignore-case     независимо от регистра (по умолчанию: угадать)
     -I, --case-sensitive  с учётом регистра
-    -t, --search-type {exact,start,substring}
-        тип поиска: точный, подстрока в начале (это тип по умолчанию),
-        подстрока в любом месте.
+    -t, --start           тип поиска: подстрока в начале строки
+                          (это тип поиска по умолчанию)
+    -s, --substring       тип поиска: подстрока в любом месте
+    -f, --full            тип поиска: полное совпадение всей строки
+    -d, --details         Выводить больше информации о найденных
+                          объектах; повторите эту опцию несколько раз,
+                          чтобы получить ещё больше деталей
+    -c, --count           Выводить число найденных объектов, а не сами
+                          объекты
 
 Опции ``-i/-I`` не могут использованы одновременно, поскольку означают
 противоположные команды. В случае, если ни одна из них не использована,
@@ -52,14 +58,14 @@ ml-search.py
 параметров есть параметры в ВЕРХНЕМ или Смешанном регистре - поиск будет
 с учётом регистра.
 
-Опция ``-t/--search-type`` определяет тип поиска. Возможные значения:
+Опции ``-t/-s/-f`` определяют тип поиска. Возможные значения:
 
-* exact - поиск на точное совпадение; поиск "друг" найдёт только "друг",
-  но не "другой";
 * start - поиск подстроки в начале поля; поиск "друг" найдёт "друг" и
   "другой", но не "подруга"; это тип по умолчанию;
 * substring - поиск подстроки в любом месте; поиск "друг" найдёт "друг",
   "другой" и "подруга".
+* full - поиск на точное совпадение всей строки; поиск "друг" найдёт
+  только "друг", но не "другой";
 
 
 Поиск авторов
@@ -67,10 +73,10 @@ ml-search.py
 
 Использование::
 
-    ml-search.py [-i] [-I] [-t ...] author [-s surname] [-n name] [-m misc-name]
+    ml-search.py [-i/-I] [-t/-s/-f] author [-s surname] [-n name] [-m misc-name] [fullname]
 
-Искать и печатать список авторов по фамилии, имени и доп. имени (обычно
-отчеству).
+Искать и печатать список авторов по фамилии, имени, доп. имени (обычно
+отчеству) или полному имени.
 
 Опции::
 
@@ -93,13 +99,80 @@ ml-search.py
 Искать и печатать список авторов, чья фамилия начинается на "друг" и имя
 начинается на "в", без учёта регистра.
 
+При использовании опции `-d` также выводится id из БД.
+
+
+Поиск книг
+^^^^^^^^^^
+
+Использование::
+
+    ml-search.py [-i/-I] [-t/-s/-f] books [-t title] [-s series] [-a archive] [-f file] [--surname name] [--name name] [--misc-name name] [--fullname name] [--gname name] [--gtitle title] [-e ext] [-l lang]
+
+Искать и печатать список книг по заголовку, серии, архиву, имени файла.
+
+Опции::
+
+    -t, --title заголовок  Искать по заголовку
+    -s, --series серия     Искать по серии
+    -a, --archive архив    Искать по имени архива (zip-файла)
+    -f, --file файл        Искать по имени файла (без расширения)
+    --surname surname      Искать по фамилии автора
+    --name name            Искать по имени автора
+    --misc-name misc. name Искать по доп. имени автора
+    --fullname name        Искать по полному имени автора
+    -e, --ext ext          Искать по расширению имени файла
+    --gname name           Искать по названию жанра
+    --gtitle title         Искать по заголовку жанра
+    -l, --lang lang        Искать по языку
+
+По умолчанию программы выводит список заголовков найденных книг. При
+использовании опции `-d` также выводится id из БД, список авторов и
+жанров, а также серия, к которой принадлежит книга (если принадлежит) и
+порядковый номер книги в этой серии. С двумя опциями `-d` (`-d -d` или
+просто `-dd`) программа выводит дату файла и язык. С тремя `-d`
+выводятся имя архива, имя файла, расширение и размер файла, и признак,
+была ли книга помечена как удалённая.
+
+
 Поиск расширений
 ^^^^^^^^^^^^^^^^
 
 Использование::
 
-    ml-search.py [-i] [-I] [-t ...] ext name
+    ml-search.py [-i/-I] [-t/-s/-f] ext [name]
 
 Искать и печатать список расширений имён файлов по имени.
 
+При использовании опции `-d` также выводится id из БД.
+
+
+Поиск жанров
+^^^^^^^^^^^^
+
+Использование::
+
+    ml-search.py [-i/-I] [-t/-s/-f] genres [-n name] [-t title]
+
+Искать и печатать список жанров по имени и заголовку.
+
+Опции::
+
+    -n, --name имя         Искать по названию
+    -t, --title заголовок  Искать по заголовку
+
+При использовании опции `-d` также выводится id из БД.
+
+
+Поиск языков
+^^^^^^^^^^^^
+
+Использование::
+
+    ml-search.py [-i/-I] [-t/-s/-f] lang [name]
+
+Искать и печатать список языков по имени.
+
+При использовании опции `-d` также выводится id из БД.
+
 .. vim: set tw=72 :