Docs: Update TODO

[m_librarian.git] / docs / command_line.rst

diff --git a/docs/command_line.rst b/docs/command_line.rst
index 5e07c55107398f205ba03e0d15552a1956d3e09a..e7421435d057888d960c3f2fdbecad65c44462a7 100644 (file)
--- a/docs/command_line.rst
+++ b/docs/command_line.rst
@@ -146,6 +146,7 @@ Options::
     --gid gid              Search by genre’s id
     -l, --lang lang        Search by language
     --lid lid              Search by language’s id
+    --filters              Use filters from config
     -P, --path path        Path to the directory with the library
                            archives
     --download-to [path]   Download directory
@@ -170,6 +171,17 @@ section `[library]`, key `path`::
 
 The option is useful for multiple databases (global option `-D`).
 
+Option `--filters` turns on using filters from config. Currently there
+are two kind of filters: filters on languages and filter on flag
+`deleted`. They are defined in the config file the following way::
+
+    [filters]
+    lang = en ru
+    deleted = 0
+
+`lang` filters is a list of language codes separated by a space.
+`deleted` is a 0/1 flag; 0 hides deleted books from search.
+
 Option `--download-to` provides the path to the download directory.
 By default the script downloads books to the current directory.
 If the option is used without `path` argument the path is extracted from
@@ -274,8 +286,11 @@ 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.
+Run a web server. If a port is given listens on the given port else
+chooses a random port. Starts a browser (or open a new window of a
+running browser) pointing it to the server.
+
+If the program is already running the second instance detects the first
+one, starts a browser pointing to running instance and exits.
 
 .. vim: set tw=72 :