X-Git-Url: https://git.phdru.name/?a=blobdiff_plain;f=docs%2Fcommand_line.rst;h=4bde53d9f3b354636c10df9afaa7026ccdee9870;hb=2d76928b93c208d27f942b9a9eb649df1d5b2192;hp=5125d0e6dc9f6a588b6f654bb8b8b075b394ea57;hpb=f500438f9ec07d6242b6f5c06125a6df7d696919;p=m_librarian.git

diff --git a/docs/command_line.rst b/docs/command_line.rst
index 5125d0e..4bde53d 100644
--- a/docs/command_line.rst
+++ b/docs/command_line.rst
@@ -6,17 +6,19 @@ Command-line scripts
 .. contents::
    :local:
 
+.. highlight:: none
 
 ml-initdb.py
 ------------
 
 Usage::
 
-    ml-initdb.py [-d]
+    ml-initdb.py [-C] [-D]
 
 Options::
 
-    -d, --database database  Open this database by pathname/db uri
+    -C, --config config      Configuration file
+    -D, --database database  Open this database by pathname/db uri
 
 Initialize database and import genres list. Isn’t really needed as
 the next script does all that too.
@@ -27,11 +29,13 @@ ml-import.py
 
 Usage::
 
-    ml-import.py [-d] [file.inpx ...]
+    ml-import.py [-C] [-D] [-P] [file.inpx ...]
 
 Options::
 
-    -d, --database database  Open this database by pathname/db uri
+    -C, --config config      Configuration file
+    -D, --database database  Open this database by pathname/db uri
+    -P, --no-pbar            Inhibit progress bar
 
 Initialize database, import genres list and import a list of INPX files
 listed in the command line. On subsequent runs doesn’t destroy DB or
@@ -43,14 +47,15 @@ ml-search.py
 
 Usage::
 
-    ml-search.py [-d] [-i] [-I] [-t] [-s] [-f] [-v] [-c] ...
+    ml-search.py [-C] [-D] [-i] [-I] [-t] [-s] [-f] [-v] [-c] ...
 
 Search through the database and display results. Currently can only
 search authors by name.
 
 Global options::
 
-    -d, --database database  Open this database by pathname/db uri
+    -C, --config config      Configuration file
+    -D, --database database  Open this database by pathname/db uri
     -i, --ignore-case        ignore case (default is to guess)
     -I, --case-sensitive     don’t ignore case
     -t, --start              search type: substring at the start
@@ -118,7 +123,7 @@ Book searching and downloading
 
 Usage::
 
-    ml-search.py books [-t title] [-s series] [-a archive] [-f file] [-p path] [--get] [--get-many N] [--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]
+    ml-search.py 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] [-P path] [-F format] [--get] [--get-many N]
 
 Search and print a list of books by title, series, archive or file name.
 
@@ -128,10 +133,6 @@ Options::
     -s, --series series    Search by series
     -a, --archive archive  Search by archive (zip file)
     -f, --file file        Search by file name (without extension)
-    -p, --path path        Path to the directory with the library
-                           archives
-    --get                  Download exactly one book
-    --get-many N           Download at most this many books
     --id id                Search by database id
     --surname surname      Search by author’s surname
     --name name            Search by author’s name
@@ -145,6 +146,11 @@ Options::
     --gid gid              Search by genre’s id
     -l, --lang lang        Search by language
     --lid lid              Search by language’s id
+    -P, --path path        Path to the directory with the library
+                           archives
+    -F, --format format    Format of the downloaded file name
+    --get                  Download exactly one book
+    --get-many N           Download at most this many books
 
 By default the program prints only titles of the found book. With one
 option `-v` it also prints database id, the list of authors and genres,
@@ -154,14 +160,14 @@ it also prints the file date and language. With three `-v` it prints
 archive name, file name, extension and size, and flag if the book is
 marked to be deleted.
 
-Option `-p` provides the path to the directory with the library
-archives. By default the path is extracted from `m_librarian.conf`,
+Option `-P` provides the path to the directory with the library
+archives. By default the path is extracted from configuration file,
 section `[library]`, key `path`::
 
     [library]
     path = /var/lib/archives
 
-The option is useful for multiple databases (global option `-d`).
+The option is useful for multiple databases (global option `-D`).
 
 Option `--get` allows to download a book from the library to a local
 file. The option allows to download exactly one book. The simplest way
@@ -191,6 +197,8 @@ Format must not end in directory separator (`/` or `\\`). If specifier
 unconditionally with a dot. That is, format `%f` is equivalent to
 `%f.%e`.
 
+Option `-F|--format format` allows to overwrite this configuration value.
+
 Option `--get-many N` allows to download many books (at most N, where N
 is an integer). Options `--get-many N` and `--get` are, of course,
 mutually incompatible.
@@ -245,4 +253,20 @@ Options::
 
 With one option `-v` it also prints database id.
 
+
+ml-web.py
+------------
+
+Usage::
+
+    ml-web.py [-p port]
+
+Options::
+
+    -p, --port port      HTTP port to listen to
+
+Run a web server. If a port is given listen on the given port. Else
+choose a random port. Start a browser (or open a new window of a running
+browser) pointing it to the server.
+
 .. vim: set tw=72 :