X-Git-Url: https://git.phdru.name/?a=blobdiff_plain;f=docs%2Fcommand_line.rst;h=ef27723649b84b110a3a7086f44493ae00edee23;hb=76fad1db9bf3d812333ca9f65b1ed87c8549cab7;hp=f9911a8f5f258aca274e080b7964d69165a218b1;hpb=868f9fd045fa1b4aecc328f818017ecbc91533c4;p=m_librarian.git

diff --git a/docs/command_line.rst b/docs/command_line.rst
index f9911a8..ef27723 100644
--- a/docs/command_line.rst
+++ b/docs/command_line.rst
@@ -113,8 +113,8 @@ name starts with "mack", case insensitive.
 With one option `-v` it also prints database id.
 
 
-Book search
-^^^^^^^^^^^
+Book searching and downloading
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Usage::
 
@@ -167,6 +167,29 @@ file. The option allows to download exactly one book. The simplest way
 to use it is via option `--id`. The file is downloaded into the current
 directory with the name from the library.
 
+Configuration key
+
+|    [download]
+|    format = %a/%s/%n %t
+
+allows to set format for the download file pathname. Default format is
+`%f`, i.e. just filename. Other format specifiers are::
+
+    %a - author (one of if many)
+    %e - file extension
+    %f - file name in archive
+    %G - genre (one of if many), name
+    %g - genre (one of if many), title
+    %l - language
+    %n - series number (or 0)
+    %s - series
+    %t - title
+
+Format must not end in directory separator (`/` or `\\`). If specifier
+`%e` (extension) is not found in the format it is appended
+unconditionally with a dot. That is, format `%f` is equivalent to
+`%f.%e`.
+
 
 Extension search
 ^^^^^^^^^^^^^^^^