X-Git-Url: https://git.phdru.name/?a=blobdiff_plain;f=docs%2Fcommand_line.rst;h=15144459edada7dd3a533843f9ed66e0d436865f;hb=1e6e5ac6b3cdcf4cdd8fa01cc2a0aab2c5a6be92;hp=ca386bd819d0a351b2acd8f9844eedaff3560f3b;hpb=81e51d7fdb7ee03b540a4bb82477b4da90a0a2eb;p=m_librarian.git

diff --git a/docs/command_line.rst b/docs/command_line.rst
index ca386bd..1514445 100644
--- a/docs/command_line.rst
+++ b/docs/command_line.rst
@@ -31,7 +31,7 @@ ml-search.py
 
 Usage::
 
-    ml-search.py [-i] [-I] [-t {exact,start,substring}] ...
+    ml-search.py [-i] [-I] [-t] [-s] [-f] [-d] ...
 
 Search through the database and display results. Currently can only
 search authors by name.
@@ -40,9 +40,12 @@ Global options::
 
     -i, --ignore-case     ignore case (default is to guess)
     -I, --case-sensitive  don't ignore case
-    -t, --search-type {exact,start,substring}
-        search type: exact match, substring at the start (this is the default),
-        substring anywhere.
+    -t, --start           search type: substring at the start
+                          (this is the default)
+    -s, --substring       search type: substring anywhere
+    -f, --full            search type: match the full string
+    -d, --details         Output more details about found objects;
+                          repeat for even more details
 
 Options ``-i/-I`` cannot be used together as they are the opposite. In
 case none of them are used the program guesses case-sensitivity by
@@ -50,15 +53,16 @@ looking at the arguments. If all arguments are lowercase the program
 performs case-insensitive search. If there are UPPERCASE or MixedCase
 arguments the program performs case-sensitive search.
 
-Option ``-t/--search-type`` defines the search type. Search types are:
+Options ``-t/-s/-f`` define the search type. Search types are:
 
-* exact - search for exact match; i.e. searching for "duck" returns
-  results for "duck" but not for "duckling";
 * start - search for substring at the start of the search field; for
   example searching for "duck" returns results for "duck" and "duckling"
   but not for "McDuck"; this is the default search type.
 * substring - search for any substring; "duck" => "duck", "duckling",
   "McDuck" (except for case-sensitive search, of course).
+* full - search for exact match, compare the entire strings;
+  i.e. searching for "duck" returns results for "duck" but not for
+  "duckling";
 
 
 Author search
@@ -66,9 +70,9 @@ Author search
 
 Usage::
 
-    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]
 
-Search and print a list of authors by surname/name/misc name.
+Search and print a list of authors by surname/name/misc name/full name.
 
 Options::
 
@@ -91,21 +95,56 @@ Example::
 Search and print a list of authors whose surname starts with "duck", and
 name starts with "mack", case insensitive.
 
+
+Book search
+^^^^^^^^^^^
+
+Usage::
+
+    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] [-e ext] [--gname name] [--gtitle title] [-l lang]
+
+Search and print a list of books by title, series, archive or file name.
+
+Options::
+
+    -t, --title title      Search by title
+    -s, --series series    Search by series
+    -a, --archive archive  Search by archive (zip file)
+    -f, --file file        Search by file name (without extension)
+    --surname surname      Search by author's surname
+    --name name            Search by author's name
+    --misc-name misc. name Search by author's misc. name
+    --fullname name        Search by author's full name
+    -e, --ext ext          Search by file extension
+    --gname name           Search by genre's name
+    --gtitle title         Search by genre's title
+    -l, --lang lang        Search by language
+
+By default the program prints only titles of the found book. With one
+option `-d` it also prints the list of authors and genres, and also
+series the book belongs to (if any) and the serial number of the book in
+the series. With two options `-d` (`-d -d` or simply `-dd`) it also
+prints the file date and language. With three `-d` it prints archive
+name, file name, extension and size, and flag if the book is marked to
+be deleted.
+
+
 Extension search
 ^^^^^^^^^^^^^^^^
 
 Usage::
 
-    ml-search.py [-i] [-I] [-t ...] ext name
+    ml-search.py [-i/-I] [-t/-s/-f] ext [name]
 
 Search and print a list of extensions by name.
 
+
 Genres search
 ^^^^^^^^^^^^^
 
 Usage::
 
-    ml-search.py [-i] [-I] [-t ...] genres [-n name] [-t title]
+    ml-search.py [-i/-I] [-t/-s/-f] genres [-n name] [-t title]
 
 Search and print a list of genres by name and title.
 
@@ -114,12 +153,13 @@ Options::
     -n, --name name    Search by name
     -t, --title title  Search by title
 
+
 Language search
 ^^^^^^^^^^^^^^^
 
 Usage::
 
-    ml-search.py [-i] [-I] [-t ...] lang name
+    ml-search.py [-i/-I] [-t/-s/-f] lang [name]
 
 Search and print a list of languages by name.