Docs: Document the second ml-web.py detects the first

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

diff --git a/docs-ru/command_line.rst b/docs-ru/command_line.rst
index cbaad645d9d7acccc3a1dce9ebc33b6ef59003fd..5ce2389a0c64747194e6e01a595f5334a6ff44dc 100644 (file)
--- a/docs-ru/command_line.rst
+++ b/docs-ru/command_line.rst
@@ -13,10 +13,11 @@ ml-initdb.py
 
 Использование::
 
-    ml-initdb.py [-D]
+    ml-initdb.py [-C] [-D]
 
 Опции::
 
+    -C, --config config      Путь к файлу конфигурации
     -D, --database database  Использовать указанную БД
 
 Инициализирует базу данных и импортирует список жанров. Этот скрипт не
@@ -28,11 +29,13 @@ ml-import.py
 
 Использование::
 
-    ml-import.py [-D] [file.inpx ...]
+    ml-import.py [-C] [-D] [-P] [file.inpx ...]
 
 Опции::
 
+    -C, --config config      Путь к файлу конфигурации
     -D, --database database  Использовать указанную БД
+    -P, --no-pbar            Не показывать индикатор процесса
 
 Инициализирует базу данных, импортирует список жанров и список файлов
 INPX, перечисленных в командной строке. При повторных запусках не
@@ -45,13 +48,14 @@ ml-search.py
 
 Использование::
 
-    ml-search.py [-D] [-i] [-I] [-t] [-s] [-f] [-v] [-c] ...
+    ml-search.py [-C] [-D] [-i] [-I] [-t] [-s] [-f] [-v] [-c] ...
 
 Программа выполняет поиск по базе данных и показывает список
 результатов. В настоящее время может искать только в списке авторов.
 
 Глобальные опции::
 
+    -C, --config config      Путь к файлу конфигурации
     -D, --database database  Использовать указанную БД
     -i, --ignore-case        независимо от регистра (по умолчанию: угадать)
     -I, --case-sensitive     с учётом регистра
@@ -146,6 +150,7 @@ ml-search.py
     -l, --lang lang        Искать по языку
     --lid lid              Искать по id языка
     -P, --path path        Путь к директории с архивами библиотеки
+    --download-to [path]   Путь к директории для сохранения книг
     -F, --format format    Формат имени сохраняемого файла
     --get                  Загрузить ровно один файл
     --get-many N           Загрузить не больше указанного числа файлов
@@ -159,8 +164,8 @@ ml-search.py
 была ли книга помечена как удалённая.
 
 Опция `-P` задаёт путь к директории с архивами библиотеки. По умолчанию
-этот путь берётся из файла конфигурации `m_librarian`, секция
-`[library]`, ключ `path`, например::
+этот путь берётся из файла конфигурации, секция `[library]`, ключ
+`path`, например::
 
     [library]
     path = /var/lib/archives
@@ -168,12 +173,20 @@ ml-search.py
 Опция полезна в ситуации работы с несколькими базами данных (глобальная
 опция `-D`).
 
+Опция `--download-to` задаёт путь к директории для сохранения книг.
+По умолчанию скрипт сохраняет книги в текущую директорию.
+Если опция используется без указания аргумента `path` скрипт использует
+значение из файла конфигурации, секция `[download]`, ключ `path`::
+
+    [download]
+    path = /tmp
+
 Опция `--get` позволяет загрузить книгу из библиотеки в файл. Опция
 позволяет загрузить ровно одну книгу, поэтому самый простой способ
 использовать эту команду — совместно с опцией `--id`. Файл сохраняется в
 текущую директорию с тем именем, под которым он храниться в библиотеке.
 
-Ключ `format` в секции `[download]` файла конфигурации m_librarian.conf
+Ключ `format` в секции `[download]` файла конфигурации
 
 |    [download]
 |    format = %a/%s/%n %t
@@ -253,4 +266,25 @@ ml-search.py
 
 При использовании опции `-v` также выводится id из БД.
 
+
+ml-web.py
+------------
+
+Использование::
+
+    ml-web.py [-p port]
+
+Опции::
+
+    -p, --port port      Порт протокола HTTP
+
+Запускает web-сервер. Если указан порт, то используется указанный порт.
+Иначе выбирается случайный порт из числа свободных. Программа запускает
+браузер (или открывает новое окно уже запущенного web-обозревателя) с
+адресом, указывающим на сервер.
+
+Если одна копия программы уже запущена, а пользователь запустил вторую,
+вторая копия определяет наличие первой, запускает браузер с адресом
+первого web-сервера и останавливается.
+
 .. vim: set tw=72 :