X-Git-Url: https://git.phdru.name/?a=blobdiff_plain;f=docs%2Fcommand_line.rst;h=bb3b8a264f29b79db881bc87b9b004178aced579;hb=0e748b3079d865e98729d4bff04552518cf461b9;hp=8f0e4560817a27513f2448cc39828fceea93174e;hpb=c0abd0bc5145476ee9cae50a5db7dea818b8da5c;p=m_librarian.git

diff --git a/docs/command_line.rst b/docs/command_line.rst
index 8f0e456..bb3b8a2 100644
--- a/docs/command_line.rst
+++ b/docs/command_line.rst
@@ -25,4 +25,79 @@ 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
 reimport genres; it also skips already import books but import new ones.
 
+
+ml-search.py
+------------
+
+Usage::
+
+    ml-search.py [-i] [-I] [-t {exact,start,substring}] ...
+
+Search through the database and display results. Currently can only
+search authors by name.
+
+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.
+
+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
+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:
+
+* 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).
+
+
+Author search
+^^^^^^^^^^^^^
+
+Usage::
+
+    ml-search.py [-i] [-I] [-t ...] author [-s surname] [-n name] [-m misc-name]
+
+Search and print a list of authors by surname/name/misc name.
+
+Options::
+
+    -s, --surname surname       Search by surname
+    -n, --name name             Search by name
+    -m, --misc-name misc. name  Search by misc. name
+
+Example::
+
+    ml-search.py -i author -s duck
+
+Search and print a list of authors whose surname starts with "duck",
+case insensitive.
+
+If a few options are given the search is limited with operator AND.
+Example::
+
+    ml-search.py -i author -s duck -n mack
+
+Search and print a list of authors whose surname starts with "duck", and
+name starts with "mack", case insensitive.
+
+Extension search
+^^^^^^^^^^^^^^^^
+
+Usage::
+
+    ml-search.py [-i] [-I] [-t ...] ext name
+
+Search and print a list of extensions by name.
+
 .. vim: set tw=72 :